Using acsss_config to Configure Your Library Hardware

Using acsss_config enables configuration or re-configuration of library hardware:

Each ACS must have at least one CAP. This can be a CAP that is shared with another partition.
There must be at least one drive configured to the entire ACSLS system.

For example, if ACSLS supports four libraries; three of the libraries can contain zero (0) drives. However, the fourth library must contain at least one drive.
During the execution of acsss_config, any ACS requires a username and password to communicate with the library. Contact your library administrator for these credentials. You must provide user name and password credentials. Otherwise, as acsss_config attempts to continue processing, library communication failure errors will occur and the utility will be forced to exit. Note that a single point of failure during acsss_config will require you to reconfigure the ACS, and any ACSs that may have been correctly configured.
Configure your library hardware

You must use the acsss_config utility to configure your library hardware for the first time. The acsss_config utility is menu driven and selecting option 8 lets you to perform tasks such as configuring hardware for the first time, deleting libraries, or changing port connections to libraries.

Note:
ACSLS lets you skip ACS numbers when you configure or reconfigure libraries (see option 6). Both acsss_config and Dynamic Configuration support specifying and skipping ACS numbers.
Reconfigure your library hardware

Before using acsss_config to update the configuration information for all of your libraries, record the current configuration. Changing the ACS numbers assigned to your current libraries would cause all of your volumes to be marked absent and all of your drive's addresses to change. Save the output from a query lmu all command to record your current ACS numbers and port connections.

Note:
If acsss_config removes an existing physical ACS from the configuration while logical libraries with client connections still exist for that ACS, the SMCE subsystem may come up in maintenance state.
To avoid this, before using acsss_config to remove an ACS from the library configuration, any associated logical libraries must be deleted using the ACSLS GUI (or the lib_cmd CLI in ACSLS 8.2 and later releases). Deleting the associated libraries first ensures that all related information is correctly removed.

After your initial library configuration, you can use the config utility, to dynamically add or reconfigure ACSs, LSMs, or tape drives without stopping ACSLS.

For more information and procedures, see The acsss Macro.

Note:
The ACSLS database must be updated using acsss_config or config whenever the physical configuration of the library changes. ACSLS will not run correctly if the configuration defined in its database does not match the configuration defined in the library.

Example:

Configuration changes requiring an update to the database include:
- Adding or removing an ACS, LSM (including a SCSI-attached LSM such as the SL500), Pass-Thru Port (PTP), transport, or standby LMU
  
  Caution:
  After you install a new ACS or LSM, ensure that each attached library and LSM is fully (hardware) configured, powered on, and ready before you reconfigure ACSLS. Otherwise, acsss_config or config will not configure the library correctly.
- Adding or removing a port connection between the server system and the LMU

Before Running acsss_config for the SL4000

Before running acsss_config, ensure that you have completed the following library configuration tasks using the SL4000 GUI:

Define an SL4000 library certificate, including the Library Name (CN).

The SL4000 library requires a properly generated certificate for authentication purposes before it can connect to ACSLS. If the library certificate is not properly generated, ACSLS will return errors when it attempts to connect to the library through acsss_config.

From the SL4000 GUI, click Configuration in the left navigation area and then select the Certificates tab.

When you define the new certificate or view an existing certificate, note the Library Name (CN) as it is required during the acsss_config process when you are prompted for the device or host.

This CN name must match that used in acsss_config and config new acs. If using a host name (DN), not an IP address, it must also resolve to the same exact name. This may require DNS and/or resolv.conf modifications.

Note:
If you change a previously defined SSL certificate for an SL4000 library, the SL4000 library must be rebooted for the new certificate to take effect.
Define an SL4000 user that the ACSLS SCI interface can use to connect to the SL4000 library.

Note:
ACSLS SCI connection to an SL4000 library requires an SL4000 user credential with a user role at the User level. The SL4000 Administrator role can also be used for this credential.

From the SL4000 GUI, click Users in the left navigation area.

Assign the User role to the ACSLS SCI interface user and specify a user password. Note the user name and password as they are required during the acsss_config process.
Ensure that the SL4000 library is SCI capable, or has an SCI capable partition.

