System

System / Backup

Execute backup of configuration, database, and file system metadata.

This web service runs the snbackup command.

Parameters

Parameter Req / Opt Num Description CLI Option

mode

Optional 1 This option specifies if the job will be run synchronously or asynchronously. The valid values are sync and async. The default value is sync. None

jobtype

Optional 1 This parameter is used for async mode only and enables the user to run it as a fast or slow job. Valid values are fast and slow. The default value is fast. None

format

Optional 1 The output format requested. Valid values are json and text. The default is text.

-F

Example

https://<<SERVER>>/sws/v2/system/snbackup
?partial=true
&meta=true

Output

Exit Code: 0

Output: =========-----------------=========

=====--- StorNext Backup ---=====

=========-----------------=========

 

Backup Start: Thu Apr 17 12:56:30 2014

Log File: /usr/adic/TSM/logs/reports/backup.status

Type: Partial Backup

 

=========-----------------==========

======--- Begin Processing ---======

=========-----------------==========

 

- Connecting to database

Database connection successful

 

- Configuring backup information

- Backup using storage manager

- Querying database for _adic_backup class information

- Getting list of file systems with metadata files

- Checking for BACKUPFS fs_sysparm setting

- Scanning for defined file systems

- Updating fs_sysparm for selected mount point

 

- Checking for required components

- Verifying Relation Point

- Get identifier information and sequence numbers

Using Backup ID 15 for partial backup

- Check Failures

 

- Getting list of existing backup files

 

- Package Configuration Files

 

- Package Database Files

- Dumping database

Backup scanned up to lsn 71894126433

mysqlbackup incremental backup succeeded

- Create archive file for database backup

 

- Package Filesystem Metadata Files

- Suspending metadata archive processing for target

- Updating reference copy for target

- Compressing package for target

Packaged target metadata - took 83s

- Resuming metadata archive processing for target

 

- Storing files to media

 

- Removing obsolete backup versions

- Update database backup catalog

- Syncing backup manifest files

Wrote out snbackup_manifest file /usr/adic/mysql/snbackup_manifest

Wrote out snbackup_manifest file /usr/adic/TSM/internal/status_dir/snbackup_manifest

Wrote out device_manifest file /usr/adic/mysql/device_manifest

Wrote out device_manifest file /usr/adic/TSM/internal/status_dir/device_manifest

 

- Checking for files to revert

 

=========-----------------==========

======--- Backup End ---======

=========-----------------==========

 

== End Time: Thu Apr 17 13:08:51 2014

== Backup successfully completed

System / Backup Status

Retrieves the status of the backup operation.

This web service runs the snbackup command.

Note: This web service returns text or json output. The default is text.

Parameters

This web service does not contain any parameters.

Example

https://<<SERVER>>/sws/v2/system/snbackup/status

Output

Exit Code: 0

Output: Backup Complete: Backup completed successfully

Output from last run of snbackup:

2014-04-17-12:56:30: Backup Start: Thu Apr 17 12:56:30 2014

2014-04-17-12:56:30: - Connecting to database

2014-04-17-12:56:30: Database connection successful

2014-04-17-12:56:30: - Configuring backup information

2014-04-17-12:56:30: - Backup using storage manager

2014-04-17-12:56:30: - Querying database for _adic_backup class information

2014-04-17-13:03:56: - Compressing package for target

2014-04-17-13:05:19: Packaged target metadata - took 83s

2014-04-17-13:05:19: - Resuming metadata archive processing for target

2014-04-17-13:05:19: - Storing files to media

2014-04-17-13:08:36: - Removing obsolete backup versions

2014-04-17-13:08:36: - Update database backup catalog

2014-04-17-12:56:30: - Getting list of file systems with metadata files

2014-04-17-12:56:30: - Checking for BACKUPFS fs_sysparm setting

2014-04-17-12:56:30: - Scanning for defined file systems

2014-04-17-12:56:30: - Updating fs_sysparm for selected mount point

2014-04-17-12:56:30: - Checking for required components

2014-04-17-12:56:30: - Verifying Relation Point

2014-04-17-12:56:31: - Get identifier information and sequence numbers

2014-04-17-12:56:31: - Check Failures

2014-04-17-12:56:31: - Getting list of existing backup files

2014-04-17-12:56:31: - Package Configuration Files

2014-04-17-12:56:58: - Package Database Files

2014-04-17-12:56:58: - Dumping database

2014-04-17-13:02:10: Backup scanned up to lsn 71894126433

2014-04-17-13:02:10: mysqlbackup incremental backup succeeded

2014-04-17-13:02:10: - Create archive file for database backup

2014-04-17-13:02:14: - Package Filesystem Metadata Files

2014-04-17-13:02:14: - Suspending metadata archive processing for target

2014-04-17-13:02:14: - Updating reference copy for target

2014-04-17-13:08:37: - Syncing backup manifest files

2014-04-17-13:08:37: Wrote out snbackup_manifest file /usr/adic/mysql/snbackup_manifest

2014-04-17-13:08:37: Wrote out snbackup_manifest file /usr/adic/TSM/internal/status_dir/snbackup_manifest

2014-04-17-13:08:39: Wrote out device_manifest file /usr/adic/mysql/device_manifest

2014-04-17-13:08:39: Wrote out device_manifest file /usr/adic/TSM/internal/status_dir/device_manifest

2014-04-17-13:08:51: - Checking for files to revert

2014-04-17-13:08:51: == End Time: Thu Apr 17 13:08:51 2014

2014-04-17-13:08:51: == Backup successfully completed

systems with relation points

System / File System Report

