Ibm RELEASE 7.3 Manual do Utilizador

HPSS Management GuideHigh Performance Storage SystemRelease 7.3November 2009 (Revision 1.0) HPSS Management Guide November 2009Release 7.3 (Revision

13.1. Managing HPSS Users...32513.1.1. Add

5.1.4. Log Client Specific ConfigurationThis window controls the local log settings that will be in effect for the node on which this Log Client runs

Related Information Section 9.5: Managing Local Logging on page 301.5.1.1. Log Daemon Specific ConfigurationThis window controls configuration of the

Field DescriptionsStorage Class Update Interval (seconds). The interval that indicates how often the MPS will query the Core Server in its subsystem t

and usage. The trade-off for this value is that large buffer sizes will use more system memory and may be inefficient for small transfers (e.g., if th

Range End. If this field is zero, Port Range End field must also be zero.Port Range End. Used in conjunction with Port Range Start (See above). Valid

This will cause inetd to run the executable /opt/hpss/bin/hpss_mvr_tcp under the root user ID when a connection is detected on port 5002. The Mover pr

/etc/xinetd.d file. For example, if the encryption key in the Mover’s type specific configuration is 1234567890ABCDEF, then the encryption key file (/

Table 1. IRIX System ParametersParameter Name Minimum Value Parameter Descriptionsemmsl 512 Maximum number of semaphores per setmaxdmasz 513 Maximum

Table 3. Linux System ParametersParameter NameMinimum Value Parameter DescriptionSEMMSL 512 Maximum number of semaphores per IDSHMMAX 0x2000000 Maxim

to all nodes or unexpected results may occur.• The Mover must be built with the LFT option. This is the default option for all Movers. If not all Move

15.1.2. Overview of the DB2 Backup Process...35715.1.2.1.

Specific Configuration Window on page 120, Section 5.1.1.1: 3494 PVR Specific Configuration on page 111, Section 5.1.1.2: AML PVR Specific Configurati

5.1.1.1. 3494 PVR Specific Configuration5.1.1.1.1. 3494 PVR Specific Configuration WindowField DescriptionsCartridge Capacity. The total number of c

only if the Support Shelf Tape checkbox is selected. The alarm value must be 2 or greater.Dismount Delay. When Defer Dismounts is checked, this value

named /dev/lmcp0 and /dev/lmcp1 respectively. Control connections must be made prior to configuration of the /dev/lmcpX devices or undefined errors ma

Weight 2 * Cartridges from other jobs mounted on this drive’s controller + Weight 3 * Units of distance from the cartridge to the dri

requesting client to the AML’s storage positions, drives, and Insert/Eject units. Access configurations for clients are set in the configuration file

1. Make sure the AMU archive management software is running and the hostname is resolved,2. Select an OS/2 window from the Desktop and change the dire

Score = Weight 1 * Cartridges from this job mounted on this drive’s controller + Weight 2 * Cartridges from other jobs mounted on this

• Support Shelf Tape. If ON, the PVR and the PVL will support the removal of cartridges from the tape library using the shelf_tape utility.Command Dev

Score = Weight 1 * Cartridges from this job mounted on this drive’s controller + Weight 2 * Cartridges from other jobs mounted on this

List of TablesTable 1. SSM General Options...

• Enforce Home Location. If ON, the SCSI PVR will always try to dismount a mounted cart back to its home location. Otherwise, it will just use the f

requested shelf tape has been checked-in. The PVR will continue checking at this interval until the tape is checked-in. This field applies only if the

HPSS will use any Cartridge Access Port (CAP) in the STK Robot that has a priority greater than zero. When it needs a CAP, HPSS will pick the highest

Would you like Multi-Host or Single-Host testing? Enter one of the following followed by ENTER: M Multi-host testing S Single-host testing

server are removed from the HPSS configuration.The steps described in this section are general guidelines. Specific procedures should be worked out

pressing the Delete button.5.1. Monitoring Server InformationA server that is running and connected to SSM will allow the SSM user to view and update

• Busy - The server is busy performing its function. Most servers do not update Usage State dynamically, so it is unlikely you will see this value re

Communication Status: Normal However, when the server is experiencing errors or encountering abnormal conditions, it will change the appropriate state

Global Database Name. The name of the global database for the HPSS system.Subsystem Database Name. The name of the database which contains the subsyst

• File Deletes. The number of bitfile delete requests processed in the Core Server since startup or last reset of the statistics.• Last Reset Time. Th

PrefaceWho Should Read This BookThe HPSS Management Guide is intended as a resource for HPSS administrators. For those performing the initial configur

• Free Tape Bytes. This is an estimate based on the sum of the estimated sizes of the partially written and unwritten tape volumes. It is not, and c

must be greater than zero and is used if the Gatekeeping Site Interface returns a wait time of zero for the create, open, or stage request being retri

Server when the Gatekeeper is monitoring Requests and a client disconnects.• Get Monitor Types. Statistics from the gk_GetMonitorTypes API. This API

Minimum Location Map Update Time. The shortest time, in seconds, needed for a location map update.Average Location Map Update Time. The average time,

changes made to fields on this window are sent directly to the Mover after the appropriate button is pressed and are effective immediately.Field Descr

This window allows you to view the type-specific information associated with a PVL.Field DescriptionsServer Name. The descriptive name of the PVL.Tota

Characteristics. Flags for the PVR:• Defer Dismounts. If ON, the PVL will delay the dismounting of a tape cartridge until the drive is required by an

heavily used controller, then a more distant drive will be selected.Retry Mount Time Limit. The default value for this field is -1. When the default v

5.1.1.2.1. AML PVR Information WindowField DescriptionsServer Name. The descriptive name of the PVR.Total Cartridges. The number of cartridges curren

the number of consecutive mount errors which occur to any drive in this PVR equal or exceed this value, the drive is automatically locked by the PVL.

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 14

alarm. Same Job on Controller, Other Job on Controller, & Distance To Drive. These values are used by the PVR when selecting a drive for a tape mo

Shelf Tape Check-In Retry. The number of seconds the PVR will wait before asking the robot if a requested shelf tape has been checked-in. The PVR will

the best performance. It also will try to pick controllers that are currently driving a minimum number of tapes. So, in an environment with many tape

5.1.1.2.1. STK PVR Information WindowField DescriptionsServer Name. The descriptive name of the PVR.Total Cartridges. The number of cartridges curren

Server to set the VV Condition of the associated tape volume to DOWN. Once in DOWN state, the volume will no longer be available for read or write ope

HPSS administrators and operators may use SSM to view the active RTM requests. The RTM Summary window lists a summary of the current RTM wrequests. Th

5.1.2. RTM DetailThe RTM Detail window displays a snapshot of the details of the selected RTM requests from the RTM Summary List window. This may con

ReqId. The RTM request identifier.ReqCode. The action or operation that this request is currently executing. Examples include "Mover write",

PVLJobId. The ID of the PVL job associated with this request.MvrId. The ID of the Mover this request is currently waiting on.DeviceId. The Device this

GroupId. The Group ID of the user associated with this request.HostAddr. The address of the originating hostRequestType. The type of this request (Ope

Chapter 1. HPSS 7.1 Configuration Overview1.1. IntroductionThis chapter defines the high-level steps necessary to configure, start, and verify corr

To start the Startup Daemon, use the “-d” option to rc.hpss:% su -% /opt/hpss/bin/rc.hpss -d [start]5.2.2.2. Starting SSMThe SSM System Manager confi

To start a server, select the desired server(s) from the Servers window and click on the Start button. Verify the result of the request in the message

window for the “Server Terminated” event.The HPSS Startup Daemon(s) and the SSM System Manager cannot be shut down from the Servers window. Select S

command line sessions, will detect that the System Manager has exited. Choosing this option will pop up a confirmation window which allows the shutdow

button. Verify the result of the request in the status bar on the Servers window. In addition, monitor the Alarms and Events window for the “Server Re

Core ServerResets the COS Copy to Disk, COS Change Retry Limit, Tape Dismount Delay, Tape Handoff Delay, PVL Max Connection Wait, Fragment Trim Limit

Servers that do not support reinitialization, or those that do not support reinitializing the settings in question, must be restarted in order for con

Chapter 6. Storage ConfigurationThis chapter describes the procedures for creating, modifying, and deleting storage classes, hierarchies, classes of

Information Buttons. Migration Policy. Opens the configuration window for the migration policy that is configured for the selected storage class. This

This window is used to manage disk storage class configurations.Field DescriptionsStorage Class ID. The numeric identifier assigned to the storage cla

listed. Each step is required unless otherwise indicated. Each step is discussed in more detail in the referenced section.1. Configure storage subsy

Advice - Do not configure a migration policy for a storage class at the lowest level in a hierarchy. If a migration policy is added to a storage class

VVs, fragmentation of the volumes may make it difficult to find space for a new segment. Setting Average Number of Storage Segments to a larger value

Min Storage Segment Size (MINSEG). The lower bound for storage segment sizes created on volumes in this storage class. This value is the product of th

This window is used to manage tape storage class configurations.Field DescriptionsStorage Class ID. The numeric identifier assigned to the storage cla

If a migration policy is added to a storage class after files are created in the storage class, those files may never be migrated. Use the mkmprec uti

movement protocol overhead and helps to keep the data streams flowing smoothly.VV Block Size must meet the following constraining requirements:• It mu

If the tape media supports "fast locate", and that feature is enabled for the tape devices, choose larger values of Seconds Between Tape Mar

This window is used to define Warning and Critical thresholds unique to a particular storage subsystem, overriding the values defined in the disk stor

Subsys Name. The name of the selected storage subsystem.Warning. The current warning threshold value for the selected subsystem. If the storage class

Warning volumes, Critical volumes or both for one or more of the listed subsystems. Select a subsystem from the list and then modify the values on the

B. Create storage resources (Section 8.1.2: Creating Storage Resources on page 234)4. Create additional HPSS Users (Section 13.1.1: Adding HPSS Users

the administrator to reflect desired behavior.If files have been stored in a storage class without a migration policy, and a migration policy is subse

accessed from the HPSS Health and Status window's Configure menu, submenu Storage Space, item Heirarchies. Refer to Section 3.9.3: HPSS Health a

Configuration ButtonsCreate New. Open a Storage Hierarchy window with default values.Configure. Open the selected storage hierarchy configuration fo

Field DescriptionsHierarchy ID. The ID associated with this hierarchy . Any unique, positive 32-bit integer value. The default value is the last confi

do this will render the files unreadable. It is recommended that HPSS Customer Support be called to assist with this operation.6.3. Classes of Servic

Create New. Open a Class of Service window containing default values for a new class of service.Configure. Open the selected class(es) of service co

is On Open. For all subsequently created COSes, the default value is the same as the most recent COS configured.Advice – Changing the Stage Code sho

• Auto Stage Retry. When this flag is turned on, and a valid secondary copy of the data exists, and a stage from the primary copy fails, HPSS will au

users do frequent appends, or if those who do can be relied upon to turn truncation off for their own files, or if the system administrator can easily

have a significant impact. Turning the flag on constrains files that are already larger than the Maximum File Size to their current size. Existing sm

• Verify that a Core Server and Migration Purge Server have been configured for each storage subsystem.• Verify that each storage subsystem is accessi

6.3.5. Changing a File's Class of ServiceThe Core Server provides a means to change the class of service of a file. The Core Server moves the bo

Both basic and subsystem specific migration policies are created and managed using the Migration Policies window. The basic policy must be created bef

Other Migration Policy List columns. The remaining columns provide the same information that can be found in Section 6.4.2.1: Disk Migration Policy Co

This window allows an administrator to manage disk migration policies and their subsystem-specific overrides.Subsystem-specific policies define migrat

Last Update Interval. The number of minutes that must pass since a file was last updated before it can become a candidate for migration.Number of Migr

storage class.Triggered Migration Options. There are four choices for managing migration behavior when a storage class is running out of space and the

This window allows an administrator to manage tape migration policies and their subsystem-specific overrides.Subsystem-specific policies define migrat

migration criteria. This goal may not be attainable if the total size of all files not eligible for migration is large.Total Migration Streams. This v

based on individual files rather than tape volumes, and is able to make second copies of files stored on tape. In this algorithm, individual files are

To delete a migration policy, select the policy from the Migration Policies list window and press the Delete button. If a basic policy is selected, an

chosen if specified by their COS ID.• Verify that classes of service with multiple copies have the Retry Stage Failures from Secondary Copy flag enabl

Policy button after the window refreshes, enter the specific purge policy parameters, and press the Update button. This process can be repeated for ea

This window allows you to manage a Purge Policy. Purge policies are assigned to storage classes to tell the Migration Purge Server and Core Server how

unaccessed (for read or write) for the length of time specified by this field.Start purge when space used exceeds. Purge will begin for a storage clas

policy are applied to all storage classes which reference the policy. If the policy is reread, the changes are only applied to the storage class and s

Field DescriptionsThe fields of the columns of this window are those of the File Family Configuration described in Section 6.6.1: File Family Configur

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 195

Chapter 7. Device and Drive Management Every disk and tape drive that is used by HPSS is controlled by two servers. The PVL controls mounts and dism

may result in a large performance degradation. For SAN disk devices, the hpss_san3p_part utility with the -i option and device name must be run to as

These windows allow you to manage a tape or disk device/drive configuration.Modifying/Updating the device/drive configuration via the Tape Device Conf

For IRIX systems, SCSI attached tape drives are typically referred to by pathnames of the form /dev/rmt/tpsXdYns, where X is the SCSI controller numbe

© Copyright (C) 1992, 2009 International Business Machines Corporation, The Regents of the University of California, Los Alamos National Securit

• Monitor free space from the top level storage class in each hierarchy to verify that the migration and purge policy are maintaining adequate free sp

Advice - This option is supported for 3590, 3590E, 3580, 3592, 9840, 9940, DST-312, DST-314, T10000 and GY-8240 devices.• NO-DELAY Support (tape only)

device. Without the reservation, it is possible for other hosts to interleave SCSI commands to the drive with those issued by HPSS. This effect could

must be a valid ID. The valid IDs can be found in the Affinity list for any cartridge in the robot. Use the command “mtlib -l <device name> -qV

This window allows you to view the list of configured Mover devices and PVL drives. It also provides a number of function buttons, which allow certain

• Disabled - The device is locked, which makes it unavailable for use by HPSS.• Unknown - The state of the device is not known to SSM; this is usually

• Unknown - The state of the drive is not known to SSM; this is usually caused by the PVL being down or disconnected from SSMComment. This field prov

Drive Administration ButtonsThis group of buttons affects selected drives. All the buttons are disabled unless one or more drives are selected (see fi

window in Add mode, allowing you to create a new disk device and drive.Create Tape. This button is always active. Clicking on it opens the Tape Device

Some PVL drive configuration attributes can be updated dynamically using the PVL Drive Information window (Section 7.2.2: PVL Drive Information Window

There are a number of situations in which the PVL won't allow the device/drive to be deleted:• If the device/drive is still attempting to notify

Chapter 2. Security and System Access2.1. Security ServicesAs of release 6.2, HPSS no longer uses DCE security services. The new approach to secur

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 210

The Mover Device Information window reports the current statistics for the device, such as the workload history of the device since the startup of the

means that the corresponding flag is set.• Read Enabled. An indication of whether the device is available for reading.• Write Enabled. An indication o

• Multiple Mover Tasks (disk only). If ON, the Mover will allow multiple Mover tasks to access the disk device.• Reserve/Release (tape only). An indic

7.2.2. PVL Drive Information WindowHPSS Management Guide November 2009Release 7.3 (Revision 1.0) 214

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 215

This window allows you to view/update the information associated with an HPSS drive. The PVL Drive Information window is typically used to lock and u

PVR (tape only). The descriptive name of the PVR used to control this drive. This field is only meaningful for tape drives.Administrative State. This

• PVR/Mover Notify Pending - The PVL needs to notify the associated PVR and Mover that the drive has been created or deleted.• PVR Notify Pending - Th

and thus availability. To do this, the HPSS administrator will need to:• Associate tape drives to a specific drive pool by configuring the HPSS tape d

This can be "unix" or "ldap".· <authzURL> - a string used by the authorization mechanism to locate the security data for thi

7.4. Changing Device and Drive StateThe administrative state of a device or drive can be set to Unlocked or Locked. This controls whether HPSS can ac

Locking a disk drive has little effect since disks are logically mounted when the PVL initializes and are not usually unmounted; however, a disk drive

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 222

Chapter 8. Volume and Storage ManagementThis chapter describes the procedures for adding, removing, monitoring, and managing storage space in the HP

/var/hpss/etc/AML_EjectPort.conf and /var/hpss/etc/AML_InsertPort.conf. The AML robot can have multiple insert and eject ports, which have the capabil

information contained in the internal label will not match the side information passed to PVL in the Import request. If the start of the OwnerID field

This window allows the user to import tape volumes into the HPSS system, making them known to the PVL server. To make them known to the Core Server so

a successful import and goes on to the next volume in the list. This makes it easy to restart a partially completed import (after fixing the cause of

“AB5329”“AB7329”The filling will not occur and an error will be displayed if the specified values would generate an invalid volume label (e.g., one gr

the end of the Volume list. If Fill Count is greater than 1, multiple labels are generated using the entered label as a starting point.Maximum Volumes

2.1.2.3. LDAPLDAP authorization is not supported by IBM Service Agreements. The following information is provided for sites planning to use LDAP au

An ANSI (non-UniTree) or HPSS label with a correct Volume ID (the Volume ID on the label is as expected by HPSS)Tape Imported Label Written,Tape Impor

This window allows the user to import disk volumes into the HPSS system, making them known to the PVL and PVR servers. To make them known to the Core

List.To automatically generate a list of volume names in the Volume List, set the Fill Count to the desired number of volumes. Set the Fill Increment

Based on the Import Type, the import request will be processed depending on how the media is currently labeled. See Section 8.1.1.4: Selecting Import

again. You may dismiss the window before completion; however, completion messages will be displayed in a pop-up window. At this point you can begin en

are copied to the volumes' metadata and become a permanent part of the definition of the volumes.The Core Server creates the necessary metadata s

List.To automatically generate a list of volume names in the Volume List, set the Fill Count to the desired number of volumes. Set the Fill Increment

Server.VVs To Create. The number of virtual volumes to be created. This value determines the number of rows in the Volume List table at the bottom of

This window is used to create disk storage resources, disk virtual volumes, in a Core Server. The disks must first be imported to the appropriate PVL.

"AA0080""AA0090""AA0100""AA0110""AA0120"When an addition produces overflow in a column, numerical co

To create a new group, use the following command at the hpss_ldap_admin prompt:group create -gid <gid> -name <name> [-uuid <uuid>]If

available. The default value is 1. If the list fills before the Fill Count is exhausted, filling stops and a message is displayed.Fill Increment. This

reuse the volumes, create new storage resources on them using the Create Resources window. To remove them entirely from the HPSS system, export them f

Volume List at the bottom of the window.Any of the three entry methods may be repeated multiple times on the same window to add additional volumes to

the file in the File Containing Volume List field. The volume names from the file will be added to the Volume List.Field DescriptionsFile Containing V

8.2.2.1. Rules for Exporting VolumesTape cartridges may be physically exported from any managing robotic library. To export a tape cartridge from HPS

This window allows you to export tape and disk volumes from the HPSS system. Exporting a volume is equivalent to telling HPSS that the volume no longe

Fill Count = 6Fill Increment = 10Volume Label = "AA0070"Labels automatically inserted into Volume List:"AA0070""AA0080"&

Field DescriptionsEject Tapes After Exporting. If this checkbox is selected, the exported tape volumes will also be ejected from the PVR.File Containi

available to the storage class. The migration and purge policies may need to be modified to free up more space or to free up the space more frequently

To select a row, click on it with the mouse; the selection will be highlighted. Note that when you select a row, you are selecting a storage class wit

obtained from the foreign site's administrator. An example would be: "ldap://theirldapserver.foreign.com/cn=FOREIGNREALM.FOREIGN.COM"•

appropriate when the MPS is recycled. Possible values are:• Waiting - Migration is not taking place at this time. The start of the next migration is w

• Suspend - If the purge state is Waiting or Running, this puts the purge into the Suspended state.• Resume - If the purge state is Suspended, this re

This window allows you to view and update the information associated with an active disk storage class. It reports the storage space data as well as a

Field DescriptionsStorage Class Name. The name assigned to this storage class.Storage Class ID. The numeric ID of this storage class.Storage Class Typ

alarm to SSM.Critical Threshold. For disk storage classes, this value is a percentage of total storage space. When the used space in this storage clas

Suspended state.• Resume - If the migration state is Suspended, this returns it to Waiting and allows MPS to again begin scheduling migration runs.• R

8.3.3. MPS Tape Storage Class InformationThis window allows you to view and update the information associated with an active tape storage class. It r

Field DescriptionsStorage Class Name. The name assigned to this storage class.Storage Class ID. The numeric ID of this storage class.Storage Class Typ

administrator.Start Time. The date and time when the most recent migration run started. It may still be running.End Time. The date and time when the l

Core Server metadata that describes the volumes. See Section 8.4.3, Repacking and Reclaiming Volumes.8.4.1. Forcing MigrationThe Migration Purge Serv

rw---dt user ${HPSS_PRINCIPAL_PVR}rw-c-dt user ${HPSS_PRINCIPAL_SSM}------t any_otherPVR:rw---dt user ${HPSS_PRINCIPAL_PVL}rw-c--t user ${HPSS_PRINCIP

Repack selects tape volumes in one of two ways. The administrator can provide a list of tape volumes to repack, or repack can select volumes based on

This window provides an interface for repacking tape virtual volumes.Field DescriptionsStorage Class Name. The name of the storage class that will be

which a large percentage of the files have been deleted, may be selected by repack.If VV Space is 100, the comparison is not performed and selection o

ButtonsReclaim. Press this button to start the reclaim utility program on the indicated storage class. Tape volumes that are described as EMPTY, and a

imported.CS Volume. Once you have filled in both fields, clicking on this button will open the Core Server Disk Volume or Core Server Tape Volume wind

• Unallocated. The volume has been successfully imported into the HPSS system and labeled. However, no storage resources have been created on it and i

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 266

This window allows you to view and update the information associated with an HPSS tape cartridge.Note that the Location Type fields are represented di

note that this can also mean that side 0 of the cartridge is mounted.PVR Server. The descriptive name of the PVR which manages the cartridge.• Cartrid

• Port - The location is a port number. [This option is currently not used.]• Drive - The location is a drive ID number.• Slot - The location is a slo

2.4.1. Configuring/Updating a Location PolicyThe Location Policy can be created and updated using the Location Policy window. If the Location Policy

This window displays information about a disk volume as represented by the Core Server.Field DescriptionsName. The ASCII name of the first physical vo

volume.• In DOWN condition, the volume cannot be read, written or mounted. This condition can be used to make a disk unavailable to the system.Change

Less Commonly Used Data TabActual Length. The length of disk virtual volume in bytes. This length includes all of the space set aside for system use.

Physical VolumesThis is a table of physical volume attributes for the physical volumes that make up this disk virtual volume.Vol Name. The ASCII name

This window displays information about a tape volume as represented by the Core Server.Field DescriptionsName. The ASCII name of the first physical vo

• In RWC condition, the volume can be read and written. This is the normal operational state.• In RW condition, the volume can be read and written, bu

its data. When data is being written to a volume, it will be shown in Allocated state. When the End Of Media marker is reached during a tape write ope

of time may pass between updates.Next Write Address. The next address that will be written on the tape volume, expressed as an HPSS Relative Stripe Ad

VV Block Size. The virtual volume block size. This is the number of bytes written from a data stream to an element of the striped volume before the st

VV Condition controls the availability of the volume for the following actions:• Creation of new storage segments• Reading of existing storage segment

Maximum Request Threads. The maximum number of concurrent client requests allowed.Advice - If the Location Server is reporting heavy loads, increase t

can be read, but not written. Unlike RO condition, tapes in EOM condition can only be changed to DOWN. EOM volumes cannot enter either RWC or RO condi

This window allows you to change which PVR owns a set of cartridges. Before initiating the request from the SSM window, the cartridges must already be

Fill Increment = 10Volume Label = "AA0070"Labels automatically inserted into Volume List:"AA0070""AA0080""AA0090&qu

Fill Count. The number of cartridge labels to be added to the end of the list when the Volume Label field is next modified. This number may be one or

8.6.1. PVL Job Queue Window This window shows all outstanding jobs in the PVL. From this window, the user can issue a request to view more informatio

• Relabel - A cartridge being relabeled.• Sync Mount - A synchronous mount.• Tape Check-In - A cartridge being added to the library.• Tape Check-Out -

8.6.2. PVL Request Information WindowThis window is displayed when the Job Info button is pressed on the PVL Job Queue window. It allows you to view

• Aborting - The job is being aborted.• Cartridge Wait - The job is waiting for another job to release a cartridge that it needs.• Completed - The job

• Tape Check-In• Tape Check-Out• Uncommitted• Unload PendingDrive Pool ID. If non-zero the drive pool id will restrict this drive's scheduling to

will begin logging alarms indicating that the appropriate tape has yet to be checked-in. The frequency of these alarms is controlled by the Shelf Tape

1. Add the HPSS_RESTRICTED_USER_FILE environment variable to /var/hpss/etc/env.conf. Set the value of this variable to the name of the file that will

The Tape Mount Requests window displays tapes which need to be mounted in a drive. All HPSS tape mount requests, including both robotic and operator t

Clear List. Clears the list of mount requests. Note that this does not cancel any mount requests, but just removes them from the list. Pending mounts

refresh their caches.3. Use the retire utility program to retire the old technology volumes. retire can accept a list of PVs to retire, or can retire

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 293

Chapter 9. Logging and Status9.1. Logging OverviewThe purpose of logging is to record events of interest that occur in HPSS in the sequence they o

5. The SSM Alarms and Events window (Section 5.2.2.3: on page 151)A standard configuration for logging services is usually set by the administrator d

• If no server-specific logging policy is configured for a server and no default logging policy is configured, only Alarm and Event messages will be l

Delete. Deletes the selected log policy(s).9.2.2.1. Logging Policy Configuration WindowThe Logging Policy window is used to manage a log policy. Whe

recommended that this always be selected.• EVENT. An informational message (e.g., subsystem initializing, subsystem terminating) about a significant

A server’s log policy can be modified to control the volume of messages to the chosen logging destinations. Typically, during normal operations, the l

Table of ContentsChapter 1. HPSS 7.1 Configuration Overview...151.1

Field DescriptionsRestricted Users listThis is the main portion of the window which displays various information about each restricted user.User Name.

9.3.2. Viewing the Central Log (Delogging)HPSS provides the ability to retrieve and examine HPSS log records as a means of analyzing the activity and

The information is acquired from the HPSS Log Daemon.The Log Files Information window provides information about the HPSS central log files. Log file

9.5.1. Configuring Local Logging OptionsThe “Log Messages To:” field in the Logging Client specific configuration window (Section 5.1.4: LogClient Sp

This window displays a number of the most recent alarm and event messages which have been received by SSM. It also allows you to view individual messa

This window displays all the details of the alarm or event selected from the Alarms and Events window.Field DescriptionsID. A sequence number assigne

• Critical• Indeterminate• ClearedThese may be accompanied by a color status indicator: • (Red) - Critical or Major alarm• (Yellow) - Minor or

environment variable HPSS_SSM_ALARMS with the desired name of the cache file. The default for HPSS_SSM_ALARMS is defined in hpss_env_defs.h as NULL.

could be used, for example, to reduce the size of each data request on a slow network.The internal cached Alarm and Event list is displayed by the hps

Chapter 10. Filesets and JunctionsA fileset is a logical collection of files that can be managed as a single administrative unit, or more simply, a

File Family. The name of the file family to which the fileset is assigned. If this field contains "Not in a family", the fileset has not bee

Chapter 3. Using SSM3.1. The SSM System Manager3.1.1. Starting the SSM System ManagerBefore starting the SSM System Manager (SM), review the SM ke

10.2. Creating an HPSS FilesetThis section provides information on how to create HPSS filesets. Only the HPSS root user and SSM principal are allowe

Field DescriptionsFileset Name. The name to be assigned to the fileset. This name must be unique to the realm in which HPSS resides.Fileset State. The

10.3. Managing Existing FilesetsThis section describes how to look up information on, modify, or delete filesets.10.3.1. Core Server Fileset Informa

the data or metadata. Changing the state to Destroyed will prevent both reading and writing.Field DescriptionsFileset ID. The ID number which identifi

UID. The User ID identifying the user owning the root node of the fileset.GID. The Group ID identifying the principal group owning the root node of th

10.5. Creating a JunctionOnly the HPSS root user and SSM principal are allowed to create junctions.A junction is a name space object that points to a

10.6. Deleting a JunctionJunctions can be deleted using SSM or by using the utility routine deljunction. For more information, refer to the deljuncti

Chapter 11. Files, Directories and Objects by SOIDThis chapter describes two ways to display basic information about files and directories stored in

11.1.1. File/Directory Information WindowThis window shows details about a file or directory.If a file is displayed in the File/Directory Information

Object Type. The type of object being displayed, either File or Directory.Class of Service. The name of the Class of Service in which the file is stor

To help mitigate this, when the thread pool is full, the System Manager notifies all the threads in the thread pool that are waiting on list updates t

Extended ACL. If any ACL entry other than the default ACL entries exist, then the file or directory is said to contain extended ACLs. There are three

Comment x xCompositePerms x xCOSId xDataLength x xEntryCount xExtendedACLs x xFamilyId xFilesetHandleFilesetId x xFilesetRootId x xFilesetStateFlags x

11.2. Objects by SOID WindowTo display this window, select Monitor from the Health and Status window, then select Lookup HPSS Objects, and then“Obje

Chapter 12. Tape AggregationThis chapter discusses the following operations:• Overview of Tape Aggregation• Tape Aggregation Performance Considerati

Migration Policy screen. Edit any other tape aggregation related fields on that screen as needed. If MPS is running, you must also tell it to reread

Chapter 13. User Accounts and Accounting13.1. Managing HPSS UsersAfter the HPSS system is up and running, the administrator must create the necessa

[ added unix user ][ KADMIN_PRINC unset; using kadmin.local for Kerberos ops ][ adding kerberos principal ][ added kerberos principal ]HPSS/LDAP home

13.1.1.3. Add a Kerberos User IDThe hpssuser utility invokes the kadmin utility to create the KRB principal and account. This can be done using both

# hpssuser -add user1 -ftp -nohomeUser ID#: 300Enter password for user1: ******Re-enter password to verify: ******Full name: Test UserHPSS/LDAP home d

[ SSM user deleted ][ deleting ldap principal ][ deleted ldap principal ][ deleting ftp user ][ ftp user deleted ][ deleting kerberos principal ][ KAD

port hpssgui and hpssadm clients must access to reach the System Manager.This task can be made a bit easier if the System Manager RPC program number i

# hpssuser -ssmclientpkg /tmp/ssmclientpkg.tar[ packaging ssm client ][ creating /tmp/ssmclientpkg.tar ]ssm.confkrb5.confhpssgui.plhpssgui.vbshpss.jar

An accounting policy is required whether the site actually charges users for HPSS usage or not.Field DescriptionsAccounting Style. The style of accoun

manipulation operations.Account Inheritance. A flag that indicates whether or not newly created files and directories should automatically inherit the

This window allows an administrator to view the accounting status and start accounting. Field DescriptionsSubsystem. The name of the storage subsystem

The first type, denoted by a zero (0) in the fourth column, gives the following summary information about the storage used by a particular HPSS Accoun

In the above example, line 2 shows that a user using account 634 made a total of 89 accesses to COS 1 and has 125 files stored in COS 1 which together

● The site will need to create a local site Account Map to maintain a list of the account IDs for which each user is authorized. This is a locally d

13.2.3.1.2. Site Defined Account Apportionment TableIn UNIX-style accounting, the UID (as Account Index) maps only to a specific user. Some sites m

13.2.3.2. Accounting Intervals and ChargesThe time between accounting runs and the charging policy for space usage should be developed after consulti

Chapter 14. User InterfacesThis chapter configuration information for the user interfaces provided with HPSS for transferring files:• Client Applica

· When you have decided on the hpssgui command line that is best for your installation, it will probably be useful to put the command in a shell scrip

write operations between cache invalidates. The default value is 20.HPSS_API_HOSTNAME specifies the hostname to be used for TCP/IP listen ports create

etc/hpss.keytab.HPSS_UNIX_KEYTAB_FILE specifies the name of the file containing the security keys necessary for successfully initializing the Client A

non-HPSS Parallel FTP Daemon (DIS2COM PFTP Daemon). This file should be customized as needed. Refer to the HPSS.conf man page or the HPSS Installatio

# HPSS file systems rather than the local file system of the# host executing the FTP Daemon. This is highly recommended!banner <pathname/filename&g

• Message/readme/banner/shutdown (message lines) are text files, with the following keywords (all one character in length) recognized, identified by a

days of the week.Step 4. Creating FTP UsersIn order for an HPSS user to use FTP, a UNIX and/or Kerberos userid and password must be created. Refer to

character device (/dev/hpssfs0) that is used to communicate with the HPSS VFS Daemon (hpssfsd). All POSIX I/O system calls like open, read, write, clo

% make BUILD_ROOT=/tmp/vfs_client build-clnt build-fsCreate a tar file that can be used to build the client code on the VFS machine:% cd /tmp/vfs_clie

% rmmod hpssfs # this ensures that there isn't a pre-existing module loaded% modprobe hpssfs% make config% MAKEDEV hpssfs% /sbin/chkconfig

% mkdir /var/hpss/cred% mkdir /var/hpss/tmpOn the Core Server machine, use mkhpss to create the client config bundle:% mkhpssSelect "Create Confi

• The proper authorization entries for the user are created in the AUTHZACL table.3. The proper SSM configuration files are created and installed.See

o /opt/hpss/lib/libhpssunixauth.soo /opt/hpss/lib/libhpssldapauthz.so• If the code is installed in a non-standard location (not /opt/hpss), update the

14.4. Mounting VFS FilesystemsAn HPSS fileset or directory is made available for user access by mounting it using the mount(8) command. The mount com

none /dev/shm tmpfs defaults 0 0none /proc proc defaults 0 0none /sys sysfs defaults 0 0/dev/VolGroup00/LogVol01 swap swap defaults 0 0jupiter:/aut

Mount Option Mount Descriptionacdirtimeo Seconds to cache directory attributes. The shorter this value, the more frequently communication to HPSS is

Mount Option Mount Descriptionmaxiowidth maxiowidth princ Override for principal auth Override for authorization type key Override keytab type keytab

where <group ID> can be obtained using the mount utility. The trace level can be changed while the hpssfsd is running.# echo 5 > /proc/fs/hps

Chapter 15. Backup and RecoveryThis chapter discusses the following operations:• Backup and recover HPSS metadata• Backup HPSS environment• Recover

made to the database. These logs allow DB2 to recover all changes made to the database since the time of the last database backup, forward to the tim

“full”, “incremental”, or “delta”. Full backups record the full contents of the database at a point in time. Incremental backups record all the change

15.1.3. Overview of the DB2 Recovery ProcessUpon discovering a damaged DB2 container, you must first determine the level of hardware recovery and pro

% /opt/hpss/bin/hpssuser -add john -ssm[ adding ssm user ]1) admin2) operatorChoose SSM security level(type a number or RETURN to cancel):> 1[ ssm

• {HPSS secondary metadata backup path}/subsys1• /<metadata backup filesystem>• Others site-specific filesystems15.2.2. Operating System Backup

prepare for and to perform the recovery process: 1. Determine the name of the potentially damaged volume.Attempts to read the damaged volume will resu

can be used to clean up storage resources and report what data has been lost. The recover utility has several options. These options are used dependin

storage level = 1 on VV = VOL00100path ( Fileset24: /home/bill/file2)========= Trying to recover bitfile =========0786ab2c-156b-1047-8c81-02608c2f971f

storage level = 1 on VV = VOL00100path ( Fileset24: /home/bill/file2)lost segments from this storage leveloffset = 0 , length = 32768offset = 32768

00226b52 4631 10cf 00 00 00 17At the end of the cleanup, all the virtual and physical volumes associated with the targeted volumes will be deleted. Al

15.5.1. DMS Table SpacesCapacity for a DMS table space is the total size of containers allocated to the table space. When a DMS table space reaches c

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 367

Chapter 16. Management Tools16.1. Utility OverviewHPSS provides a variety of command-line utility programs to aid in the use and management of the

• dumppv_pvr - List the physical volumes managed by a particular PVR.• lshpss - Lists various views of the system configuration.• lsrb - Lists a list

Access to the hpss_server_acl program, hpssuser program, to the HPSS DB2 database, and to all HPSS utility programs should be closely guarded. If an

• hpss_unix_user - Manages HPSS UNIX password file.• hpss_managetables – Creates, deletes and modifies databases, database tablespaces, tables, views

can also be used to reset the number of segments counter in disk and tape storage maps.• showdiskmaps – Sends a command to the Core Server in the sele

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 372

Appendix A. Glossary of Terms and AcronymsACIAutomatic Media Library Client InterfaceACLAccess Control ListACSLSAutomated Cartridge System Library S

bitfile segmentAn internal metadata structure, not normally visible, used by the Core Server to map contiguous pieces of a bitfile to underlying stora

DECDigital Equipment Corporation.delogThe process of extraction, formatting, and outputting HPSS central log records.deregistrationThe process of disa

fileset ID A 64-bit number that uniquely identifies a fileset.fileset name A name that uniquely identifies a fileset.file system IDA 32-bit number tha

IBMInternational Business Machines CorporationIDIdentifierIECInternational Electrotechnical CommissionIEEEInstitute of Electrical and Electronics Engi

local logAn optional circular log maintained by a Log Client. The central log contains formatted messages from all enabled HPSS servers residing on th

mountAn operation in which a cartridge is either physically or logically made readable and/or writable on a drive. In the case of tape cartridges, a m

Keytabs are created for the user by the hpssuser utility when the krb5keytab or unixkeytab authentication type is specified. Keytabs may also be crea

physical volumeAn HPSS object managed jointly by the Core Server and the Physical Volume Library that represents the portion of a virtual volume. A v

requestA log record message type used to log some action being performed by an HPSS server on behalf of a client.RISCReduced Instruction Set Computer/

stageTo copy file data from a level in the file’s hierarchy onto the top level in the hierarchy.start-upAn HPSS SSM administrative operation that caus

System ManagerThe Storage System Management (SSM) server. It communicates with all other HPSS components requiring monitoring or control. It also co

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 384

Appendix B. References6. 3580 Ultrium Tape Drive Setup, Operator and Service Guide GA32-0415-007. 3584 UltraScalable Tape Library Planning and Opera

33. J. Steiner, C. Neuman, and J. Schiller, "Kerberos: An Authentication Service for Open Network Systems," USENIX 1988 Winter Conference Pr

Appendix C. Developer AcknowledgmentsHPSS is a product of a government-industry collaboration. The project approach is based on the premise that no

HPSS Management Guide November 2009Release 7.3 (Revision 1.0) 388

3.3.3. SSM Configuration FileThe hpssgui and hpssadm scripts use the SSM configuration file, ssm.conf for configuration.The mkhpss utility will creat

3.3.3.1. login.conf...

File Option Command Line OptionFunctionalityHPSS_SSM_SM_HOST_NAME -h System manager hostnameHPSS_SSM_USER_PREF_PATH -i Path to ssm preferencesJAVA_BI

File Option Command Line OptionFunctionalityHPSS_AUTHEN_TYPE -t Authenticator typeInformation on tuning client polling rates for optimal performance i

Note that having encryption types other than "des-cbc-crc" first on the "default_tkt_enctypes" and "default_tgs_enctypes"

3.3.5.1. Automatic SSM Client Packaging and InstallationThe hpssuser utility provides a mechanism for packaging all the necessary client files requir

These files may be installed in any location on the SSM client machines. The user must have at least read access to the files.The SSM startup scripts

3.3.6.2. Solutions for Operating Through a FirewallSSM can operate through a firewall in three different ways:• The hpssgui and hpssadm can use port

• Verify that the proper version of Java is installed. Add the Java bin directory to the user's $PATH, or use the -j switch in the hpssgui scrip

If access through the firewall is needed for other ports (eg., the Kerberos kdc), set up a separate tunnel for each port the firewall does not allow t

applicable to the platform on which the graphical user interface is running. Custom Look and Feels are also available at http://www.javootoo.com· -b &

include “static” text painted on the window background or labels on things like buttons. Text fields may appear as single or multiple lines and they

4.2.4. Modifying a Storage Subsystem...814.

• Select/cut/copy/paste operations can be performed on enterable text fields; on non-enterable fields, only select and copy operations can be performe

all of the current configuration’s field values.• Freeze - A checkbox that, while checked, suspends the automatic updates made to an SSM window. This

menu item is available on all SSM windows.• Edit menu - The Edit Menu is located on all SSM data windows. From each Edit Menu, the user can access Cut

variables may be overridden. 3.8. Monitor, Operations and Configure Menus OverviewThe Monitor, Operations and Configure menus are used by the System

Accounting Status. Opens the Subsystem list window where the Accounting Status and Start Accounting buttons can be found.Log Files Information. Open

volume labels can be entered and a request to add the disks to a storage class can be submitted.• Create Tape Resources. Opens the Create Tape Resour

of the accounting policy. Only one accounting policy is allowed.• Location. Opens the Location Policy window allowing configuration and management of

The HPSS Login window appears after starting the hpssgui script. The user must supply a valid HPSS user name and password in order to access SSM and m

mismatched versions may cause compatibility problems.3.9.2. About HPSSThe About HPSS window displays version information and a portion of the HPSS co

When a user successfully connects to the System Manager through the Login window, the HPSS Health and Status window replaces the Login window on the s

5.1.1.2. Migration/Purge Server Information Window...1335.1.1.3. Mover Info

icon is red, the client’s connection to the System Manager is lost; when it is green, the connection is active. 3.9.3.2. HPSS StatusOn the upper sect

In addition to the text which describes the status, these fields are displayed with colored icons. The icon color depicts that status as follows:• Re

HPSS Statistics fields show general trends in HPSS operations; the numbers are not all-inclusive. Some values may fluctuate up and down as servers are

user the ability to hide or display elements of the HPSS Health and Status window in order to optimize the viewable area. Under the View Menu there

Field DescriptionsStart Time. The time the System Manager was started.Uptime. The elapsed clock time since the System Manager was started.HPSS Managem

CPU Time. The amount of CPU time that the System Manager has consumed.Memory Usage. The amount of memory that the System Manager is currently occupyi

Thread Pool Size and/or Request Queue Size to help with the System Manager performance. However, increasing these 2 parameters could cause the System

• Hostname. The name of the host where the client is running.• Connections. The number of RPC connections this client has to the System Manager.• Sta

Field DescriptionsUser Login Name. The name that the user entered as the User ID when logging into HPSS.User Authority. The authority level that the u

Percent Memory Free. The ratio of free memory to total memory in the hpssgui process.Total Windows Opened During This Session. The number of windows c

6.2.4. Deleting a Storage Hierarchy Definition...1736.3. C

HPSSGUI_USER_CFG_PATH or the configuration file entry HPSS_SSM_USER_PREF_PATH. If this option is not specified, the default value is <client node&

Save. Save the current preference settings to the preferences file using the same preference name. Delete. Delete the currently displayed preference s

Chapter 4. Global & Subsystem ConfigurationThis chapter discusses two levels of system configuration: global and storage subsystem. The global c

This window allows you to manage the HPSS global configuration record. Only one such record is permitted per HPSS installation. To open the window, o

Storage Subsystem configuration. Root User ID. The UID of the user who has root access privileges to the HPSS namespace. This only applies if the Root

This window lists all the subsystems in the HPSS system and provides the ability to manage these subsystems. To open the window, from the Health and S

subsystem is selected in the list.Delete - Delete the selected subsystem(s). This button is disabled unless a subsystem is selected in the list.Always

This window allows an administrator to manage the configuration of a storage subsystem. The Add button is only displayed during the creation of a new

user does not specify a COS or any hints with the creation request. The global configuration specifies a default COS for an entire HPSS installation.

DB Log Monitor Interval. The Core Server will check consistency of Database Logs and Backup Logs at the indicated interval, specified in seconds. The

8.1. Adding Storage Space...2238.1.1. I

Gatekeeper is already configured, simply add it to your storage subsystem's configuration. However, if it is not yet configured, it will be neces

4.2.3.7. Migration and Purge Policy OverridesThe migration and purge policies contain two elements, the basic policy and the storage subsystem specif

E. Issue the following SQL command:db2> select count(*) from nsobjectThe result of the command should indicate 2 rows in this table.3. If any of th

Chapter 5. HPSS ServersMost HPSS Server administration is performed from the SSM graphical user interface Servers list window. Each HPSS server has

The server’s configuration should be carefully reviewed to ensure that it is correct and complete. Check the Alarms and Events window and the HPSS log

rate (see the hpssgui/hpssadm man pages for more details). If a server is configured as executable but is not running, SSM will treat it as an error.

Execute Host. The Execute Hostname field from the server's basic configuration record. This field is intended to specify the hostname on which th

server hangs up or otherwise won't respond to the Shutdown command.Force Connect - Request the System Manager to immediately attempt to connect t

• Storage System Manager• Startup Daemon (on each host where an HPSS server will be executing)The fields of the Server Configuration window are divide

● Section 5.1.3: Mover Specific Configuration on page 102● Section 5.1.1: Physical Volume Repository (PVR) Specific Configuration on page 109● Details

9.1. Logging Overview...2949.2. Lo

Field DescriptionsServer Name. A unique descriptive name given to the server. Ensure that the Server Name is unique. A server’s descriptive name shoul

Execute Hostname. This is the hostname of the node on which the server will execute. It must match the Execute Hostname of the Startup Daemon that is

5.1.1.2. Interface ControlsThe Interface Controls section of the Server Configuration window is common to all servers. In the example window above,

The Security Controls section of the Server Configuration window is common to all servers. In the example window above, the server displayed is a Cor

Authenticator. The argument passed to the authentication mechanism indicated by the Authenticator Type configuration variable and used to validate com

• UTIME. Core Server bitfile time modified events.• ACL_SET. Core Server access control list modification events.• CHBFID. Core Server change bitfile

• TRACE. If selected, Trace messages generated by the server are sent to the log. It is recommended that this be OFF for all servers except the Mover

COS Change Retry Limit, Tape Dismount Delay, Tape Handoff Delay, PVL Max Connection Wait, Fragment Trim Limit and Fragment Smallest Block can be chang

The server uses built-in default values for these settings, but if the environment variables can be found in the server's environment, the server

for both gatekeeping and account validation. If multiple Gatekeepers are configured, then any Gatekeeper may be contacted for account validation reque