Wiki Admin

dsshubserver - DSS 6 | Data Source Solutions Documentation

Export as HTML Export as PDF Export as DOCX
Edit

Documentation: dsshubserver - DSS 6 | Data Source Solutions Documentation

dsshubserver

Usage

  • <b>dsshubserver</b> [-<b>d</b>|-<b>k</b>] Linux daemon
  • <b>dsshubserver</b> -<b>a</b>[<b>cshd</b>] [-<b>p</b><em>pwd</em>] Windows service
  • <b>dsshubserver</b> -<b>i</b> Interactive

Description

Command dsshubserver allows you to start and stop the DSS Hub Server. On Linux, if this command is executed without supplying any of the options, it will start a hub server.

  • On Windows, the hub server is a Windows Service which is administered with option <b>-a</b>. The account under which it is installed must be a member of the administrator group and must be granted the privilege to act as part of the operating system (SeTcbPrivilege). The service can either run as the default system account or (if option <b>-P</b> is used) it can run under the DSS account which created the Windows Service.
  • On Linux, the hub server runs as a daemon which can be started with option <b>-d</b> and killed with option <b>-k</b>.

  • For hub server on Linux, it is more common to start DSS executables using the system process (systemd). For more information, see section Configuring Restarting of Hub Server after System Reboot.

  • When the hub server is executed as a Windows Service, the errors are written to the Windows Event Log (Control Panel ▶ Adminitrative Tools ▶ Event Viewer ▶ Windows Logs ▶ Application).

Options

This section describes the options available for command dsshubserver.

Parameter Description
-ax
Windows

Administration operations for the hub server service on Windows.

Values of x can be:

  • c: Create (register) the service.
  • s: Start the service
  • h: Stop (halt) the service
  • d: Destroy (unregister) the service

Several -ax operations can be supplied together; allowed combinations are:

  • acs: Create and start the service
  • ahd: Halt and destroy the service

The hub server service can also be started and halted using Windows Services console (accessible from Control Panel ▶ Administrative Tools ▶ Computer Management ▶ Services and Applications ▶ Services). The shortcut command to access this console is services.msc.
-d
Linux
Start the hub server as a daemon process.

-Ename=value

 Set environment variable name to value for this process and its children.

-i

 Interactive invocation. The hub server stays attached to the terminal, which means the process is started as a child process of the current process (instead of a daemon process, which is started by default).
-k
Linux
Stop a running the hub server daemon process.
-Ppwd
Windows

Configure the server service to run under the current login DSS account using password pwd, instead of under the default system login account. This option may only be supplied with option -ac.

Empty passwords are not allowed. The password is kept (hidden) within the Microsoft Windows operating system and must be re-entered if passwords change.

Examples

This section provides an example of using the dsshubserver command.

Example 1. Run hub server interactively

Command to run the hub server interactively in the terminal.

dsshubserver -i

In this method, exiting the shell/terminal will terminate the hub server.

Example 2. Run hub server as daemon process in Linux

Command to run the hub server as daemon process in Linux.

dsshubserver -d
Example 3. Stop/kill hub server running as daemon process in Linux

Command to stop/kill the hub server that is running as daemon process.

dsshubserver -k
Example 4. Create and start hub server as a Windows service

Command to create and run/start the hub server as a Windows service.

dsshubserver -acs
Example 5. Stop and destroy hub server service in Windows

Command to halt and destroy the hub server that is running as a Windows service.

dsshubserver -ahd