This web service reports the status of a file system and the status of stripe groups that belong to it.

Parameters

Parameter Req / Opt Num Description CLI Option

mode

Optional 1 This option specifies if the job will be run synchronously or asynchronously. The valid values are sync and async. The default value is sync. None

jobtype

Optional 1 This parameter is used for async mode only and enables the user to run it as a fast or slow job. Valid values are fast and slow. The default value is fast. None

format

Optional 1 The output format requested. The valid values are xml, json and text. The default value is text. -F

filesystem

Required 1 The file system name for which status is required. None

showstripegroups

Optional 1 This option will also enable the status information of stripe groups. The valid values are true and false. The default value is false.  

Example

https://<<SERVER>>/sws/v2/system/filesystem/info

?filesystem=snfx1

&showstripegroups=true

&format=json

Output

{
  "status" : "Online",
  "totalSpace" : "19.991 GB",
  "usedSpace" : "9.1 GB",
  "usedPercent" : "45%",
  "freeSpace" : "10.937 GB",
  "freePercent" : "55%",
  "sgList" : [ {
    "name" : "sg0",
    "totalSpace" : "19.99 GB",
    "reservedSpace" : "4.13 GB",
    "freeSpace" : "15.07 GB"
  } ]
}

System / Information

Retrieves the latest status of system components.

This web service runs control scripts for different components and gathers the output.

Parameters

Parameter

Req / Opt

Num

Description

CLI Option

mode

Optional 1 This option specifies if the job will be run synchronously or asynchronously. The valid values are sync and async. The default value is sync. None

jobtype

Optional 1 This parameter is used for async mode only and enables the user to run it as a fast or slow job. Valid values are fast and slow. The default value is fast. None

format

Optional

1

The output format requested. Valid values are xml, json and text. The default is text.

-F

Example

https://<<SERVER>>/sws/v2/system/info
?format=xml

Output

<?xml version="1.0" encoding="UTF-8" ?>

<xml-fragment>

<sws:SoftwareVersion xmlns:sws="http://www.quantum.com/sws">5.0.0</sws:SoftwareVersion>

<sws:System xmlns:sws="http://www.quantum.com/sws">ONLINE</sws:System>

<sws:Tsm xmlns:sws="http://www.quantum.com/sws">ONLINE</sws:Tsm>

<sws:Msm xmlns:sws="http://www.quantum.com/sws">ONLINE</sws:Msm>

<sws:Dsm xmlns:sws="http://www.quantum.com/sws">ONLINE</sws:Dsm>

<sws:Database xmlns:sws="http://www.quantum.com/sws">ONLINE</sws:Database>

<sws:Srvclog xmlns:sws="http://www.quantum.com/sws">ONLINE</sws:Srvclog>

</xml-fragment>

System / Parameters

Report the value for the specified Tertiary Manager system parameter.

This web service runs the showsysparm command.

Parameters

Parameter

Req / Opt

Num

Description

CLI Option

mode

Optional 1 This option specifies if the job will be run synchronously or asynchronously. The valid values are sync and async. The default value is sync. None

jobtype

Optional 1 This parameter is used for async mode only and enables the user to run it as a fast or slow job. Valid values are fast and slow. The default value is fast. None

format

Optional

1

The output format requested. Valid values are xml, json and text. The default is text.

-F

param

Required

N

Name of the system parameter.

no CLI option

Example

https://<<SERVER>>/sws/v2/system/showsysparm
?param=CLASS_DEFAULT_COPIES
&format=xml

Output

<?xml version="1.0" encoding="UTF-8" ?>

<showsysparm xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="showsysparm.xsd">

<header>

<commandName>showsysparm</commandName>

<commandLine>/usr/adic/TSM/util/showsysparm CLASS_DEFAULT_COPIES -F xml</commandLine>

<commandDescription>Report the value for the specified Tertiary Manager system parameter.</commandDescription>

<localDateISO>2014-05-15T10:39:59</localDateISO>

<localDate>2014-05-15</localDate>

<localTime>10:39:59</localTime>

<localDayOfWeek>4</localDayOfWeek>

<gmtDateISO>2014-05-15T15:39:59Z</gmtDateISO>

<gmtDate>2014-05-15</gmtDate>

<gmtTime>15:39:59</gmtTime>

<gmtDayOfWeek>4</gmtDayOfWeek>

</header>

<sysparms>

<sysparm>

<name>CLASS_DEFAULT_COPIES</name>

<value>1</value>

</sysparm>

</sysparms>

<statuses>

<status>

<statusCode>FS0000</statusCode>

<statusNumber>0</statusNumber>

<dayOfMonth>15</dayOfMonth>

<requestId>387968</requestId>

<commandName>/usr/adic/TSM/util/showsysparm</commandName>

<commandStatus>completed</commandStatus>

<statusText>Command Successful.</statusText>

</status>

</statuses>

<footer>

<returnCode>0</returnCode>

<localDateISOEnd>2014-05-15T10:39:59</localDateISOEnd>

<localDateEnd>2014-05-15</localDateEnd>

<localTimeEnd>10:39:59</localTimeEnd>

<localDayOfWeekEnd>4</localDayOfWeekEnd>

<gmtDateISOEnd>2014-05-15T15:39:59Z</gmtDateISOEnd>

<gmtDateEnd>2014-05-15</gmtDateEnd>

<gmtTimeEnd>15:39:59</gmtTimeEnd>

<gmtDayOfWeekEnd>4</gmtDayOfWeekEnd>

<elapsedTimeInSeconds>0.0000</elapsedTimeInSeconds>

</footer>

</showsysparm>