Ascend Interface Service Installation

Transcription

1 Ascend Interface Service Installation 1. If this is a new installation, make sure IIS is installed and running on your machine first, and make sure ASP is enabled under Extensions in IIS. 2. If you are doing a new installation on Windows Server 2008, please see the appendix on p. 8, Preparation for installing the Ascend Interface Service Engine on Windows 2008 Server. 3. If you had a previous version of the Ascend Interface Engine Service installed, uninstall the previous version. 4. Download the install package (self-extracting.zip file) from the Customer Service -> Support menu option from 1 P a g e

2 5. After downloading the Update.exe file, browse to the directory it was downloaded. a. If you are installing on Windows Server 2008, right-click on the file and choose Run as Administrator b. If you are installing on any other Windows version, double-click the file to bring up the WinZip Self-Extractor window. 2 P a g e

3 c. Click Next on each of the 3 wizard screens that appear when you begin the install: 3 P a g e

4 d. If you are installing the interface service on any operating system newer than Windows XP, you may be prompted to enter credentials for a valid Windows administrator account in order to utilize the Web Portal configuration screens to change the interface service application settings. If the account is a domain account, include the domain, e.g. domain\user. Please don t confuse this account with the SQL Server account in the next step. 4 P a g e

5 e. On the following Configuration Settings screen, make sure the connection information is correct in the SQL Server Connection Properties section. You can select the Copy Ascend- HI.INI radio button if you know your connection to the SQL Server database is correct from Ascend and the Interface Service will use that information to connect to the Ascend database. Otherwise, enter the server name, login method and user credentials you want the Interface Service to use to connect to the SQL Server Database and click Save when finished. Please don t confuse this account with the Windows account in the previous step. PLEASE NOTE, currently the interface is not able to use Windows Authentication to access the SQL Server database, it must use SQL Server Authentication. 5 P a g e

6 f. Click the Close button: g. Make sure the service is running by opening the Start -> Control Panel -> Administrative Tools -> Services panel and locating Ascend Interface Engine Service. The service status should say Started : h. If you are installing version 7.2 or greater on Windows Server 2008 or Windows 7, you must re-install SQL Server Compact manually. 6 P a g e

7 a. Open Control Panel, Programs and Features. b. Un-install any program with a name that begins with Microsoft SQL Server Compact 3.5 c. Download the installer from Microsoft for SQL Server Compact SP2. The current download link is below: d. Run the installer. It will unpack two files. e. On 32-bit systems, install only the x86 version. f. On 64-bit systems, install BOTH versions. 7 P a g e

8 Appendix: Preparation for installing the Ascend Interface Service Engine on Windows 2008 server The first item that needs to be completed in preparation for the Ascend Interface Service Engine is to install IIS and configure it to run ASP.net web applications, which is an essential step to being able to use the Ascend Interface Service web portal to create/configure the interface(s). Make sure that you are logged in as an Administrator on the machine and complete the following steps: 1. Make sure IIS is installed and running Click Start -> then right-click Computer -> click Manage in the menu that comes up 2. In the Server Manager window, click on the Roles node in the tree-view in the left-hand pane: 8 P a g e

9 3. In the Roles Summary section in the main window, click Add Roles on the right and the Add Roles Wizard will open. 4. You should see the Before You Begin screen, click Next 5. In the check box list in the next screen, Select Server Roles, check the Web Server (IIS) item and you will probably be prompted in a new window to Add role services required for Web Server?. Click Add Required Role Services. After that finishes, click next. 9 P a g e

10 6. Then click Next again and in the next checklist that comes up under Application Development, select the ASP.NET checkbox and you will be prompted to add role services required for ASP.Net?. Click the Add Required Role Services button. 10 P a g e

11 7. After that finishes, scroll down the roll services checklist to the Management Tools section and select the IIS 6 Management Compatibility checkbox and click Next: 8. Click the Install button and wait for installation to complete. The server may need to restart during the installation process 9. At this point, IIS is configured and running on the server but needs to have some security lowered to allow the web portal to work properly. Click Start -> Computer to open a Windows Explorer window, and browse to the C:\Windows\System32\inetsrv\config directory. Right-click the file named applicationhost.config and click properties. In the Security tab, make sure the user you are logged in as has full control permissions to edit this file. If not, click edit and click the Full control checkbox. 11 P a g e

12 10. Open the file in Notepad. Scroll down the file until you find the following line: <section name="handlers" overridemodedefault="deny" /> Change it from Deny to Allow : <section name="handlers" overridemodedefault="allow" /> 11. Do the same thing for this line: <section name="modules" allowdefinition="machinetoapplication" overridemodedefault="deny" /> Change to: <section name="modules" allowdefinition="machinetoapplication" overridemodedefault="allow" /> 12. Save the file You must complete the following step if the Server is running on a 64-bit operating system. If the server is running in a 32-bit environment, this step can be skipped: 12 P a g e

13 13. Click Start -> Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager and the IIS management window will open. In the left pane, expand the first node and select the Application Pools item: 14. In the main window, right-click the DefaultAppPool item and click Advanced Settings. In the Advanced Settings window, make sure the Enable 32-Bit Applications item is set to True and click OK: 15. Close the IIS window. 16. You are now ready for Step 3 on page P a g e

14 Troubleshooting: If you encounter the following error when installing: Re-run the installer using the following command line: msiexec /i ascend_interface_engine.msi /L*v logfile.txt This may produce the error below, but should correctly install the interface service in spite of this error. 14 P a g e