5.2.4 acuserve -install

"acuserve -install" is for Windows NT and Windows 2000 servers only. It installs AcuServer as a Windows NT/2000 service. Optional arguments to "-install" include:

Option Description
server Specifies the name of the server machine. If no server is specified, the server is assumed to be the local host.
-depends Specifies the name of a service or service group on which acuserve depends. This option may be repeated multiple times. The effect of the "-depends" option(s) is to establish a dependency in which acuserve will not start unless each service named after a "-depends" is currently installed on the server as a service. "-depends" must be followed by a space and the name of a Windows service or service group. If the name is a service group, it must be prepended with a "+" character (e.g., "-depends +Alerter"). The "-depends" option and service name must come after the server option and before any "-start" options.

If AcuServer is already installed as a service and you want to add or change dependencies, you must remove the acuserve service and re-install it with the new "-depends" options.
any valid start options Any valid "-start" option can be used for "-install". (Refer to "-start" below for a list of options.) Note that these options are stored for service start-up on this particular port. For example, to run the service with the arguments "-c c:\etc\server1.cfg -le c:\tmp\server1.log" on start-up, you would use the following "-install" command:

acuserve -install -c c:\etc\server1.cfg -le c:\tmp\server1.log

Installing a service on a particular port resets all start-up options for the service on that port.

If there are no options stored for a service, then starting the server on a particular port automatically installs a service on that port and stores the options used. In other words, you can install and run a service with one set of arguments and then occasionally run the service with different arguments by using "acuserve -start".

If you plan to have multiple instances of the acuserve service running at the same time, each instance must have a unique name. The name of an installed service will be AcuserveX, where X is the number you specified with this option. If you do not use the "-n" option, then the name of the service will be Acuserve.

Client applications can, in turn, be assigned to a particular instance of the acuserve service via the ACUSERVER_PORT variable in the runtime configuration file. This can help to balance the client load and improve performance.

Option	Description
server	Specifies the name of the server machine. If no server is specified, the server is assumed to be the local host.
-depends	Specifies the name of a service or service group on which acuserve depends. This option may be repeated multiple times. The effect of the "-depends" option(s) is to establish a dependency in which acuserve will not start unless each service named after a "-depends" is currently installed on the server as a service. "-depends" must be followed by a space and the name of a Windows service or service group. If the name is a service group, it must be prepended with a "+" character (e.g., "-depends +Alerter"). The "-depends" option and service name must come after the server option and before any "-start" options. If AcuServer is already installed as a service and you want to add or change dependencies, you must remove the acuserve service and re-install it with the new "-depends" options.
any valid start options	Any valid "-start" option can be used for "-install". (Refer to "-start" below for a list of options.) Note that these options are stored for service start-up on this particular port. For example, to run the service with the arguments "-c c:\etc\server1.cfg -le c:\tmp\server1.log" on start-up, you would use the following "-install" command: `acuserve -install -c c:\etc\server1.cfg -le c:\tmp\server1.log` Installing a service on a particular port resets all start-up options for the service on that port. If there are no options stored for a service, then starting the server on a particular port automatically installs a service on that port and stores the options used. In other words, you can install and run a service with one set of arguments and then occasionally run the service with different arguments by using "acuserve -start".