To install the Runtime Administration on your system
Run the Data Exchange Setup using the Run as administrator option.
The Unisys Data Exchange <version_number>- Setup Wizard appears.
Click Install Windows component.
The Data Exchange Management Studio (DEMS) Connection Settings page appears.
Provide the following details:
DEMS Host: The host name of the machine where you have installed DEMS. If you have used a non-default port, then enter the host name in the format Hostname:Port.
Environment: The environment in which you want to install this component.
Click Next.
Click the Runtime Administration icon.
The Unisys Data Exchange Runtime Administration Setup page appears.
Click Next.
In the SQL Server Instance information page
Type the name of the SQL Server instance in the SQL Server box.
The Administrative Service connects to this server and creates the Admin DB named UnisysDExchAdminDB<version number>, which stores the runtime configuration settings and the transformations that you deploy on the Administrative Service.
Notes:
If you connect to a remote SQL instance, the application user account may not be created successfully, as the application user account can be created only in the local machine and it will not be able to connect to the remote SQL instance.
Do not perform any operation on this database other than backing it up.
Do not rename or move this database at any point in time, as it may result in creation of duplicate data in the transformation targets.
Select one of the following authentication methods for the Administrative Service to connect to the SQL database:
Windows Authentication: To connect to the SQL database using your Windows credentials.
Note: Since the Administrative Service is running under the system account "NT AUTHORITY\SYSTEM" in the SQL Server, ensure that "NT AUTHORITY\SYSTEM" is assigned with the “sysadmin” role.
SQL Authentication: To connect to the SQL database using the credentials that you received from your SQL Server administrator. In this case, you must provide your credentials in the relevant fields.
Note: To choose "SQL Authentication", you must have the SQL credentials specific for Data Exchange created in the SQL Server. The user name must have the “sysadmin” role in the SQL Server.
WarningWhile creating the credentials using the SQL Server Management Studio, clear the Enforce password expiration check box in the Login-New window, because once the password expires in the SQL Server, the Runtime Service cannot connect to the SQL Server. You do not have any option of using the new password in the Administrative Service unless you reinstall it.
Select Secure Connection if you want to enable secure connection to the Admin DB.
Notes:
You must have installed and configured SSL certificate to use secure connection. Refer to Appendix B, Installing and Configuring SSL Certificate.
You must provide full host name in the SQL Server instance box above.
Click Test Connection to ensure that a connection is established between the Administrative Service and your SQL Server instance.
A green tick mark appears indicating success.
Note: You cannot proceed unless a connection is established.
Click Next.
If you are installing another (higher) version of the Runtime Administration, and a administration database of a lower version exists, then the Administration Database Information page appears. Select one of the following options:
Initialized data: Select this to create a new administration database with initialized data.
Data migrated from the Admin DB of: Select this to create a new database and then copy data from the selected database.
Note: If a transformation is in progress, you must first stop it, and then stop the Administrative Service before migrating the data into a new database.
Click Next.
The Application User Credentials page appears. Select one of the following options:
Create a New Application User Account
Note: The user account you create must be new. If you create an account with the same name as a previously existing account, the installation can fail. This is because the old account might still be in use by a system resource. If you need to use the same name, you must restart the machine and reinstall Runtime Administration.
Select an Application User from Existing Accounts
Note: After the installation completes, if the browser prompts to enter the login credentials to access the Administration Site, enter the current login user account or other authorized account which can also log in to your machine. You cannot use the Application User account that you created or selected because it does not have the privilege to log in to the computer.
Use System Account as Application User Account
If you create the application user account, then the Administrative Service runs under this account, thereby enhancing security. Note that if you create it on the local machine, Administrative Service will not be able to connect to a remote SQL instance.
If you select any of the first two options, then you must enter the appropriate information in the page that appears subsequently. If you select the third option, you can install the Runtime Administration with the default “Local System” account.
Note: If you are using Windows Authentication, the application user account is automatically provided the privilege to read and write the Admin DB.
Click Next.
The Set TCP Port page appears, displaying the default port number (9300) through which other Data Exchange components establish a connection with the Administrative Service.
Note: Do not change the default port number if it is available. If you change the port number, you need to manually set the port number for other components to connect to the Administrative Service.
Click Next.
The Administration Site Security Settings page appears.
Select the protocol that you want to use for network communication.
If you select the HTTPS protocol, you must install the SSL certificate on the IIS Server. For more information about installing the SSL certificate, refer to Appendix C, Enabling HTTPS for Administration Site and DEMS.
Click Next.
The Destination Folder page appears, displaying the default location where the Administrative Service will be installed.
Click Next.
The Ready to install Unisys Data Exchange Runtime Administration page appears.
Click Install.
The Installing Unisys Data Exchange Runtime Administration page appears, displaying the progress of the installation.
Click Finish to finish the installation.
Start the Administrative Service that you stopped in step 5.
At any point during the installation, you can cancel the installation by clicking Cancel. You can go back to the previous screen by clicking Back on all the screens except the installation screen.
After Runtime Administration is installed
A configuration file (Data Exchange Admin Service <version_number>.exe.config) is created in its installation directory, which contains initial settings for Administrative Service properties, port numbers, performance counter properties, and common security properties. It also includes the host name where DEMS is installed and the environment in which you have installed the component.
Note: Unless otherwise mentioned in the documents, do not modify the value of the property in the configuration file without consulting with the Unisys Support team.
Unisys Data Exchange node is created in the Event Viewer > Applications and Services Logs. For every event displayed in the Administration Site, a corresponding System Event, with the same information, is created in this node. This enables you to create your own program to monitor the System Event log to check the status of Data Exchange.
Accessing the Administration Site
After installing the Runtime Administration, you can access the Administration Site either from your local machine or from a remote machine.
Use the following link to access from a
Local Machine: http://localhost/DataExchangeAdminSite<version number> or https://localhost/DataExchangeAdminSite<version number>, depending on the protocol you have chosen.
Remote Machine: http://<Admin Partition IP>/DataExchangeAdminSite<version number> or https://<Admin Partition IP>/DataExchangeAdminSite<version number>, depending on the protocol you have chosen.
<Admin Partition IP> is the IP address of the Runtime Administration partition.
Alternatively, on your local machine, you can access the Administration Site from the Start menu. Click Start > All Programs> Unisys Data Exchange <version number> Unisys Data Exchange Runtime Administration.
Note: To view all the elements of the Administration Site clearly, the screen resolution must be 1280 X 800 and above.