Install a Uniface Router on Windows

On Microsoft Windows, the Uniface Router is automatically installed as a service. You can install additional Uniface Routers as separate services.

You can use the /inst switch to install multiple Uniface Routers as separate services, each one registered with a unique service name.

Note: When installing and starting the Urouter service or executing urouter commands, you must run with Administrator privileges. When you start the Windows Command Prompt, choose Run as Administrator from the context menu.

From the command line, run the Uniface Router executable with the/inst option. For example, to install a Uniface Router on a TLS connection:
```
urouter /inst="Uniface URouter2" tls:+13007
```
Note: If you do not specify parameters for the /inst command line switch, the Uniface Router is installed and registered as a single service named, for example, Uniface 103 URouter. For TCP and TLS, the default port is 13001 (or the port number assigned in the urouter.asn file, in the $DEFAULT_NET setting).
Uniface defines the Uniface Router as a service in the Service Control Manager and defines a registry key.
Use the /show switch to verify that the registry key was correctly created during installation of the service.
```
urouter /show="Uniface URouter2"
```
Start the new urouter service.
Do one of the following:
- In the Windows Services control panel, find the installed URouter service in the service list, and click Start.
  If you specify parameters in the Startup Parameters field before you start the installed URouter service, these parameters take precedence over the ones specified at the time of installing the URouter service.
- From the command line, use the Windows net start command.
  For example:
```
C:\Windows\system32\net.exe start "Uniface URouter2"
```
If there are problems, use the /rem switch to remove the definition and the registry key and return to a clean and consistent situation.
```
urouter /rem="Uniface URouter2"
```

Success or error messages for the /inst, /show or /rem switches are displayed directly on the command line.

If errors occur and the service cannot be started, the errors are reported in a log file called urouterProcessId.log. This log file is located in the \bin directory where the urouter executable is located. (The normal Uniface Router log file, which is defined in $putmess_logfile, is not yet available when the service is started.) However, if you have defined the service to run under a specific user account, it may be located elsewhere.

If a log file cannot be created, Uniface tries to create it in the parent of the \bin directory. If the directories are read-only, no log file will be created.

By default, the urouter service is installed with restart options, so several log files may be created when the urouter service fails on each re-start. For more information, see Configure Uniface Router Recovery.

Starting Multiple Uniface Routers on the Same Machine

You can install multiple Uniface Routers on the same machine, as long as each one listens on different ports. Each such Uniface Router maintains its own group of servers, and must have its own assignment file and list of ports to listen to. For example:

urouter.exe /inst="URouter13002" /asn=c:\urouter13002.asn tcp:+13002
urouter.exe /inst="URouterFringe13003" /asn=c:\urouter13003.asn tls:+13003