In some rare occasions it may occur that not all tasks normally performed at the first startup of the Administration Tool can be finished successfully. In this case, a message will report success or failure for each step, and it is necessary to perform failed steps manually.
A complete list of these steps can be found in the following.
1. Register UaGateway as a Service
Execute the following command from a command prompt with administrator rights.
<InstallDir>/bin/uagateway.exe /service
2. Replace “[NodeName]” With Local Hostname in “uagateway.config.xml”
3. Configure Autostart for UaGateway Systray Config Tool
Windows NT/2000/XP/2003
- Run regedit.exe
- Navigate to “HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run”
- Right click on “Run” and select “New/String Value”
- Enter “UaGateway Systray Config Tool” as the name and “<InstallDir>\bin\systrayconfig.exe” as the value
Windows Vista/7
- Run taskschd.msc
- Right click on “Task Scheduler Library” and select “Create Task”
- Enter “UaGatewaySystrayConfig” as name
- Select “Change User of Group...” and select the group “Users”
- Select “Run with highest privileges”
- Switch to the tab “Triggers”, select “New...”, select “At log on” for “Begin the task” and select “OK”
- Switch to the tab “Actions”, select “New...”, enter “"<InstallDir>\bin\systrayconfig.exe"” as the value and select “OK”
- Switch to the tab “Conditions” and make sure that all checkboxes are unchecked
- Switch to the tab “Settings” and make sure that “Stop the task if it runs longer than:” is unchecked
4. Add Local User Group “UaGatewayUsers”
- Run lusrmgr.msc
- Right click on “Groups”, select “New Group...” and enter “UaGatewayUsers” as the group name
5. Add Group “UaGatewayUsers” to UaGateway DCOM Permissions
- Run dcomcnfg.exe
- Navigate to “Component Services/Computers/My Computer/DCOM Config/UaGateway COM Server”
- Right click on “UaGateway COM Server” and select “Properties”
- In the tab “Security”, select “Customize” of “Access Permissions”
- Select “Edit...”, add the group “UaGatewayUsers” to the permissions and give it full local and remote permissions
- In the tab “Security”, select “Customize” of “Launch and Activation Permissions”
- Select “Edit...”, add the group “UaGatewayUsers” to the permissions and give it full local and remote permissions
6. Add Group “UaGatewayUsers” to Global DCOM Limits
- Run dcomcnfg.exe
- Navigate to “Component Services/Computers/My Computer”
- Right click on “My Computer” and select “Properties”
- In the tab “COM Security”, select “Edit Limits...” of “Access Permissions”
- Add the group “UaGatewayUsers” to the limits and give it full local and remote permissions
- In the tab “COM Security”, select “Edit Limits...” of “Launch and Activation Permissions”
- Add the group “UaGatewayUsers” to the limits and give it full local and remote permissions
7. Modify Access Rights of UaGateway Uninstall Registry Key and Create VersionId Value
- Run regedit.exe
- 32 bit OS: Navigate to “HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\UaGateway”
64 bit OS: Navigate to “HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\UaGateway”
- Right click on “UaGateway” and select “Permissions”
- Add the group “Everyone” to the permissions and give it “Full Control”
- Right click on “UaGateway” and select “New/DWORD (32-bit) Value”
- Enter “VersionId” as the name and “0” as the value
8. Add Windows Event Log Information to the Registry
- Run regedit.exe
- Navigate to “HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\services\eventlog\Application”
- Right click on “Application” and select “New/Key”
- Enter “UaGateway” as the name
- Right click on the created key “UaGateway” and select “New/DWORD (32-bit) Value”
- Enter “CategoryCount” as the name and “3” as the value
- Right click on the created key “UaGateway” and select “New/DWORD (32-bit) Value”
- Enter “TypesSupported” as the name and “7” as the value
- Right click on the created key “UaGateway” and select “New/String Value”
- Enter “CategoryMessageFile” as the name and “<InstallDir>\bin\uagateway.exe” as the value
- Right click on the created key “UaGateway” and select “New/String Value”
- Enter “EventMessageFile” as the name and “<InstallDir>\bin\uagateway.exe” as the value
- Right click on the created key “UaGateway” and select “New/String Value”
- Enter “ParameterMessageFile” as the name and “<InstallDir>\bin\uagateway.exe” as the value
9. Set the User Context in Which the Service Will Run
- Run services.msc
- Right click on “UaGateway COM Server” and select “Properties”
- In the tab “Log On”, select “This account:” and enter the credentials of the account the service should run on
- Run lusrmgr.msc
- Navigate to “Groups”, right click on “UaGatewayUsers” and select “Properties”
- Add the user account the service runs on to the group
- Run gpedit.msc
- Navigate to “Computer Configuration/Windows Settings/Security Settings/Local Policies/User Rights Assignment”
- Right click on “Log on as a service” and select “Properties”
- Add the user account the service runs on by clicking on “Add User or Group...”
- Open Windows explorer and navigate to “<InstallDir>\bin”
- Right click on “uagateway.config.xml”, select “Properties”, select “Advanced” and select “Change Permissions...”
- Uncheck “Include inheritable permissions from this object’s parent”
- Select “Remove”
- Select “Add...” and add the user account the service runs on and the group “Administrators” with “Full control”
