AdminService Configuration
This section explains how to create a custom AdminService configuration and how to configure the rhadmin
script used to control the AdminService.
Creating a Custom AdminService Configuration
To create a new AdminService configuration file, enter the following commands.
cd /etc/redhawk
rhadmin config admin > adminserviced.cfg
vi adminserviced.cfg
The configuration files are located in a system privileged directory. Ensure that you have proper privileges to create and edit files in those directories.
To start the AdminService as a local user, enter the following command.
adminserviced
To start the AdminService as a system service on CentOS 6, enter the following commands.
/sbin/service redhawk-adminservice start
To start the AdminService as a system service on CentOS 7, enter the following commands.
systemctl start redhawk-adminservice.service
The following table describes the sections of the AdminService configuration file.
AdminService Configuration File Sections
Section | Description |
---|---|
[unix_http_server ] |
Defines the Unix socket interface to the AdminService. |
[rhadmin ] |
Specifies settings for running the rhadmin client. |
unix_http_server
The unix_http_server
section of the AdminService configuration file defines the local socket that the rhadmin
can use for remote control of the AdminService.
Configuration Parameters
This section describes the unix_http_server
configuration parameters.
parameter: file
required: No
default value: /var/run/redhawk/adminserviced.sock
description: The absolute path to a Unix domain socket used to listen for remote commands.
parameter: username
required: No
default value: redhawk
description: The username for remote control of the AdminServer.
parameter: password
required: No
default value: redhawk
format: Cleartext password or may be specified as a SHA-1 hash if prefixed by the string {SHA}
. For example, {SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d
is the SHA-stored version of the password thepassword
.
description: The password for remote control of the AdminServer.
rhadmin
The rhadmin
control script can be configured in the main AdminService configuration file.
Configuration Parameters
This section describes the rhadmin
configuration parameters.
parameter: serverurl
required: No
default value: unix:///var/run/redhawk/adminserviced.sock
format: unix:///path/to/file.sock
description: The path to the Unix domain socket used by the AdminServer.
parameter: username
required: No
default value: redhawk
description: The username to use when connecting to the AdminServer.
parameter: password
required: No
default value: redhawk
format: Clear text
description: The password to use when connecting to the AdminServer.