hvrhubserver

Usage

hvrhubserver [-d|-k] Linux daemon
hvrhubserver -a[cshd] [-ppwd] Windows service
hvrhubserver -i Interactive

Description

Command hvrhubserver allows you to start and stop the HVR 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 -a. 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 -P is used) it can run under the HVR account which created the Windows Service.
On Linux, the hub server runs as a daemon which can be started with option -d and killed with option -k.

For hub server on Linux, it is more common to start HVR 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 hvrhubserver.

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 HVR 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 hvrhubserver command.

Example 1. Run hub server interactively

Command to run the hub server interactively in the terminal.

hvrhubserver -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.

hvrhubserver -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.

hvrhubserver -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.

hvrhubserver -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.

hvrhubserver -ahd