Skip Navigation Links | |
Exit Print View | |
Sun QFS and Sun Storage Archive Manager 5.3 Reference Manual Sun QFS and Sun Storage Archive Manager 5.3 Information Library |
1. User Commands (Man Pages Section 1)
2. Maintenance Commands (Man Pages Section 1M)
3. Library Functions (Man Pages Section 3)
4. Library Functions (Man Pages Section 3X)
5. File Formats (Man Pages Section 4)
NAME stk - The StorageTek interface through ACSAPI AVAILABILITY SUNWsamfs DESCRIPTION stk is the Sun QFS and SAM-QFS interface to the StorageTek libraries. This interface utilizes the ACSAPI interface supplied by StorageTek. The SAM-QFS software package installs the libraries and daemons for the client side of the API. For more information on ACSAPI and interfacing the StorageTek libraries, see the documentation supplied with the StorageTek hardware and server side daemons. CONFIGURATION It is assumed that the site has the server daemons (CSI and ACSLM) configured and operating with the StorageTek library. The Equipment Identifier field in the mcf file, (see mcf(4)), is the full path name to a parameters file used by stk. This file consists of keyword = value and path_name = value pairs. All keyword, path_name, and value entries are case-sensitive. The keywords are: access This is the user_id used by this client for access control. If this parameter is not supplied, the access control string will be a null string (no user_id). hostname This is the hostname for the server that is running ACSLS. If the hostname is not supplied, the default will be localhost. All sites should set this value. ssihost This is the name used for the SAM-QFS server when a multihomed SAM-QFS server is used. The ssihost would be the name of the SAM-QFS server on the lan connecting to the ACSLS host. Only sites where a multihomed SAM-QFS server is used need to supply an ssihost value. The default will be localhost. portnum This is the portnum for SSI services on the server that is running ACSLS. If the port number is not supplied, the default is 50004. Please note that if you are running co-hosted ACSLS 5.3 or higher, the default value does not work (try a higher port number, like 50014). If you are running multiple connections to ACSLS servers, then the port number for each stk configuration file needs to be unique (for example, 50014 in one, 50015 in the next, etc.). ssi_inet_port This is the fixed port number for incoming responses and specifies the port the SSI will use for incoming ACSLS responses in a firewall environment. Valid values are 1024 - 65535, and 0. Setting this environmental variable to a non-zero value makes the SSI use this port for incoming ACSLS responses. This means that the firewall needs to allow incoming requests on that port in order for the ACSLS responses to be received by the SSI. Setting this value to zero or leaving it unset indicates that the previous behavior of allowing the port to be dynami- cally allocated will remain in effect. csi_hostport This firewall environmental variable specifies the port to which the SSI will send its ACSLS requests on the ACSLS server. Setting this variable eliminate queries to the portmapper on the ACSLS server and instead, sends requests to this port on the ACSLS server. Valid values are 1024 - 65535, and 0. Set- ting this variable to zero or leaving it unset indi- cates that the previous behavior of querying the portmapper on the ACSLS server will continue to be used. capid This specifies the CAP (Cartridge Access Port) to be used for exporting of volumes when the -f option is used with export command. Following the capid is the description of this CAP in terms of the StorageTek library. This description starts with an open parenthesis followed by 3 keyword = value pairs followed by a close parenthesis. The keyword = value pairs between the parentheses may be separated by a comma (,), a colon (:) or by white space. acs is the ACS number for this CAP as configured in the StorageTek library. lsm is the LSM number for this CAP as configured in the StorageTek library. cap is the CAP number for this CAP as configured in the StorageTek library. capacity This is used to set the capacity of the media supported by the StorageTek. The parameter to capacity is a comma separated list of index = value pairs enclosed in parentheses. index is the index into the media_type file (supplied by StorageTek and located on the ACS system) and value is the capacity of that media type in units of 1024 bytes. You should only need to supply this entry if the ACS is not returning the correct media type or new media types have been added. Sun QFS and SAM-QFS have defaults for index values that were current at the time of release. Generally, it is necessary to supply an index only for new cartridge types. For the capacity of each cartridge type, see the SAM-QFS Storage and Archive Management Guide. device_path_name There is one device_path_name entry for every drive attached to this client. The device_path_name is the path to the device on the client. This name must match the Equipment Identifier of an entry in the mcf file. Following the device_path_name is the description of this drive in terms of the StorageTek library. This description starts with an open parenthesis followed by 4 keyword = value pairs followed by a close parenthesis. The keyword = value pairs between the parentheses may be separated by a comma (,), a colon (:) or by white space. Following the close parenthesis is an optional keyword used by Sun QFS and SAM-QFS software to designate when a drive is shared with other Sun QFS and SAM-QFS servers. The keyword identifiers and their meanings are as follows: acs is the ACS number for this drive as configured in the StorageTek library. lsm is the LSM number for this drive as configured in the StorageTek library. panel is the PANEL number for this drive as configured in the StorageTek library. drive is the DRIVE number for this drive as configured in the StorageTek library. shared The shared keyword follows the close parenthesis. This keyword is optional and is used to indicate the drive is shared with other Sun QFS and SAM-QFS servers. EXAMPLE Here is a sample parameters file and mcf entries for a StorageTek library: # # This is file: /etc/opt/SUNWsamfs/stk50 # hostname = acsls_server_name portnum = 50004 ssi_inet_port = 0 csi_hostport = 0 access = some_user # No white space allowed in the user_id field capid = (acs=0, lsm=1, cap=0) /dev/rmt/0cbn = (acs=0, lsm=1, panel=0, drive=1) #a comment /dev/rmt/1cbn = (acs=0, lsm=1, panel=0, drive=2) shared #a comment capacity = (0=215040, 1=819200, 5=10485760) The mcf file entries that reference this configuration file are: # # Sample mcf file entries for a StorageTek library # /etc/opt/SUNWsamfs/stk50 50 sk sk50 - /var/opt/SUNWsamfs/catalog/sk50 /dev/rmt/0cbn 51 st sk50 - /dev/rmt/1cbn 52 st sk50 - IMPORT/EXPORT Since the physical adding and removing of cartridges in the StorageTek library is done with ACSLM utilities, the import/export commands and GUI buttons will only affect the library catalog. The import command has optional parameters for supplying a single volume to be added or to add a number of volumes from a pool (see import(1M)). export (see export(1M)) will remove an entry from the catalog. CATALOG The Sun QFS and SAM-QFS systems automatically build a library catalog for a StorageTek automated library. How- ever, you must populate the library catalog. For informa- tion on populating the library catalog, see the SAM-QFS Storage and Archive Management Guide. FILES mcf The configuration file for the Sun QFS and SAM-QFS software. /etc/opt/SUNWsamfs/scripts/ssi.sh A shell script used to start ssi_so. /opt/SUNWsamfs/sbin/ssi_so A shared object version of the SSI daemon supplied by StorageTek. /opt/SUNWsamfs/lib/stk/* The libraries needed by the API interface supplied by StorageTek. /opt/SUNWsamfs/sbin/stk_helper A program to issue commands for the StorageTek ACSAPI SEE ALSO build_cat(1M), dump_cat(1M), export(1M), import(1M), sam- robotsd(1M). mcf(4). ssi_so(7). SAM-QFS Configuration and Administration Guide.