4 4 3 Beefalo:SEP sesam CLI: Difference between revisions

From SEPsesam
m (Sta moved page 4 4 3 Beefalo:SEP Sesam CLI to 4 4 3 Beefalo:SEP sesam CLI without leaving a redirect)
(Update in progress.)
(16 intermediate revisions by the same user not shown)
Line 6: Line 6:
<div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%; "><center><b>Additional resources</b></center>
<div class="boilerplate metadata" id="Additional resources" style="background-color:#ecedf1; color:#8695a7; border: 1px ridge #cdd3db; margin: 0.5em; padding: 0.5em; float: right; width: 35%; "><center><b>Additional resources</b></center>
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
{|style="margin: auto; margin-bottom:1em; width:100%; border:0px solid grey;"
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_next.png|45px|link=Special:MyLanguage/SEP Sesam CLI|]]
| rowspan="2" style="padding:0px 10px 0px;" | [[File:SEP_next.png|45px|link=Special:MyLanguage/4 4 3 Beefalo:SEP sesam CLI|]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | See also: [[CLI Showcase]] – [[SBC CLI]] – [[Special:MyLanguage/SEP_sesam_GUI|SEP sesam GUI]]
| style="padding:0px 40px 0px 10px; color: grey; font-size: 90%; text-align:left;" | See also: [[Special:MyLanguage/4 4 3 Beefalo:CLI Configuration Example|CLI configuration example]] – [[SBC CLI]] – [[Special:MyLanguage/SEP_sesam_GUI|SEP sesam GUI]]
|}
|}


