Source:Configuring and Administering HPE Catalyst Data Store by using CLI

Overview

This article describes details about the configuration of the HPE StoreOnce data stores on SEP sesam.

Configuring HPE Catalyst data store using CLI

The sm_config_drives command is used to configure the access to the HPE Catalyst store on the HPE StoreOnce server.

sm_config_drives

The sm_config_drives retrieves the HPE StoreOnce server address and the HPE Catalyst store name with optional client and password settings. These parameters are automatically copied to the HPE StoreOnce data store drive configuration file, which resides in the folder <SESAM_VAR>/ini/stpd_conf.

stpd_conf

The HPE StoreOnce data store configuration is saved in a stpd specific .ini file in the directory gv_rw_ini:stpd_conf.

The .ini file name is derived from the data store name data_stores.name (HPE_Store1), as is the case for every other data store, and the drive number of the first drive for this data_store, e.g., HPE_Store1_2.ini. The data store name is also used as device name in the hw_drives table together with prefix DS@ and the drive number, e.g., hw_drives.device=DS@HPE_Store1_2.

For example, bigsrv1:/var/opt/sesam/var/ini/stpd_conf # cat HPE_Store_1_2.ini:

[CATALYST]
backend=catalyst_store
hostname=storeoncevsa.srv.qa.mycompany.com
catalyst_store=HPE_Store_1
command_port=9387
data_port=9388
access_key="bigsrv1"
secret_key={8494a4b4c4d4e4f4675bfe5226281414d14a58c0f514f524eda63797b8114749}

[DISK_STORE]
Storage_Location=/HPE_Store_1
Size=-10GB
backend=catalyst_store
hostname=localhost

Advanced CLI administration

The sm_dedup_interface command is used as a frontend for the HPE Catalyst store on the HPE StoreOnce server.

sm_dedup_interface

The following list shows valid commands and their usage:

sm_dedup_interface -d <data_store> <command>

sm_dedup_interface.exe -d 2 usage
2019-07-31 13:12:50 gitID: $Id: e89e3e461f (HEAD -> v4_4_3_5, tag: v4_4_3_5_build, origin/v4_4_3_5) 2019-07-19 13:20:59 +0200 $, Si3/Si3-NG & StoreOnce
Common options:
 init -u <uuid> -t <label>    initiate upper data store directory structure
 init -t <tape_spec>          initiate lower data store directory structure
 status                       get data store status
 df                           get full summary of available and used disk space usage of the file system
 du                           get used disk space usage of the file system
 list|dir [<saveset>*]        get saveset information
 delete <saveset> [<saveset>*]
                              remove saveset from the data store
 getlabel                     get data store label
 getpath                      get data store path
 getuuid                      get data store uuid
 put <input_file_name> <dest_file_name> [over]
                              upload file into the data store
 get <remote_file_name> <dest_file_name> [<bytes skipped then> [<bytes read at beginning>]]
                              download file or it's part from the data store

	Note
	Some of the parameters are for internal use or for the future use only.

status

• Provides information about encryption, used space, saved data and object summary.

bigsrv1:/var/opt/sesam/var/ini/stpd_conf # sm_dedup_interface -d 2 status
2019-07-31 13:15:38 gitID: $Id: e89e3e461f (HEAD -> v4_4_3_5, tag: v4_4_3_5_build, origin/v4_4_3_5) 2019-07-19 13:20:59 +0200 $, Si3/Si3-NG & StoreOnce
Using HPE StoreOnce Catalyst Client
Ctl_SetCredentials [storeoncevsa-v4.srv.qa.mycompany.com]
Ctl_SetLogDescriptor [C:\ProgramData\SEPsesam\var\log\sms/stpd_so_20190731.log] Log size: [2621440] Log level: [0]
Ctl_GetServerProp [storeoncevsa-v4.srv.qa.mycompany.com]
Server Status:
 Repository information:      2019-07-31 13:15:39
  HPE StoreOnce time:         2019-07-31 11:15:39
  Creation time:              2019-07-09 13:14:07
  Last modified time:         2019-07-18 11:30:29
  Path:                       HPE_Store_1
  Version:                    2 (Server version: 4.1.1-1849.3)
  Encryption:                 Off
  Bytes in repository:          23.5 GiB
  Jobs:                       All: 414 Data jobs: 314 Dest copy jobs: 0 Origin copy jobs: 0
  Status:                     Online (Ok: Online)
  Free data sessions:         13/32
  Object lock resources:      Available
  HPE Storage:                Bytes All: 882079956992, Use: 53624758272, Free: 828455198720, Used: 6%
  Logical  Storage Quota:     Bytes All: -, Use: 239273889320, Free: -, Used: 0%
  Physical Storage Quota:     Bytes All: -, Use: 25270237105, Free -, Used: 0% 

 Object information:
  Objects stored:             102
  Data before deduplication:   222.8 GiB
  Data after  deduplication:    23.5 GiB
  Overall DeDup ratio:        1 / 9.80
  Saved storage space:        89.44 % 

