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 sony - Attaches a Sony network-attached tape library through the DZC-8000S interface AVAILABILITY SUNWsamfs DESCRIPTION The SAM-QFS software package contains the Sun QFS and SAM- QFS interface to a Sony network-attached library. This interface uses the DZC-8000S 3.01 interface supplied by Sony. For more information on DZC-8000S, see the Sony PetaSite Application Interface DZC-8000S manual. This manual is supplied by Sony. CONFIGURATION It is assumed that the site has the PetaSite Controller (PSC) configured and operating with the Sony library. In the Execute Mode of the PSC configuration, the following must be set to on: o Thread With Load o Unthread with Fast Unload o Unthread with Eject o Wait for Drive Use The Equipment Identifier field in the Sun QFS or SAM-QFS mcf file must be the full path name to a Sony parameters file. For more information on specifying a parameters file, see the mcf(4) man page. The parameters file consists of a list of keyword = value pairs. All keyword and value specifications are case-sensitive and must be entered as shown on this man page. The keyword and value specifications are as follows: userid = userid Identifies the user during initialization of the Sony library functions. The userid values can be specified in hexadecimal or decimal. The valid range is from 0 to PSCUSERIDMAX(0xfff), which is 0 <= userid <= 65535 (decimal) or 0 <= userid <= 0xffff (hexadecimal). This is a required parameter. server = serverid Specifies the host name of the server running the PSC server code. This is a required parameter. sonydrive binnum = path [ shared ] Specifies characteristics of the tape drive. There must be one sonydrive line for every drive assigned to Sun QFS or SAM-QFS in the mcf file. This name must match the Equipment Identifier of an entry in the mcf file. The following arguments follow the sonydrive keyword: binnum Specifies the bin number assigned to the drive in the PSC configuration. The bin number can be identified using the PSC Monitoring and Maintenance terminal. This is a required argument. path Specifies the Solaris /dev/rmt/ path name to the device. The path must match the Equipment Identifier of an entry in the mcf file. This is a required argument. shared Specifies that this drive is shared with other processes. For example, this drive can be shared between multiple Sun QFS or SAM-QFS servers. This is an optional argument. EXAMPLE The following example shows the configuration files for a network-attached Sony library with Sony DTF tapes. Here are the sample entries in the mcf file. The catalog file is placed in the default directory, which is /var/opt/SUNWsamfs/catalog. The mcf file is as follows: # # This is the file: /etc/opt/SUNWsamfs/mcf # This file shows sample mcf entries for a Sony network-attached # robot with Sony DTF tapes. # /etc/opt/SUNWsamfs/sonyfile 50 pe sony50 on /var/opt/SUNWsamfs/sony50cat /dev/rmt/0cbn 51 so sony50 on /dev/rmt/1cbn 52 so sony50 on The parameters file for a Sony library supporting Sony DTF tapes is as follows: # # This is file: /etc/opt/SUNWsamfs/sonyfile # # The userid identifies the user during initialization of # the PetaSite library functions. Valid IDs are 0 to # PSCUSERIDMAX(0xfff). # userid = 65533 # # The server identifies the hostname for the server running # the DZC-8000S server code. # server = europa # # The sonydrive bin number 1001 is from the PSC configuration file # sonydrive 1001 = /dev/rmt/0cbn shared # a comment # # The sonydrive bin number 1002 is from the PSC configuration file # sonydrive 1002 = /dev/rmt/1cbn # a comment IMPORT/EXPORT The physical adding and removing of cartridges in a Sony network-attached library is accomplished using the PSC utilities. The import(1M) and export(1M) commands affect only the library catalog. Therefore, importing and exporting cartridges with the Sony network-attached library proceeds according to the following two-step process: 1. Physically import or export the cartridge using the PSC software. 2. Virtually update the library catalog using the Sun QFS or SAM-QFS import/export utilities. The import(1M) command has an optional -v option that allows you to specify the VSN to be added. The samsony package verifies that PSC knows about the VSN before updating the catalog with the new entry. The export(1M) command removes the entry from the catalog. CATALOG There are several methods for building a catalog for a Sony network-attached library. You should use the method that best suits your system configuration, typically depending on the size of the catalog that is needed. Method 1: Create a catalog with existing VSN entries. You can build a catalog that contains entries for many tapes by using the build_cat(1M) command. As input to the build_cat(1M) command, you need to create a file that contains the slot number, VSN, bar code label, and media type. For example, the file input_vsns follows: 0 "SEG001" "SEG001" so 1 "SEG002" "SEG002" so 2 TEST1 TEST1 so 3 TEST2 TEST2 so The input_vsns file can be used as input to the build_cat(1M) command as follows: build_cat input_vsns /var/opt/SUNWsamfs/sony50cat Method 2: Create a null catalog and import VSN entries. You can create an empty catalog and populate it. To create a catalog that will accommodate 1000 slots, use the build_cat(1M) command as follows: build_cat -s 1000 /dev/null /var/opt/SUNWsamfs/catalog/sony50cat Use the import(1M) command to add VSNs to this catalog, as follows: import -v "SEG005" 50 Method 3: Use the default catalog and import VSN entries. If a catalog path name is not specified in the mcf file, a default catalog is created in /var/opt/SUNWsamfs/catalog/family_set_name when Sun QFS or SAM-QFS is initialized. Following initialization, you must import VSN entries to this catalog by using the import command as follows: import -v "SEG005" 50 In the previous import(1M) command, 50 is the Equipment number of the library as specified in the mcf file. FILES mcf The configuration file for the Sun QFS and SAM-QFS software. /opt/SUNWsamfs/lib/libpsc.so The PSC library supplied by Sony. /opt/SUNWsamfs/sbin/sony_helper A program to issue commands to the Sony PSC. SEE ALSO build_cat(1M), dump_cat(1M), export(1M), import(1M), sam- robotsd(1M). mcf(4).