From the SL4000 GUI, click Partitioning in the left navigation area to display the partitioning table.
- If you are not partitioning the library, ensure that the Default partition row does not specify yes in the SCSI column. Also, verify that partitions are only displayed in the Default and Media Validation rows. This signifies a non-partitioned SL4000.
- If you are partitioning the library, the SL4000 partition will have a partition ID of 21 or higher. Ensure that the ACSLS partition row does not specify yes in the SCSI column. Note the partition ID as it is required during the acsss_config process.

Refer to the "Configuring the Library" section in the SL4000 Modular Library System Library Guide for more information about using the SL4000 GUI to perform these tasks.

Running acsss_config

To run acsss_config:

Log in as acsss.
If you are re-configuring your library hardware, enter the query lmu all cmd_proc command and record the following:
- ACS numbers
- Partition IDs
- Port connections
Shut down ACSLS if it is running.

Run the configuration utility:

acsss_config

The ACSLS feature configuration screen appears.

Note:

The configuration utility, acsss_config, configures the library correctly unless all libraries, LSMs, and transports are not fully configured, powered on, and ready.

The following menu appears:

ACSLS feature configuration 
Please enter the number followed by Return for your choice from the following menu to configure product behavior in that area. 
Press? followed by the Return key for help. 
1: Set CSI tuning variables 
2: Set event logging variables 
3: Set general product behavior variables 
4: Set access control variables 
5: Set automatic backup parameters 
6: Rebuild Access Control information 
7: Event Notification settings 
8: Define or Change Library Hardware Configuration 
E: Exit 
Menu choice:

Note:

For a discussion of options 1-7, refer to Setting Variables that Control ACSLS Behavior.

Select option 8.
The following prompts guide you through the configuration process.
- Prompt: Configure library communications? (y/n):
  
  Enter y to establish or update communications between the ACSLS server and any libraries. This includes adding, deleting, or changing port connections to libraries and adding, deleting, or changing library partitions.
  
  Selecting n refreshes the configurations of your current libraries.
  
  Bypassing configuring your library communications and just refreshing your hardware configuration is the easiest and best option if you do not need to: add or remove ACSs or add, change, or remove connections to libraries. You skip re-defining all of your current connections to your libraries and just refresh the library configuration recorded in the ACSLS database. This eliminates the risk of omitting a connection to a library or specifying it incorrectly.
- Prompt: Library server database exists and will be overwritten, continue? (y or n): y
  
  This prompt only displays if library communications have been previously established and there is an existing database.
  
  If you enter y to this prompt, changes are made to the configuration.
Specify the number of ACSs to be supported.
- Prompt: Number of ACSs to be supported:
  
  Enter the number of ACSs (between 1 and 32) that are to be supported at your site. You must have at least “1" ACS. Hardware must be installed to support one or more ACSs.
  
  You can skip ACS numbering when configuring or reconfiguring libraries without assigning the ACS numbers in sequence.
Specify each ACS number.
- Prompt: Please enter the first ACS number [default: 0]:
  
  Enter the number for this ACS.
  
  Caution:
  When you reconfigure existing ACSs, specify the same ACS numbers that are currently assigned to them.
  
  You are then prompted to define the device connections for each ACS.
Specify and define library partitioning.
- Prompt: Is ACS #n in a partitioned library? (y or n)
  - If you enter y, you are asked for the partition ID for the ACS.
    
    This partition ID must match the partition ID configured on the library.
  - If this is not a partitioned library or is SCSI/Fibre-attached, enter n.
    
    ACSLS does not support partitioned SCSI/Fibre-attached libraries.
Note:
An SL4000 library cannot be captured in a single ACS as a non-partitioned library.By default, an SL4000 library is a partitioned library with 2 omnipresent partitions 1 (Default partition) and 2 (Media validation partition).
Define the device connections (ports) for each ACS.
- Prompt: Number of connections to ACS #n
  
  This prompt appears for each ACS configured and establishes the number of communication ports for each ACS. The connection types are:
  - SCSI connection(s) using HTTPS
  - TCP/IP connection between the ACSLS and the library. At least two connections are recommended.
  - SCSI connection(s)
  If you are connecting to multiple SL8500 libraries, a maximum of fifteen connections is allowed.
  
  The ACSs must be physically connected. Enter a decimal number between 1 and 15.
