Use the di-service.exe utility to manage DiveLine instances that are running on your Windows server. By default, the executable is located in \di\solution\<diveline>\bin. On Windows, run the utility from a cmd.exe window.
NOTE: The di-service utility is not available on Linux servers.
There are four di-service.exe commands to manage the DiveLine service instances on your server.
Install command
The Install command installs an instance of the DiveLine service. The syntax is:
di-service.exe -install <servicename> -p <port#> -dataroot <directory>
-u <username> <password> -display <displayname> -desc <description>
[-ipv6 | -noipv6] [-cluster | -nocluster] -node <clusternode>
where:
- servicename is the name of the DiveLine service
- port# is the port that DiveLine service runs on
- directory is the path to the DiveLine dataroot directory
- username password are the username and password for the user that the DiveLine service runs as
- displayname is the name that displays in the Windows Services control panel
- description is the descriptive text that displays in the Windows Services control panel
- clusternode is the name of the cluster node when clustering is enabled
The mutually exclusive options -ipv6, -noipv6 turn support on or off for Internet Protocol version 6.
The mutually exclusive options -cluster, -nocluster turn support on or off for clustering so that the DiveLine services can share a dataroot.
Edit command
The Edit command edits an installed service’s parameters. The syntax is:
di-service.exe -edit <servicename> -p <port#> -dataroot <directory>
-u <username> <password> -display <displayname> -desc <description>
[-ipv6 | -noipv6] [-cluster | -nocluster] -node <clusternode>
where:
- servicename is the new name of the DiveLine service
- port# is the new port that DiveLine service runs on
- directory is the new path to the DiveLine dataroot directory
- username password are the new username and password for the user that the DiveLine service runs as
- displayname is the new name that displays in the Windows Services control panel
- description is the new descriptive text that displays in the Windows Services control panel
- clusternode is the name of the cluster node when clustering is enabled
The displayname and description are displayed in the Windows Services control panel, as well as in the di-service -list output. Unique DiveLine service names are useful when multiple DiveLine services are installed. Values are set using the DiveLine installer or via di-service.
The Edit command supports toggling settings for Internet Protocol version 6 (IPV6) support and for clustering, which allows multiple DiveLine services to share a dataroot.
di-service.exe -edit <servicename> [-ipv6 | -noipv6] [-cluster | -nocluster]
- -ipv6 or -noipv6 indicates the new state for IPv6 support
- -cluster or -nocluster indicates the new state of clustering
NOTE: For more information about running DiveLine services in clustered mode, see the
Remove command
The Remove command removes an instance of the DiveLine service. The syntax is:
di-service.exe -remove <servicename>
where servicename is the name of the DiveLine service to remove. The default service name is DI-DiveLine.
This command only removes the named DiveLine service. All DiveLine configuration files remain on your system.
List command
The List command returns information for the specified instance, or for all instances of a DiveLine service on a particular server. The syntax is:
di-service.exe -list <servicename>
where servicename is the name of the DiveLine service to list. For example:
di-service.exe -list di-diveline-7100
returns:
Service: DI-DiveLine-7100
Status: Running
Display name: DiveLine version 7.1 for docs
Description: Diver Platform 7.1 DiveLine
Start-up: Automatic, on system boot.
Executable: C:\DI\Solution71\diveline\bin\di-service.exe
Service runs as user: .\divelineuser71
Dataroot: C:\DI_Solution71\dl-dataroot
Port: 7100
IPv6 support is enabled.
di-service.exe -list
where no servicename is specified, returns information for all installed DiveLine service instances.