Services

Rockstor supports many services that are necessary or useful in a storage system. Service management, i.e. turning on or off, and configuration can be done via the System - Services page of the web-UI. Note that the spanner icon next to each service name is used to configure that service.

On the Services page, all services and their current state are displayed.

../../_images/services_list.png

To start or stop a service, click its respective ON or OFF buttons.

Some services need to be configured before they can be turned on. To access the configuration page for a service, click the wrench icon next to the service name.

Please note that not all services are documented here as we are currently working on upgrading the documentation.

NFS

Rockstor uses Linux NFS server to support exporting Shares to remote clients via NFS. Custom NFS configuration is not supported, but the service must be turned on in order to export shares. See the Network File System (NFS) section for details.

Samba

Rockstor supports making Shares available to SMB and CIFS clients via Samba software suite. Custom Samba server configuration is not supported, but the service must be turned on before exposing shares. See the Samba/CIFS section for details.

SFTP

SFTP stands for Secure File Transfer Protocol and is essentially FTP over SSH. In Rockstor user owned shares exported via this method are mounted withing a minimal chroot environment for enhance security. Please see out Secure File Transport Protocol (SFTP) section.

NTP

NTP maintains system time in synchronization with Internet standard time server. This service must always be turned on.

To configure NTP, you can specify the address of an Internet standard time server in the NTP configuration page.

../../_images/ntp-config.png

Active Directory (AD)

AD is a directory service to connect to an Active Directory domain. It must be turned ON in order to be part of the AD.

Before configuring the AD service, however, some preparations are required. First, the Samba service must be configured with the AD domain realm as the workgroup. For an AD domain of samdom.example.com, for instance, the Samba workgroup should be set as SAMDOM as illustrated below. Note that while the Samba service needs to be configured, it doesn’t need to be turned ON.

../../_images/ad_samba_config.png

Next, as correct time synchronization with the AD domain is necessary for good performance, the NTP service should be configured and turned ON. Ideally, both the AD domain and Rockstor machines should thus use the same NTP time server.

Now that the Samba workgroup has been defined, and the NTP service configured and running, the AD service can be configured. To do so, click on the wrench icon and fill in the form with the values corresponding to your AD domain.

../../_images/ad_config.png

The individual fields of the form are described below.

  • Domain/Realm name: Specifies the desired Active Directory or Domain.

  • Administrator Username: Name of the user to use for the enrollment to the AD. Tihs should be the AD’s administrator account.

  • Password: Password for the Administrator username.

  • Enable enumeration: Fetch and display all users/groups values. As this option can have a notable performance cost in some servers (with high number of users, for instance), this option is disabled by default. Note, however, that this option must be enabled for Rockstor to be able to list AD users and groups in the web-UI. See SSSD FAQ for further details.

  • Disable automatic ID mapping: By default, the AD provider will map UID and GID values from the objectSID parameter in Active Directory. Check this option if you want to disable ID mapping and instead rely on POSIX attributes defined in Active Directory. See SSSD documentation for furhter details.

  • Treat user and group names as case-sensitive

Rockstor 4 relies on SSSD for the management of identities provided by AD. As a result, one can edit /etc/sssd/sssd.conf to further customize the enrollment into an AD.

Upon submission of the AD configuration form, Rockstor will test the configuration settings by attempting to discover the AD domain and save the configuration if successful. If Rockstor cannot discover the AD domain, it will report the error back to the web-UI; notably, verify that the AD domain can be resolved by name via DNS (see Red Hat Windows Integration Guide for further documentation).

Note that a successful configuration of the AD service does not enroll the system into the AD. To do this, the AD service must be turned ON. To leave the AD, simply turn the AD service OFF.

Lightweight Directory Access Protocol (LDAP)

LDAP is a directory service to connect to a LDAP server. It must be turned ON in order to fetch users from the LDAP directory.

First, the LDAP service needs to be configured: click on the wrench icon and fill in the form with the values corresponding to your LDAP server.

../../_images/ldap_config.png

The individual fields of the form are described below.

  • LDAP Server: The hostname of the LDAP server.

  • Search base DN: Specifies that user information should be retrieved using the listed Distinguished Name (DN).

  • Certificate path: Absolute path to the TLS certificate of the LDAP server.

Rockstor 4 relies on SSSD for the management of identities provided by LDAP. As a result, one can edit /etc/sssd/sssd.conf to further customize the connection to the LDAP server.

Note

The LDAP implementation is an area under active development. As a result, we are seeking feedback from users on further customizations and settings to implement in Rockstor web-UI. Please visit our friendly forum to share your feedback or provide input on further LDAP expansion.

Note that a successful configuration of the LDAP service does not connect the system to the LDAP server. To do this, the LDAP service must be turned ON. To disconnect from the LDAP server, simply turn the LDAP service OFF.

Network Information Server (NIS)

NIS is a directory service to connect to a NIS server.

In the web-ui, click on System tab to go to the System view. This also serves as the Services view, which is selected by default in the left sidebar. To configure NIS, click on the wrench icon and submit the form with appropriate values as shown below.

../../_images/nis-config.png
  • Domain: NIS domain.

  • Server: IP address of NIS server.

NUT-UPS

A (currently Beta) Network UPS Tools based service to orchestrate gracefull system shutdown in the event of a power outage. Please see our: UPS / NUT Setup section for more details.

Rock-Ons (Docker plugin system)

This is a very new service that is still in Beta, please see Rock-ons (Docker Plugins) for an introduction to Rockstor’s Docker based plugin system.

To start or stop any service, click the corresponding ON or OFF button