- Prompt: Device or host - ACS#n, connection #n:
  
  Enter the device or host for each connection.
  
  Ensure that all connections specified for an ACS are actually connected to the same ACS.
  
  Caution:
  Make sure you specify the correct hostname or IP address. Do not connect to the wrong library.
  
  SCI libraries:
  
  To specify the connection to a SCI attached library (SL4000), enter the Library Name (CN) value from the library certificate established during SL4000 configuration, prefixed by https://.
  
  For example:
```
Device or host - ACS #0, connection #1: https://10.80.40.162
```
  where 10.80.40.162 is the Library Name (CN) value.
  
  If the library certificate specifies this value as a host name, you cannot use the corresponding IP address, or vice-versa. For example, if the library certificate CN name=sl4000-acs4, you must provide the matching URL (https://sl4000-acs4).
  
  If using a host name (DN), not an IP address, it must also resolve to the same exact name. This may require DNS and/or resolv.conf modifications.
  
  When prompted for authentication, enter the user name and password defined during SL4000 library configuration.
  
  Note:
  ACSLS SCI connection to an SL4000 library requires an SL4000 user credential with a user role at the User level. The SL4000 Administrator role can also be used for this credential.
  
  See Before Running acsss_config for the SL4000 for more information about configuring SL4000 library certificates and users.
  
  TCP/IP Attached libraries:
  
  To specify the connection to a TCP/IP attached library (SL3000, SL8500), enter one of the following:
  - IP address
  - hostname
  - fully qualified hostname
  Note:
  If a host name is specified, it must be mapped to the IP address entered into an SL8500 or SL3000 library. This host name-to-IP address mapping is site-specific. Typically, this is done by the /etc/hosts file, your Domain Name Server, NIS, or NIS+.
  
  Example:
  
  Sample TCP/IP device names for SL8500 or SL3000 libraries:
```
Device or host - ACS #0, connection #0: hostname1 
Device or host - ACS #0, connection #1: hostname2 
Device or host - ACS #1, connection #0: fully_qualified_hostname 
Device or host - ACS #2, connection #0: xxx.xxx.xxx.xx
```
  Note:
  ACSLS only supports TCP/IP connections to an SL3000; ACSLS does not support Fibre-attached SL3000s.
  
  Fibre or SCSI-attached libraries:
  
  To specify the connection to a directly-attached library, these are connected through mchanger devices.
  
  Example:
  
  Sample device name for SCSI Library:
```
Device or host - ACS #1, connection #0: /dev/mchanger2
```
  If you have more ACSs to define, you will be asked to specify their ACS numbers. See step 7.
Create or update the configuration in the ACSLS database.
- Prompt: This step builds a database image of your complete library hardware configuration. Before proceeding, make sure that your library is completely configured, that all subsystems are functional and powered on. Build/Verify library configuration? (y or n):
  
  Enter y.
  
  Before proceeding, ensure that your library is completely configured, that all subsystems are functional and powered on.
  
  This step updates the database with all configuration changes, except adding or removing port connections.
- Prompt: Library server database exists and will be overwritten, continue? (y or n):
  
  Enter y. As the script builds the library configuration, it displays the following message of each panel in each LSM.
  
  ACS # n, LSM # nn, PANEL # nn, created
  
  The script also generates a library configuration report and appends it to the following file:
  
  $ACS_HOME/log/acsss_config.log
Optionally, configure non-TCP/IP clients on Solaris.
- Prompt: Configure client system interfaces? (y or n):
  
  Respond (y or n) when the system asks whether to configure client system interfaces.
  
  Enter n unless you are using an ICL client with OSLAN protocol.
  
  Entering y displays the following message:
```
CSI SELECTION TABLE 

1) OSLAN CSI Not Selected
2) ONC/RPC CSI Always Selected 

Do you want to change the CSI selection table (n):
```
  If y, the following message appears:
  
  Select OSLAN CSI (n):
  
  ONC/RPC is always selected.
  
  Note:
  acsss_config automatically backups the database and then terminates.
Run acsss enable to start the server.

You can view the Event Log to verify that the system is running.

ACSLS starts automatically when the server system is rebooted.
Perform an audit of the Library

An audit updates the ACSLS database to match the actual inventory of library cartridges.

ACSLS is now ready for library operations. If you want to enter ACSLS commands, log in as acssa.