Installation Process

For security reasons, Isah recommends that you acquire a certificate for your website to encrypt your transactions.

1. Start Electronic.Returns.Service.Setup.msi to install the Isah Electronic Returns Service.
2. If you already have an installation of the Isah Isah Electronic Returns Service, it is possible to add another instance (or more), for example for test purposes. In the first window, specify if you want to install a new instance or upgrade an existing instance.

   Note: You can only use letters, numbers, spaces and underscores when you specify an instance name.

3. Follow instructions and press Next when necessary.
4. After accepting the terms in the License Agreement, the installation will ask you to select an account to run the Windows service. The service can run in the security context of the LocalSystem account, a local user account, or a Managed Service Account. You can grant the service account rights and permissions for your environment that meet your security requirements. The LocalSystem account option is easy to use.
   In case you want to use a specific account or a Managed Service Account, execute the following steps before runninig the wizard:
   1. Press Windows+R and run secpol.msc. Go to Local Policies, User Rights Management, choose Log on as a service and add the account in order to be able to log in as service. This step is necessary to start the service and to complete the wizard.
   2. Press Windows+R and run lusrmgr.msc. Go to Groups, Administrators. Add the account and assign administration rights to the account. This step is necessary to start the service and to complete the wizard.

   When you run the wizard and select This account, you have to enter the user and password. You can use the Verify credentials button to check the user and password you specified. There will be no check of rights. If you choose a Managed Service Account, enter an account ([Domain]\[Account]$, for example, ISAH\IsahService$) and use the Verify account button to check whether the specified account exists.

5. In the SQL Instance Information window, enter the database connection details. If you don't use the trusted Windows connection, you will need to verify the connection to the database before you can proceed.

   SQL instance

   Enter your SQL server name and instance name. If you want the installation to show you which instances are available, click Load SQL Instances and select the correct instance from the drop-down list.

   Note: The drop-down might not display all available SQL Server instances.

   Trusted (Windows Authentication) / Specify user name and password

   Trusted (Windows Authentication)

   If you want to use the Windows Authentication, click Trusted. The installer will use the account you entered for the Windows Service; this user needs to have the IsahElectronicReturnsRole on the database you will use. Assign it to your Windows Service user if necessary. Please note:

   • If your trusted user is the LocalSystem and the Isah Electronic Returns Service is being installed on the database server (which is not recommended), you need to assign permissions to user NT AUTHORITY\SYSTEM.
   • If your trusted user is the LocalSystem and the Isah Electronic Returns Service is being installed on another server, user {DOMAINNAME\COMPUTERNAME$} - for instance {ISAH\C0258$} - needs permissions for the database.

   You will not need to enter a login and password and can proceed with Next.

   Specify username and password

   If you want to specify another user name, click Specify username and password:

   • Login: This must be a user with IsahElectronicReturnsRole in the Isah database. Use SQL Server Management Studio to assign this role to the SQL Server user in the Isah database. Isah recommends a user name with IsahElectronicReturnsRole permissions only. These are the only permissions required to run the Isah Electronic Returns Service.

     Isah does not recommend the use of SQL user 'sa'.

   Please note: Specify a unique user for every Isah Web Service you require. For instance, if you run both Isah Electronic Returns Service and Isah Shop Floor Control, the users with the relevant ServiceRole for each of these two apps cannot be the same user.

   • Verify connection: ensure the connection works properly by pressing this button. After the connection has been verified, the Next button becomes active.

   Test environment: Both this field and the Test environment field in Isah Finance Services need to be activated in order to test electronic returns in a test environment.

6. In the Database window, enter the database name and verify the connection if necessary (you will not need to verify the connection if you have chosen Windows authentication in the previous window). If the user you entered in the previous window does not have sufficient permission, a message to that effect will appear. In that case, to avoid installation problems, it is better to go back and enter a user name with IsahElectronicReturnsRole in the Isah database.
7. In the IIS Website Name and Port window, enter a name for the website and the port it will use.
8. Enter the Isah license server host and port.
9. Enter the path for the installation.
10. Press Install.