Line 44: Line 44:
;< > angle brackets:Indicate that the enclosed element is mandatory.
;< > angle brackets:Indicate that the enclosed element is mandatory.
{{note|The commands are run in the command prompt from {{Sesamroot|/bin/sesam/}}.}} You must have administrator privileges to run CLI commands. Set the SEP sesam profile as described in [[Special:MyLanguage/FAQ#profile_setting|What happens when I set a profile?]] to be able to execute SEP sesam commands globally.
{{note|The commands are run in the command prompt from {{Sesamroot|/bin/sesam/}}.}} You must have administrator privileges to run CLI commands. Set the SEP sesam profile as described in [[Special:MyLanguage/FAQ#profile_setting|What happens when I set a profile?]] to be able to execute SEP sesam commands globally.
==={{anchor|action_commands}}Common action commands===
The action command is used to perform an action or retrieve information/status about the resource. Most SEP sesam CLI resources have the following action commands:
;get:The get command retrieves information about the resource or the operation that is currently defined.
;list:The list command returns a list of objects for the specified resource. If the optional ''<object_name_or_id>'' is also specified, then the results are filtered by that value.
;add:The add command creates a new object or event. If the optional ''<object_name_or_id>'' is also specified, then the objects are created according to the specified value.
;modify:The modify command changes an existing resource based on the specified object options.
;remove:The remove command deletes the specified object.


===Before you begin===
===Before you begin===
Line 51: Line 59:
*SEP sesam's optional command line commands are written directly to the SEP sesam database. Therefore all command line entries should be checked and verified!
*SEP sesam's optional command line commands are written directly to the SEP sesam database. Therefore all command line entries should be checked and verified!
*SEP sesam executes the commands immediately the ''<Enter>/<Return>'' key is pressed, which means that entries cannot be corrected, as is the case with the SEP Sesam GUI. It is extremely important that you are familiar with CLI and use it cautiously in order not to cause a system failure of the backup environment. Note that an erroneous entry can lead to '''complete data loss or other damage to the database'''. Such mistakes can void the warranty of your SEP sesam licensing agreement.
*SEP sesam executes the commands immediately the ''<Enter>/<Return>'' key is pressed, which means that entries cannot be corrected, as is the case with the SEP Sesam GUI. It is extremely important that you are familiar with CLI and use it cautiously in order not to cause a system failure of the backup environment. Note that an erroneous entry can lead to '''complete data loss or other damage to the database'''. Such mistakes can void the warranty of your SEP sesam licensing agreement.
*Have a look at a [[CLI Showcase|SEP sesam CLI example]] for the creation of a new SEP sesam environment by SEP sesam CLI. Only after becoming familiar with SEP sesam should you attempt to use the CLI and write your first scripts.
*Have a look at a [[Special:MyLanguage/4 4 3 Beefalo:CLI Configuration Example|CLI configuration example]] for the creation of a new SEP sesam environment by SEP sesam CLI. Only after becoming familiar with SEP sesam should you attempt to use the CLI and write your first scripts.
{{note|Before you start scripting with the SEP sesam CLI, you should familiarize yourself with the SEP sesam environment. Read the SEP sesam documentation carefully and work on the SEP sesam installation to understand how the SEP sesam objects work together.}}
{{note|Before you start scripting with the SEP sesam CLI, you should familiarize yourself with the SEP sesam environment. Read the SEP sesam documentation carefully and work on the SEP sesam installation to understand how the SEP sesam objects work together.}}


Line 62: Line 70:
! scope="col" style="text-align:left;" | Note
! scope="col" style="text-align:left;" | Note
  |-  
  |-  
|sm_cmd || | CLI main call|| ||
|sm_cmd || ||CLI main call || Each command is preceded by ''sm_cmd'' that invokes the command line interface. ||
|-  
|-  
|sm_cmd list allevent|| |List all events ||  ||
|[[4_4_3_Beefalo:SEP_sesam_CLI#account|sm_cmd ''<nowiki><get|list|add|modify|remove|send></nowiki>'' account]]|| ||Create and administer email accounts. ||  ||
  |-
  |-
|sm_cmd list allevent|| |List all events ||  ||
|[[4_4_3_Beefalo:SEP_sesam_CLI#acl|sm_cmd ''<nowiki><get|list|remove|check></nowiki>'' acl]]|| ||Administer ACLs: Reset a user password and list, check or remove ACLs.||  ||
 
  |-
  |-
|sm_cmd list allevent|| |List all events ||  ||
|sm_cmd list allevent|| |List all events ||  ||
Line 88: Line 97:
==Administration commands==
==Administration commands==
The following are the commands that allow you to execute the administrator’s tasks for SEP sesam.
The following are the commands that allow you to execute the administrator’s tasks for SEP sesam.
==={{anchor|account}}(EMAIL) ACCOUNT (account)===
;Usage: 
sm_cmd <get|list|add|modify|remove|send> account [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove</tt> – you can get a single email account, list all email accounts depending on list options (listed in main help <tt>sm_cmd help</tt>), create a new email account, modify an existing account, and delete the specified account. Additionally, you can send a message to the given email account and attach multiple local files by using <tt>send mail [OPTIONS...] ID</tt>.
==={{anchor|acl}}ACL ===
;Usage:
sm_cmd <get|list|remove|check> acl [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, remove</tt> – you can get a single access control list (acl), list all ACL entries depending on list options (listed in main help <tt>sm_cmd help</tt>) or list all ACL entries of a given user and/or object, and delete the specified ACL (ID=all will delete all configured ACLs).
==={{anchor|backup}}BACKUP===
;Usage: 
sm_cmd backup  [OPTIONS...]
;Description: By using the <tt>backup</tt> command you can start or stop the task or task group backup according to the specified parameters.
==={{anchor|clear_cache}}CLEAR CACHE===
;Usage: 
sm_cmd clear cache [OPTIONS...]
or
sm_cmd clear cache -t
;Description: By using the <tt>clear cache</tt> command you can clear the entire server cache according to the specified parameters; the  '-t' parameter sets table filter for clear cache.
==={{anchor|calendar}}CALENDAR===
;Usage: 
sm_cmd <get|list|add|modify|remove> calendar [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove</tt> – you can get a single calendar, list all calendars depending on list options (listed in main help <tt>sm_cmd help</tt>), create a new calendar with an automatically generated ID, modify a calendar and delete a calendar; ID can be a character string ID or a numeric ID value.
==={{anchor|calendarevent}}CALENDAR EVENT (calendarevent)===
;Usage:
sm_cmd <get|list|add|modify|remove> calendarevent [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove</tt> – you can get a single calendar event, list all calendar events depending on list options (listed in main help <tt>sm_cmd help</tt>), create a new calendar event, modify a calendar event and delete a calendar event.
==={{anchor|client}}CLIENT===
;Usage:
sm_cmd <get|list|add|modify|remove|dir> client [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove, dir</tt> – you can get a single client, list all clients depending on list options (listed in main help <tt>sm_cmd help</tt>), create a new client, modify a client, delete a client and browse directory of the client.
==={{anchor|command}}COMMAND===
;Usage:
sm_cmd <get|list|add|modify|start|remove> command [OPTIONS...]
     
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, start, remove</tt> – you can get a single command, list all commands depending on list options (listed in main help <tt>sm_cmd help</tt>), create a new command, modify a command, execute a command and delete a command.
==={{anchor|commandevent}}COMMAND EVENT (commandevent)===
;Usage:
sm_cmd <get|list|add|modify|remove> commandevent [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove</tt> – you can get a single command event, list all events depending on list options (listed in main help <tt>sm_cmd help</tt>), create a new command event with an automatically generated ID, modify a command event, and remove a command event.
==={{anchor|credential}}CREDENTIAL===
;Usage:
sm_cmd <get|list|add|modify|enable|disable|link|unlink|remove> credential [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, enable, disable, link, unlink, remove</tt> – you can get an existing credential set by ID or name, list all credential sets depending on list options (listed in main help <tt>sm_cmd help</tt>), add a new credential set, modify an existing credential set by ID or name, and link/unlink a credential set to/from a SEP sesam object, i.e., data store. You can also delete a credential set by ID or name if there are no more references. In case of LDAP or AD credential sets, you can enable or disable a credential set by ID or name. 
==={{anchor|datastore}}DATA STORE (datastore)===
;Usage:
sm_cmd <get|list|add|modify|remove> datastore [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove</tt> – you can get a single data store, list all data stores depending on list options (listed in main help <tt>sm_cmd help</tt>), create a new data store, modify a data store, and remove a data store with all dependencies.
==={{anchor|default}}DEFAULT KEY (default)===
;Usage:
sm_cmd <get|list|add|modify|remove> default [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove</tt> – you can get a value of the default key, list all default keys (listed in main help <tt>sm_cmd help</tt>), add a new default key and its value, modify a value of the default key, and delete a given default key.
==={{anchor|drive}}DRIVE===
;Usage:
sm_cmd <get|list|add|modify|remove|start|mount|dismount|unload> drive [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove, start, mount, dismount, unload</tt> – you can get a single drive, list all drives (listed in main help <tt>sm_cmd help</tt>), create a new drive with an automatically generated ID, and modify, delete, configure and mount/dismount a drive. You can also release and eject the tape in the drive.
==={{anchor|drivegroup}}DRIVE GROUP (drivegroup)===
;Usage:
sm_cmd <get|list|add|modify|remove> drivegroup [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove</tt> – you can get a single drive group, list all drive groups (listed in main help <tt>sm_cmd help</tt>), create a new drive group, modify a drive group, and delete a drive group.
==={{anchor|group}}USER GROUP (group)===
;Usage:
sm_cmd <get|list|add|modify|remove> group [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove</tt> – you can get a single user group, list all user groups (listed in main help <tt>sm_cmd help</tt>), create a new user group, modify a user group, and delete a user group.
==={{anchor|interface}}INTERFACE===
;Usage:
sm_cmd <get|list|add|remove> interface [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, remove</tt> – you can get a single interface, list all interfaces (listed in main help <tt>sm_cmd help</tt>), create a new interface, and delete selected interface.
==={{anchor|start_inventory}}INVENTORY (start inventory)===
;Usage:
sm_cmd start inventory [OPTIONS...]
;Description: By using the <tt>start inventory</tt> command you can start archive adjustment to make a comparison between media in the loader carousel or magazine and the SEP sesam media archive database.
==={{anchor|license}}LICENSE===
;Usage:
==={{anchor|loader}}LOADER===
;Usage:
==={{anchor|loaderdevice}}LOADER DEVICE (loaderdevice)===
;Usage:
==={{anchor|location}}LOCATION===
;Usage:
==={{anchor|media}}MEDIA===
;Usage:


==Configuration commands==
==Configuration commands==
The following are the commands that allow you that allow you to configure SEP sesam environment.
The following are the commands that allow you to configure SEP sesam environment.


;Usage: 
sm_cmd <get|list|add|modify|remove|send> account [OPTIONS...]
;Description: By using [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|action commands]] – <tt>get, list, add, modify, remove</tt> – you can get a single email account, list all email accounts depending on list options (listed in main help <tt>sm_cmd help</tt>), create a new email account, modify an existing account, and delete the specified account. Additionally,  you can send a message to the given email account and attach multiple local files by using <tt>send mail [OPTIONS...] ID</tt>.
 
==Monitoring commands==
==Monitoring commands==
The following are the commands that display information about SEP sesam environment.
The following are the commands that display information about SEP sesam environment.
==={{anchor|allevent}}List all events (allevent)===
;Usage: 
sm_cmd list allevent [OPTIONS...]
or 
sm_cmd list [LIST OPTIONS] allevent [FILTER OPTIONS...]
;Description: By using the [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|list command]] you can list all events or list all events depending on list options (listed in main help <tt>sm_cmd help</tt>) in a table format.
==={{anchor|allresult}}List all results (allresult)===
;Usage:
sm_cmd list allresult [OPTIONS...]
or
sm_cmd list [LIST OPTIONS] allresult [FILTER OPTIONS...]
;Description: By using the [[Special:MyLanguage/4_4_3_Beefalo:SEP_sesam_CLI#action_commands|<tt>list</tt> command]] you can list all results or list all resultss depending on list options (listed in main help <tt>sm_cmd help</tt>).
==={{anchor|calendarsheet}}CALENDAR SHEET (calendarsheet)===
;Usage:
sm_cmd <download|show> calendarsheet [OPTIONS...]
;Description: By using the <tt>show</tt> or <tt>download</tt> command you can show or download calendar information for the specified time frame.
==={{anchor|current}}CURRENT DRIVE (current)===
;Usage:
sm_cmd <download|show> current [OPTIONS...]
;Description: By using the <tt>show</tt> or <tt>download</tt> you can show or download the current drive information from the server.
==={{anchor|dir}}DIR===
;Usage:
sm_cmd dir <argument> [OPTIONS...]
;Description: By using the <tt>dir</tt> you can list all configured clients, list all elements with task type ''Path'' for a client, list root directory of the client, list VMware content of the client, list all VMs, and list VMs of the vCenter. 
==={{anchor|log}}LOG===
;Usage:


==Troubleshooting commands==
==Troubleshooting commands==
The following are the commands that allow you to troubleshoot the SEP sesam environment.
The following are the commands that allow you to troubleshoot the SEP sesam environment.

Revision as of 17:08, 19 November 2019

Draft.png WORK IN PROGRESS
This is a draft document for the SEP sesam upcoming 4.4.3 Beefalo V2 release. Note that the article is in the initial stage and may be updated, replaced or deleted at any time. It is inappropriate to use this document as reference material as it is a work in progress and should be treated as such.

Copyright © SEP AG 1999-2024. All rights reserved.

Any form of reproduction of the contents or parts of this manual is allowed only with the express written permission from SEP AG. When compiling and designing user documentation SEP AG uses great diligence and attempts to deliver accurate and correct information. However, SEP AG cannot issue a guarantee for the contents of this manual.

Docs latest icon.png Welcome to the latest SEP sesam documentation version 4.4.3/4.4.3 Beefalo. For previous documentation version(s), check documentation archive.


Overview

The SEP sesam command line interface (CLI) is a utility that provides an alternate way of executing SEP sesam commands in UNIX and Windows environments. SEP sesam command line interface provides two CLI components: administration utility SEP sesam CLI and client utility SBC CLI. The latter is used to back up and restore data locally on the host.

SEP sesam CLI administration utility is used to install and configure a SEP sesam environment automatically without a GUI. CLI commands enables administrators to access SEP sesam database and manage the whole SEP sesam environment, for example, to install, configure and manage SEP sesam servers and clients centrally without a GUI. Every CLI command (except a native SQL statement) checks and follows the internal structure and dependencies of the SEP sesam database.

Features

  • Automatic configuration of SEP sesam environments after installation (e.g., on implementation)
  • Change the SEP sesam configuration without using the SEP sesam GUI
  • Script-based mass installation and configuration (e.g., provider environment)
  • Operate tests for installation and configuration in SEP sesam environments
  • Get SEP sesam status, log and version information
  • Determine SEP sesam object information for further use in other programs

Understanding the command structure

The SEP sesam general syntax for a CLI command is:

sm_cmd <command> [–option] [<object>] [[–<parameter>] <value>]

where the following information is provided for each command

  • sm_cmd: A command line tool that invokes the command line interface.
  • Usage: The actual syntax of the command, including the arguments.
  • Description: A brief summary of what the command does.
  • Arguments: The definition of options used in the command.
  • Example: Example of the command usage of the specified command and its options.

Command conventions

The parameters for a command are order-dependent and might include mandatory and optional values, or keyword choices. Mandatory functions are designated by an asterisk (*).

| vertical bar
Separates the choices between two or more options or arguments.
[ ] square brackets
Indicate optional values.
< > angle brackets
Indicate that the enclosed element is mandatory.
Information sign.png Note
The commands are run in the command prompt from <SESAM_ROOT>/bin/sesam/.

You must have administrator privileges to run CLI commands. Set the SEP sesam profile as described in What happens when I set a profile? to be able to execute SEP sesam commands globally.

Common action commands

The action command is used to perform an action or retrieve information/status about the resource. Most SEP sesam CLI resources have the following action commands:

get
The get command retrieves information about the resource or the operation that is currently defined.
list
The list command returns a list of objects for the specified resource. If the optional <object_name_or_id> is also specified, then the results are filtered by that value.
add
The add command creates a new object or event. If the optional <object_name_or_id> is also specified, then the objects are created according to the specified value.
modify
The modify command changes an existing resource based on the specified object options.
remove
The remove command deletes the specified object.

Before you begin

SEP sesam CLI is a very powerful command-line tool. You should be aware of its implications on your entire environment before you start using it.

Recommendations for using the SEP sesam CLI

  • SEP sesam's optional command line commands are written directly to the SEP sesam database. Therefore all command line entries should be checked and verified!
  • SEP sesam executes the commands immediately the <Enter>/<Return> key is pressed, which means that entries cannot be corrected, as is the case with the SEP Sesam GUI. It is extremely important that you are familiar with CLI and use it cautiously in order not to cause a system failure of the backup environment. Note that an erroneous entry can lead to complete data loss or other damage to the database. Such mistakes can void the warranty of your SEP sesam licensing agreement.
  • Have a look at a CLI configuration example for the creation of a new SEP sesam environment by SEP sesam CLI. Only after becoming familiar with SEP sesam should you attempt to use the CLI and write your first scripts.
Information sign.png Note
Before you start scripting with the SEP sesam CLI, you should familiarize yourself with the SEP sesam environment. Read the SEP sesam documentation carefully and work on the SEP sesam installation to understand how the SEP sesam objects work together.

SEP sesam CLI usage

Command Alias Description Note
sm_cmd CLI main call Each command is preceded by sm_cmd that invokes the command line interface.
sm_cmd <get|list|add|modify|remove|send> account Create and administer email accounts.
sm_cmd <get|list|remove|check> acl Administer ACLs: Reset a user password and list, check or remove ACLs.
sm_cmd list allevent List all events
sm_cmd list allevent List all events
sm_cmd list allevent List all events
sm_cmd list allevent List all events
sm_cmd list allevent List all events
sm_cmd list allevent List all events
sm_cmd list allevent List all events
sm_cmd list allevent List all events

Administration commands

The following are the commands that allow you to execute the administrator’s tasks for SEP sesam.

(EMAIL) ACCOUNT (account)

Usage
sm_cmd <get|list|add|modify|remove|send> account [OPTIONS...] 
Description
By using action commandsget, list, add, modify, remove – you can get a single email account, list all email accounts depending on list options (listed in main help sm_cmd help), create a new email account, modify an existing account, and delete the specified account. Additionally, you can send a message to the given email account and attach multiple local files by using send mail [OPTIONS...] ID.

ACL

Usage
sm_cmd <get|list|remove|check> acl [OPTIONS...] 
Description
By using action commandsget, list, remove – you can get a single access control list (acl), list all ACL entries depending on list options (listed in main help sm_cmd help) or list all ACL entries of a given user and/or object, and delete the specified ACL (ID=all will delete all configured ACLs).

BACKUP

Usage
sm_cmd backup  [OPTIONS...]
Description
By using the backup command you can start or stop the task or task group backup according to the specified parameters.

CLEAR CACHE

Usage
sm_cmd clear cache [OPTIONS...]

or

sm_cmd clear cache -t
Description
By using the clear cache command you can clear the entire server cache according to the specified parameters; the '-t' parameter sets table filter for clear cache.

CALENDAR

Usage
sm_cmd <get|list|add|modify|remove> calendar [OPTIONS...] 
Description
By using action commandsget, list, add, modify, remove – you can get a single calendar, list all calendars depending on list options (listed in main help sm_cmd help), create a new calendar with an automatically generated ID, modify a calendar and delete a calendar; ID can be a character string ID or a numeric ID value.

CALENDAR EVENT (calendarevent)

Usage
sm_cmd <get|list|add|modify|remove> calendarevent [OPTIONS...] 
Description
By using action commandsget, list, add, modify, remove – you can get a single calendar event, list all calendar events depending on list options (listed in main help sm_cmd help), create a new calendar event, modify a calendar event and delete a calendar event.

CLIENT

Usage
sm_cmd <get|list|add|modify|remove|dir> client [OPTIONS...]
Description
By using action commandsget, list, add, modify, remove, dir – you can get a single client, list all clients depending on list options (listed in main help sm_cmd help), create a new client, modify a client, delete a client and browse directory of the client.

COMMAND

Usage
sm_cmd <get|list|add|modify|start|remove> command [OPTIONS...]
      
Description
By using action commandsget, list, add, modify, start, remove – you can get a single command, list all commands depending on list options (listed in main help sm_cmd help), create a new command, modify a command, execute a command and delete a command.

COMMAND EVENT (commandevent)

Usage
sm_cmd <get|list|add|modify|remove> commandevent [OPTIONS...]
Description
By using action commandsget, list, add, modify, remove – you can get a single command event, list all events depending on list options (listed in main help sm_cmd help), create a new command event with an automatically generated ID, modify a command event, and remove a command event.

CREDENTIAL

Usage
sm_cmd <get|list|add|modify|enable|disable|link|unlink|remove> credential [OPTIONS...]
Description
By using action commandsget, list, add, modify, enable, disable, link, unlink, remove – you can get an existing credential set by ID or name, list all credential sets depending on list options (listed in main help sm_cmd help), add a new credential set, modify an existing credential set by ID or name, and link/unlink a credential set to/from a SEP sesam object, i.e., data store. You can also delete a credential set by ID or name if there are no more references. In case of LDAP or AD credential sets, you can enable or disable a credential set by ID or name.

DATA STORE (datastore)

Usage
sm_cmd <get|list|add|modify|remove> datastore [OPTIONS...]
Description
By using action commandsget, list, add, modify, remove – you can get a single data store, list all data stores depending on list options (listed in main help sm_cmd help), create a new data store, modify a data store, and remove a data store with all dependencies.

DEFAULT KEY (default)

Usage
sm_cmd <get|list|add|modify|remove> default [OPTIONS...]
Description
By using action commandsget, list, add, modify, remove – you can get a value of the default key, list all default keys (listed in main help sm_cmd help), add a new default key and its value, modify a value of the default key, and delete a given default key.

DRIVE

Usage
sm_cmd <get|list|add|modify|remove|start|mount|dismount|unload> drive [OPTIONS...]
Description
By using action commandsget, list, add, modify, remove, start, mount, dismount, unload – you can get a single drive, list all drives (listed in main help sm_cmd help), create a new drive with an automatically generated ID, and modify, delete, configure and mount/dismount a drive. You can also release and eject the tape in the drive.

DRIVE GROUP (drivegroup)

Usage
sm_cmd <get|list|add|modify|remove> drivegroup [OPTIONS...]
Description
By using action commandsget, list, add, modify, remove – you can get a single drive group, list all drive groups (listed in main help sm_cmd help), create a new drive group, modify a drive group, and delete a drive group.

USER GROUP (group)

Usage
sm_cmd <get|list|add|modify|remove> group [OPTIONS...]
Description
By using action commandsget, list, add, modify, remove – you can get a single user group, list all user groups (listed in main help sm_cmd help), create a new user group, modify a user group, and delete a user group.

INTERFACE

Usage
sm_cmd <get|list|add|remove> interface [OPTIONS...]
Description
By using action commandsget, list, add, remove – you can get a single interface, list all interfaces (listed in main help sm_cmd help), create a new interface, and delete selected interface.

INVENTORY (start inventory)

Usage
sm_cmd start inventory [OPTIONS...]
Description
By using the start inventory command you can start archive adjustment to make a comparison between media in the loader carousel or magazine and the SEP sesam media archive database.

LICENSE

Usage

LOADER

Usage

LOADER DEVICE (loaderdevice)

Usage

LOCATION

Usage

MEDIA

Usage

Configuration commands

The following are the commands that allow you to configure SEP sesam environment.

Usage
sm_cmd <get|list|add|modify|remove|send> account [OPTIONS...] 
Description
By using action commandsget, list, add, modify, remove – you can get a single email account, list all email accounts depending on list options (listed in main help sm_cmd help), create a new email account, modify an existing account, and delete the specified account. Additionally, you can send a message to the given email account and attach multiple local files by using send mail [OPTIONS...] ID.

Monitoring commands

The following are the commands that display information about SEP sesam environment.

List all events (allevent)

Usage
sm_cmd list allevent [OPTIONS...]

or

sm_cmd list [LIST OPTIONS] allevent [FILTER OPTIONS...]

Description
By using the list command you can list all events or list all events depending on list options (listed in main help sm_cmd help) in a table format.

List all results (allresult)

Usage
sm_cmd list allresult [OPTIONS...]

or

sm_cmd list [LIST OPTIONS] allresult [FILTER OPTIONS...]
Description
By using the list command you can list all results or list all resultss depending on list options (listed in main help sm_cmd help).

CALENDAR SHEET (calendarsheet)

Usage
sm_cmd <download|show> calendarsheet [OPTIONS...]
Description
By using the show or download command you can show or download calendar information for the specified time frame.

CURRENT DRIVE (current)

Usage
sm_cmd <download|show> current [OPTIONS...]
Description
By using the show or download you can show or download the current drive information from the server.

DIR

Usage
sm_cmd dir <argument> [OPTIONS...]
Description
By using the dir you can list all configured clients, list all elements with task type Path for a client, list root directory of the client, list VMware content of the client, list all VMs, and list VMs of the vCenter.

LOG

Usage

Troubleshooting commands

The following are the commands that allow you to troubleshoot the SEP sesam environment.