STATUS=SUCCESS MSG=

The value Overall DeDup ratio shows by what percentage the stored data has been reduced.

list|dir [<saveset>*]

• List all objects or the given savesets in the HPE Catalyst store.

delete <saveset> [<saveset>*]

• Deletes all given savesets from the HPE Catalyst store.

get

• Reads an object (file, saveset) from the HPE Catalyst store.
• '-' can be used to specify STDOUT

put

• Writes an object (file, saveset) to the HPE Catalyst store.
• '-' can be used to specify STDIN

Logging

The HPE Catalyst client library logging is written to the file gv_rw_sms:stpd_so_<day>.log, for example, logging file name /var/opt/sesam/var/log/sms/stpd_so_20190731.log.

The log settings are defined with the log settings Log_Levels and Log_Size (in kilobytes (kB)) from the gv_rw_ini:stpd.ini.

[STPD_Logging]
Log_Levels=2
Log_Size=1024

Logging levels

The available Log_Levels are -1=NO_LOG, 0=ERROR, 1=EMERGENCY, 2=WARNING, 3=NOTICE, 4=INFO, 5=DEBUG, 6=TRACE. These logging levels are mapped to the corresponding HPE StoreOnce Catalyst client library logging levels:

-1|0|1 -> OSCLT_LOG_LEVEL_ERROR
2 -> OSCLT_LOG_LEVEL_QUIET 
3 -> OSCLT_LOG_LEVEL_INFO 
4 -> OSCLT_LOG_LEVEL_TRACE 
5 -> OSCLT_LOG_LEVEL_DEBUG
6 -> OSCLT_LOG_LEVEL_EXTENDED_DEBUG

Autorotation happens if the log file size reaches the maximum log size defined via Log_Size.

Additional log settings

The logging level settings defined in gv_rw_ini:stpd.ini may be overwritten with specific settings in the HPE StoreOnce data store drive configuration file gv_rw_ini:stpd_conf/{name}_{drive_num}.ini.

Example for /var/opt/sesam/var/ini/stpd_conf/HPE_Store_1_2.ini with increased logging level and size.

[CATALYST]
Log_Levels=5
Log_Size=20480
backend=catalyst_store
hostname=storeoncevsa.srv.qa.mycompany.com
catalyst_store=HPE_Store_1
command_port=9387
data_port=9388
access_key="bigsrv1"
secret_key={8494a4b4c4d4e4f4675bfe5226281414d14a58c0f514f524eda63797b8114749}

[DISK_STORE]
Storage_Location=/HPE_Store_1
Size=-10GB
backend=catalyst_store
hostname=localhost

HPE Catalyst store objects

For every SEP sesam saveset there are two objects stored in the HPE Catalyst store:

• <ssid>.data
• <ssid>.info

The saveset data is stored in the .data file. The SEP sesam saveset attributes are recorded in the .info file. Both objects are identical to those of other data stores, e.g., Path data store with files <ssid>.data and <ssid>.info.

What is next?

After configuring the HPE StoreOnce data store, configure the media pools, then set up your backup strategy.