Go to main content
1/38
Contents
List of Examples
List of Figures
List of Tables
Title and Copyright Information
Preface
Documentation Accessibility
1
Overview
About ACSLS
The acssa and acsss User IDs
Logging in Remotely
Starting and Stopping ACSLS
The acsss command
Changing ACSLS Run State
Using cmd_proc
Starting cmd_proc
Suspending and Resuming cmd_proc
Terminating cmd_proc
Using cmd_proc in Curses Mode
Example - Default Curses Mode
Limited Command History, Limited Length in Curses Mode
Using cmd_proc in Line Mode
Status Messages Intermixed with Commands in Line Mode
cmd_proc Keyboard Shortcuts in cmd_proc (curses and line modes)
Using cmd_proc in Shell-Friendly Mode (cmd_proc_shell)
Redirecting Input to cmd_proc - Input Files and Command Scripts
Redirecting Output from cmd_proc
ACSLS Directory Structure
2
Starting and Monitoring ACSLS
Starting ACSLS
Monitoring ACSLS
Stopping ACSLS
SMF Timeout on Solaris
ACSLS Startup Policy
Additional Startup Time
Desired (offline) Startup State for an ACS
3
ACSLS GUI
Starting the ACSLS GUI
Administering GUI Users and Passwords
Overview of the GUI
The GUI Welcome Screen
Masthead
Alarms Color Codes
System Preferences
Navigation Tree
Overview and Status
Configuration and Administration
The Log Viewer
System Events
Logical Library Configuration
Tape Library Operations
Tape Libraries & Drives
System Operations Excluded in the ACSLS 8.5 GUI
Firewall and the GUI
On Solaris
On Linux
Configuring a Self-Assigned Digital Certificate for HTTPS
4
Installing and Configuring Your Library Hardware
Installing Connections to Your Library Hardware
Adding the SCSI mchanger Device Driver
Enabling SL8500 or SL3000 Dual TCP/IP Support
Synchronizing SL4000 Library and ACSLS Server Clock
Configuring or Reconfiguring Library Hardware
Using acsss_config to Configure Your Library Hardware
Before Running acsss_config for the SL4000
Running acsss_config
Renumbering an ACS
5
Setting Variables that Control ACSLS Behavior
Accessing the ACSLS Feature Configuration Menu
Verifying and Changing Dynamic and Static Variables
Setting CSI Tuning Variables
Setting Event Logging Variables
Setting General Product Behavior Variables
Setting Access Control Variables
Setting Automatic Backup Variables
Rebuilding Access Control Information
Defining Event Notification Settings
Configuring or Updating your Library Hardware
Setting OSCI Variables with dv_config
Registering for Email Notification of System Events
6
Access Control
Volume Access Control
Enabling Volume Access Control
Defining other users that are allowed access to the user's volumes
Establishing Ownership of Your Volumes
Ownership policies
Verifying Ownership
Volume Access Summary
Command Access Control
Enabling Command Access Control
Associating a client identity with a user name
Defining What Commands are Available to Which Users
Command Names for Command Access Control allow and disallow Files
Logging Access Control Messages
7
Library Management
Specifying ACS Numbers
Reconfiguring ACSLS When Tape Drives are Moved, Added, or Removed
Updating Tape Drives Configured to ACSLS
Auditing the Library
How Audit Works
When to Run an Audit
Audit Intervals
Adding a SCSI or fibre-attached library to ACSLS
Using the Extended Store Feature
Managing a Mixed-Media Library
Displaying the ACSLS Mixed-Media Settings
Mixed-Media Restrictions for SCSI-Attached LSMs
Setting Scratch Preferences
User-Defined Mixed-Media Files
System-Defined Mixed-Media Files
How ACSLS Uses the Mixed-Media Files
Defining a Scratch Preferences File
Managing Dual TCP/IP Connections
Managing a Dual-LAN Client Configuration
Registering the IP Addresses of Primary and Secondary LANs
Installing a Second Ethernet Port for a Multi-Homed ACSLS Server
Setting the TCP/IP Connection Timeout Interval
Registering for Event Notification
Automatic Recovery to Desired State
Current state and desired state
Current state cascades down, desired state does not
Queue and Retry Mounts and Dismounts when Library is Temporarily Unavailable
Reconfiguring ACSLS When Tape Drives are Moved, Added, or Removed
Updating Tape Drives Configured to ACSLS
Media Validation
Adding Drives to the Media Validation Pool
Removing Drives from the Media Validation Pool
8
Cartridge Management
Populating the LSM
Using the CAP
CAP Types
CAP States
CAP Modes
CAP Priorities
Displaying CAP Information
Entering Cartridges
Terminating an Enter Request
Ejecting Cartridges
Recovering CAPs
General CAP Recovery Procedures
Complete Enters and Ejects Before Doing CAP Recovery
Recover a Hung CAP by Varying it with Offline Force Then Online
Recovering a CAP After Opening the Access Door
CAP used for automatic enter will not unlock
CAP used for manual enter will not unlock
CAP used for ejects will not unlock
Automatically Applying Policies to New and Reactivated Cartridges
Automatic Assignment of Cleaning Cartridge Attributes
watch_vols Policies
Cleaning Cartridges
Automatic Cleaning by ACSLS
Cleaning Cartridge Maximum Usage
Manually Defining Cleaning Cartridges
Monitoring Cleaning Cartridges
Entering Cleaning Cartridges
Ejecting Used Cleaning Cartridges
Manually Cleaning a Drive
Cleaning Cartridges on Fibre-Attached Libraries
What To Do When Drives Are Not Being Cleaned
Verify Auto-Cleaning is Enabled
Verify there are Cleaning Cartridges for the Drives
Verify Auto-Cleaning is Disabled Using SL Console for an SL8500 or SL3000 Library
Check if Cleaning Cartridges are Marked as Questionable
Managing Scratch Cartridges
Displaying Scratch Pool and Scratch Cartridge Information
Adding Scratch Cartridges to the Library
Rebalancing Scratch Pools
Deleting Scratch Pools
Emptying a Scratch Pool
Deleting a Single Pool
Deleting All Empty Pools
Mounting Scratch Cartridges
Single-Media Environments
Mixed-Media Environments
Unscratching Cartridges
Using Absent and Ejected Cartridge Support
Absent, Ejected and Missing Cartridges
Cartridge (Volume) Status Reporting
Cartridge Recovery
Missing Cartridges
Absent and Ejected Cartridge
Cartridges Not Found
Cartridges Found
Using the Manual Volume Delete Utility
Identifying Expired Cartridges
Cartridge End-of-Life Percentages
Access Counts
ACSLS Cartridge Mount Count Details
Cartridge Warranty and End-of-life Thresholds
Moving Least-Recently Accessed Cartridges from Active LSMs
Identify the LSMs with too Few Free Cells and LSMs with Empty Cells
Review Cartridges in an LSM by Access Date
Ensure Access Date is Reported for Easy Sorting
Look at the Distribution of Last Access Dates for Cartridges in an LSM
Move the cartridges from Full LSMs to LSMs with Empty Cells
Create Lists of Cartridges to Move
Move the Cartridges to an LSM with Free Space
Manually Loading Cartridges Into Drives in a Disabled LSM
9
Database Administration
Utilities Used
Exporting the Database
Removing Unsupported Tape Libraries, Drives, and Cartridges Before Exporting to an Earlier Release
Removing Logical Libraries before Exporting to Linux
Exporting to a Disk File
Exporting to Tape
Importing the Database
Importing From a Disk File
Importing from Tape
Migrating mchangers for Fibre to a New Platform
Record Details about Fibre-attached Libraries on the Old ACSLS Server
Reconfigure ACSLS to Change mchanger Names for Fibre-attached Libraries
Verifying the Imported Database and Library Configuration
Automatic Database Backup
Performing Manual Backups to Tape
Backing up to a Specified Tape Device Attached to the ACSLS Server
Backing up to a UNIX File
Recovering and Restoring
Restoring the Database to the Most Recent Backup
Recovering from a Failed Server
Restoring ACSLS Control Files
10
Reporting and Logging
Creating a Custom Volume Report
Custom Volume Report
Custom Volume Report Example
Creating a Logging Volume Statistics Report
11
Utility Reference
Overview
Legacy Start/Stop Scripts
Utility Commands
acs_partition.sh
acs_renumber.sh
acs_rewallet.sh
The acsss Macro
Format
Options
bdb.acsss
Format
Options
Usage
Dynamic Configuration (config) utilities
Limitations of Dynamic Configuration
Things You Should Not Do
config acs
Format
Adding a new ACS
Reconfiguring an existing ACS
Limitation of config acs
config drives
Format
Usage
config lsm
Format
Usage
Limitation of config lsm
config ports
Format
Usage
Limitations of config ports
db_export.sh
Format
Options
Usage
db_import.sh
Format
Options
Usage
db_restore.sh
Format
Options
Usage
del_vol
Format
Options
Usage
Example
drives_media.sh
Format
Options
ejecting.sh
Format
Options
ejecting.sh Logs
free_cells.sh
Format
Option
getHba.sh
Format
greplog
Format
Options
Usage
install_scsi_Linux.sh
Format
lib_type.sh
Format
moving.sh
Format
Usage
Examples
probeFibre.sh
Format
Options
rdb.acsss
Format
Menu Options
See:
showDevs.sh
Format
Options
showDrives.sh
Format
stats_report
Format
Usage
userAdmin.sh
Format
volrpt
Format
Options
Usage
Examples
watch_vols
Format
Usage
Example
12
Command Reference
General Command Syntax
Component Types and Identifiers
Common Command Error Messages
Commands
audit
Format
Usage
Examples
Command Area Messages
Display Area Messages
cancel
Format
Options
Examples
Command Area Messages
Display Area Messages
clear lock
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
define pool
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
delete pool
Format
Options
Usage
Examples
Command Area Messages
dismount
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
eject
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
enter
Options
Usage
Examples
Command Area Messages
Display Area Messages
idle
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
lock
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
logoff
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
mount
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
mount *
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
move
Format
Options
Usage
Examples
Command Area Messages
query commands
Format
Command Area Messages
Display Area Messages
query acs
Format
Options
Usage
Examples
query cap
Format
Options
Usage
Examples
query clean
Format
Options
Usage
Examples
query drive
Format
Options
Usage
Examples
query lmu
Format
Options
Usage
Examples
query lock
Format
Options
Usage
Examples
query lsm
Format
Options
Examples
query mount
Format
Options
Usage
Examples
query mount *
Format
Options
Usage
Examples
query pool
Format
Options
Usage
Examples
query port
Format
Options
Usage
Examples
query request
Format
Options
Usage
Examples
query scratch
Format
Options
Usage
Examples
query server
Format
Options
Usage
Examples
query volume
Format
Options
Usage
Examples
set commands
Format
Command Area Messages
Display Area Messages
set cap mode
Format
Options
Usage
Examples
Command Area Messages
set cap priority
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
set clean
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
set lock
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
set owner
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
set scratch
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
show
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
start
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
switch lmu
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
unlock
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
uptime
Format
Usage
Example
vary
Format
Options
Usage
Examples
Command Area Messages
Display Area Messages
13
Display Command Reference
Using display Command Options
Using Wildcard Characters
Examples
Using Ranges
Examples
Format
Options
Start cmd_proc in Line Mode when Displaying Lines Longer than 80 Characters
Commands
display cap
Format
Fields
Options
Examples
display cell
Format
Fields
Options
Example
display drive
Format
Fields
Options
Examples
display lock
Format
Fields
Options
Example
display lsm
Format
Fields
Examples
display panel
Format
Fields
Options
Example
display pool
Format
Fields
Options
Examples
display port
Format
Fields
Options
Example
display volume
Format
Fields
Options
Examples
14
lib_cmd
Introduction
Command
Pathname
Snyposis
Using lib_cmd
Option
Subcommands
Using lib_cmd in Batch Mode
A
ACSLS Backup and Recovery Tools
ACSLS Backup Tools
Automatic Backups
Manual Backups
Manual Database Exports
ACSLS Recovery Tools
Using rdb.acsss
Using db_import.sh
Disaster Scenarios
Database becomes corrupted
Ran acsss_config against the wrong library
Server failure – rebuilding the same server with new hardware
Server failure – rebuilding another ACSLS server with new hardware
B
Enterprise Library Connection Options
Overview
Displaying the status of ACSLS Communication with Libraries
Dual TCP/IP Support
Requirements
Configuration
Scenario 1 - Preferred Configuration
Scenario 2
Scenario 3
Scenario 4
Retaining Customized Routing Table Entries after a Reboot
Creating Scripts
Adding Custom Route To Be Initialized At Boot Time
Removing routing commands
Multi TCP/IP Support
Redundant Electronics
ACSLS Support for RE
Query and Retry of Mounts and Dismounts
switch lmu for Only a Single Library
C
ACSLS Support of the SL8500
Connecting to Multiple SL8500s Using Multi TCP/IP
Verifying that all SL8500 Components are Operational
Understanding SL8500 Internal Addresses and ACSLS Addresses
Using SL Console to Translate Addresses
Tape Drive Locations
Moving Cartridges Before Removing Cells from a Partition
SL8500 CAPs
Bulk CAP
Upgrading the SL8500 to Handle Bulk CAPs with ACSLS
Custom SL Console Messages Showing Purpose of Enters and Ejects
Rotational CAP
Enter or Eject Operations
Enter, Eject, and Audit Operations for Some ACSLS Clients
Minimizing Elevator and PTP Activity
Configuring Tape Drives to Support Your Workloads
Managing Cartridge Locations
Finding Missing Cartridges
Varying the SL8500 Offline
Use ACSLS to vary SL8500 components offline, not SL Console
When to vary SL8500 components offline to ACSLS
Before opening the access door
If a CAP is inoperative
When closing the Service Safety Door
When using the Service Safety Door do not use these ACSLS commands and utilities
Using the Dynamic Configuration (config) utility
Expanding the SL8500
What is Involved
Diagram of SL8500 Modules:
Auditing an Expanded SL8500
Connecting SL8500s with Pass-Thru-Ports
Before You Install SL8500 PTP Connections
Adding New SL8500s
Adding a New SL8500 to the Left
Dynamically Configuring the New ACSLS Configuration
Adding a New SL8500 to the Right
Considerations When Adding an SL8500 to the Right
Dynamically Configuring the New ACSLS Configuration
Procedures for Merging ACSs
Merging ACSs Numbered from Right to Left
Procedure for Merging ACSs Numbered from Right-to-Left
Merging ACSs Numbered from Left-to-Right
Procedure for Merging ACSs Numbered from Left-to-Right
Removing PTPs and Splitting ACSs
Splitting
ACSs, with the new ACS Created from SL8500(s) on the Left - Possible Scenarios
ACSLS Procedure for Splitting an ACS
Adding the New ACS on the Right Hand side of the Split
D
ACSLS Support of the SL3000
ACSLS Support
Before Configuring ACSLS for the SL3000
Connecting the SL3000 to ACSLS
Verifying that all SL3000 Components are Operational
Configuring SL3000 to ACSLS
Auditing the SL3000
SL3000 Addressing
CAP Numbering
SL3000 Modules
New Panel Types
Understanding Internal SL3000 Addressing
Using the AEM
Access Door
Safety Door
CAP Operations
Non-Disruptive Maintenance
Aliasing SL3000 CAP IDs
Moving Cartridges Before Removing Cells from a Partition
SL3000 CAP Behavior
Finding Missing SL3000 Cartridges
Varying the SL3000 Offline
Use ACSLS to vary SL3000 components offline, not SL Console
When to vary SL3000 components offline to ACSLS
Before opening the access door
If a CAP is inoperative
Using the Dynamic Configuration (config) utility
Auditing New Cartridge Addresses
ACSLS Dual TCP/IP
E
ACSLS Support of the SL150
ACSLS Connectivity
ACSLS and SL150 Library Differences
Library Configuration
Identifying Library Locations
Addressing schemes
Panels
Row numbers
Column numbers
Drive addresses
ACSLS Limitations
Configuring SL150 Library Settings
SL150 CAP Behavior
CAP (Mailslot) Not Opening During an Eject
Auditing the Library
When this is a new library
After adding, removing, or swapping modules
After manually adding or removing cartridges through the mailslot
After changing library configuration settings
F
ACSLS Support of the SL4000
ACSLS Support
Before Configuring ACSLS for the SL4000
Configuring the SL4000 to ACSLS
Changing the SL4000 User Name and Password
SL4000 Modules
SL4000 Panel Types
Understanding SL4000 Addressing
SL4000 Addressing
CAP Numbering
Varying the SL4000 Offline
Use ACSLS to Vary SL4000 Components Offline, not SL4000 GUI
When to Vary SL4000 Components Offline to ACSLS
Before Opening the Access Door
If a CAP is Inoperative
Using the Dynamic Configuration (config) utility
Moving Cartridges Before Removing Cells from a Partition
Finding Missing SL4000 Cartridges
Auditing New Cartridge Addresses
Unknown Cell Information Reported When Auditing the SL4000 Library
Bulk Operations with the AEM
Bulk Enters
Bulk Ejects
Aliasing SL4000 CAP IDs
SL4000 OCSI Retention Time
ACSLS Support for Library Upgrade of SL3000 to SL4000
Important Considerations
What About my Volume Information?
What About my Logical Libraries?
What About my Client Applications?
Using watch_vol
G
Logical Library Support
About Logical Libraries
Benefits
Limitations
Creating a Logical Library
Specifying a Physical ACS
Specifying the Attributes of the Logical Library
Assigning One or More Physical Drives
Assigning One or More Physical Volumes
Specifying Client Connections
Fast Load
Deleting a Logical Library
Troubleshooting
What if a client cannot see the logical library that I've assigned?
What if a client is connected correctly, but still doesn't see the logical library?
What if a client has trouble configuring to a logical library?
How to Configure an FC Port in Target Mode
H
Library Partitioning
Aspects Common to both SL8500 and SL3000 Partitioning
Guidelines for Partitioning
Plan Your New Configuration
Minimize Disruptions when Partitioning an SL8500 or SL3000
Changes in Configuration
Keeping Outages to a Minimum
Challenges
Partitioning a Library or Changing Partition IDs
Re-partitioning a Library
Changing a Partitioned ACS to an Un-partitioned ACS
Viewing an ACS Partition ID
CAP Behavior
Partitioned Library
Dedicating a CAP in a Partitioned Library
Sharing CAPs in a Partitioned Library
When Another Host Needs the CAP
Assigning CAP Priorities for Shared CAPs
Reserving the CAP
Terminating a CAP Reservation
Moving Cartridges to a Specific Cell
I
Troubleshooting
ACSLS Event Log
Managing the Event log
Using
greplog
to Search Event Logs
Format
Options
Examples
Additional Logs
Trace Log Management
Java Component Logs
Key Observation Points
Diagnosing ACSLS Startup Problems
Testing Library Connections
testports
testlmutcp
testlmu
pinglmu.sh
probescsi.sh
probeFibre.sh
showDevs.sh
Troubleshooting an Offline SL4000 ACS
Testing a Client Connection
CAP in Fibre Library Attached Through a Bridged Drive is Locked
Gathering Diagnostic Information for Oracle Support
ACSLS and Security-Enhanced Linux (SE Linux)
Un-installing SE Linux Policy Modules for ACSLS
Managing SE Linux Enforcement
Verifying the GUI is Operational
GUI Troubleshooting Tips
Linux 7.3 and 7.6 Performance Issues
Missing Host Entry
SSSD
Diagnosis 1
Diagnosis 2
SL4000 OCSI Retention Time
J
Issues Installing ACSLS Client Applications
Installing an ACSAPI Client on Solaris 11
K
Library Performance
Sending Enough Concurrent Mount and Dismount Requests
Connecting to Multiple SL8500s
Minimizing Pass-thru Activity Between LSMs
Floating Cartridges During a Dismount
Maintaining Empty Storage Cells in an LSM
Mount and Dismount Timeouts
Entering Cartridges into a Library
Ejecting Cartridges from a Library
Minimizing Pass-Thru Activity Using ACSAPI Requests and ACSLS Commands
Mounting a Specific Cartridge
query mount
mount
Mounting a Scratch Cartridge Selected by ACSLS
query mount scratch (also known as query mount *)
mount scratch (also known as query mount *)
Using these ACSAPI Requests & ACSLS Commands
L
Firewall Security Option
Running ACSLS behind a Firewall
Addressing Security Areas
RPC
Security
Communications Components
Benefits of the Firewall-Secure Option
ACSLS Server-Side
ACSLS Server Port Restriction
Client-Side (CSC)
Client Port Restriction
Advantages
Turning on Firewall Secure Features and Setting Variables
ACSLS Variables
Displaying and Setting ACSLS Variables
ACSAPI Client System Variables
New Variables in CSC Toolkit 2.3
Displaying and Setting Environmental Variables on the Client
Firewall Secure Solution Scenarios
Firewall Security on ACSLS Server-Side Only
Firewall Security on Client-Side Only
Firewall Security on Both ACSLS Server and Client-Side with Portmapper
Firewall Security on Both ACSLS Server and Client-Side without Portmapper
Turning On the Firewall Security on ACSLS Servers
Turning Off Firewall Security on ACSLS Servers
Firewall-Secure Configuration
Troubleshooting Firewall-Secure Communications
Frequently Asked Questions
M
CSCI
Overview of CSCI
CSCI Connectivity
Architecture and Subsystems
Error Messages
Common Error Messages
Environmental Variables
N
Media Management
Overview
Restrictions
Examples
Solution
Managing Common Media with Recording Densities Reported by ACSLS
Procedure
Managing Common Media Recorded in Different Densities with ACSLS Pools
Procedure
O
XAPI Client Interface
The XAPI Client Interface to an ACSLS Server
The ACSLS XAPI Service
XAPI Variables
P
Accessibility Features in ACSLS
User Interfaces
The ACSLS (text-only) Command-line Interface (CLI)
Primary Administrative Interface: Unix Shell Functions
The ACSLS Graphical User Interface (GUI)
Accessibility Provisions in the ACSLS GUI
Special Steps Required to Configure Accessibility Modes in ACSLS
GUI Tree Menu
Glossary
Index
Scripting on this page enhances content navigation, but does not change the content in any way.