Services

The Services screen features a side panel for quick navigation between services.

Introduction

The following services may be configured on the appliance:

Data

Directory

System

Remote Access

BUI

The BUI services page lists the services in the above groups, along with state information and buttons for administration. Double clicking a service line will take you to the service screen. The buttons are:

icon description Go to service screen to configure properties and view logs. Appears on mouse-over Service is enabled and working normally Service is offline or disabled Service has a problem and requires operator attention Enable/disable service Restart service Enable/disable not available for this service Restart currently unavailable (enable the service first)

See the Basic Usage section of the User Interface guide for the full reference of these icons.

Selecting a Service

To go to a service screen, click the status icon on the left - which will change to an arrow icon on mouse over. Service screens allow service properties to be configured.

A side panel of all services can be revealed by clicking the icon on the left of the left-most "Services" title. Reclicking this icon will hide the panel.

Enabling a Service

If the service is not online, click the power icon and the service should come online

Disabling a Service

If the service is online, click the power icon and the service should go offline

Setting Properties

Properties can be set by changing them in the BUI and then clicking "APPLY". The "REVERT" button will reset the properties to their previous state, before editing.

Viewing Service Logs

Some service screens also provide service logs. These logs can provide information to help diagnose service issues, including:

• Times when a service changed state

• Error messages from the service

Look to the top right for "Properties" and "Logs", click "Logs" to change to the log viewer. If "Logs" is not visible, the service does not provide logs.

The log content is custom to each individual service, and subject to change with future updates to the appliance software. The following are example messages that are commonly used in this version of the appliance:

This is an example from the NTP service:

[ Oct 11 21:05:31 Enabled. ]
[ Oct 11 21:07:37 Executing start method (...). ]
[ Oct 11 21:13:38 Method "start" exited with status 0. ]

The system was booted at 21:05, and there is an event in the log to show that this service was found to be enabled. At 21:07:37 this service began startup, which completed at 21:13:38 - some six minutes later. Due to the nature of NTP and system clock adjustment, this service can take minutes to complete start up, as shown by the log.

CLI

The CLI services section is under configuration services. The show command shows the current state of all services:

caji:> configuration services
caji:configuration services> show
Services:
                              ad => disabled
                             smb => disabled
                             dns => online
                      dynrouting => online
                             ftp => disabled
                            http => disabled
                        identity => online
                           idmap => online
                            ipmp => online
                           iscsi => online
                            ldap => disabled
                            ndmp => online
                             nfs => online
                             nis => disabled
                             ntp => disabled
                     replication => online
                            scrk => disabled
                            sftp => disabled
                          shadow => online
                            smtp => online
                            snmp => disabled
                             ssh => online
                          syslog => disabled
                            tags => online
                            tftp => disabled
                           vscan => disabled
                           

Children:
                              ad => Configure Active Directory
                             smb => Configure SMB
                             dns => Configure DNS
                      dynrouting => Configure Dynamic Routing
                             ftp => Configure FTP
                            http => Configure HTTP
                        identity => Configure System Identity
                           idmap => Configure Identity Mapping
                            ipmp => Configure IPMP
                           iscsi => Configure iSCSI
                            ldap => Configure LDAP
                            ndmp => Configure NDMP
                             nfs => Configure NFS
                             nis => Configure NIS
                             ntp => Configure NTP
                     replication => Configure Remote Replication
                            scrk => Configure Phone Home
                            sftp => Configure SFTP
                          shadow => Configure Shadow Migration
                            smtp => Configure SMTP
                            snmp => Configure SNMP
                             srp => Configure SRP
                             ssh => Configure SSH
                          syslog => Configure Syslog
                            tags => Configure Service Tags
                            tftp => Configure TFTP
                           vscan => Configure Virus Scan
                         routing => Configure Routing Table

Selecting a Service

Select a service by entering its name. For example, to select nis:

caji:configuration services> nis
caji:configuration services nis>

Once selected, its state can be viewed, it can be enabled and disabled, and properties may be set.

Viewing Service State

Service state can be viewed using the show command:

caji:configuration services nis> show
Properties:
                      <status> = online
                        domain = fishworks
                     broadcast = true
                     ypservers =
caji:configuration services nis>

Enabling a Service

Use the enable command:

caji:configuration services nis> enable

Disabling a Service

Use the disable command:

caji:configuration services nis> disable

Setting Properties

Properties can be changed by using the set command. After setting the properties to the desired values, use commit to save and activate the configuration:

caji:configuration services nis> set domain="mydomain"
                        domain = mydomain (uncommitted)
caji:configuration services nis> commit
caji:configuration services nis> show
Properties:
                      <status> = online
                        domain = mydomain
                     broadcast = true
                     ypservers =

Property names are similar to those shown in the BUI, but usually shorter and sometimes abbreviated.

Viewing Service Logs

Service logs cannot currently be viewed from the CLI.

Service Help

Type help to see all commands for a service:

caji:configuration services nis> help
Subcommands that are valid in this context:

   help [topic]         => Get context-sensitive help. If [topic] is specified,
                           it must be one of "builtins", "commands", "general",
                           "help", "script" or "properties".

   show                 => Show information pertinent to the current context

   commit               => Commit current state, including any changes

   done                 => Finish operating on "nis"

   enable               => Enable the nis service

   disable              => Disable the nis service

   get [prop]           => Get value for property [prop]. ("help properties"
                           for valid properties.) If [prop] is not specified,
                           returns values for all properties.

   set [prop]           => Set property [prop] to [value]. ("help properties"
                           for valid properties.) For properties taking list
                           values, [value] should be a comma-separated list of
                           values.