You are on page 1of 139

Automated Cartridge

System Library
Software

Installation and
Configuration Guide
for Solaris

Version 6.0

CRC Update
The information in this document is confidential and proprietary to Storage Technology Corporation and may
be used only under the terms of the product license or nondisclosure agreement. The information in this
document, including any associated software program, may not be disclosed, disseminated, or distributed in
any manner without the written consent of Storage Technology Corporation.

Limitation on Warranties and Liability


This document neither extends nor creates warranties of any nature, expressed or implied.
Storage Technology Corporation cannot accept any responsibility for your use of the information in this
document or for your use of any associated software program. Storage Technology Corporation assumes no
responsibility for any data corruption or erasure as a result of the use of the information in this document, or the
use of software programs. You should be careful to ensure that your use of the information complies with all
applicable laws, rules, and regulations of the jurisdictions with respect to which the information is used.
Warning: No part or portion of this document may be reproduced in any manner or in any form without the
written permission of Storage Technology Corporation.

Restricted Rights
Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)
(1) (ii) of the Rights in Technical Data and Computer Software clause at DFARS 252.227–7013 or
subparagraphs (c) (1) and (2) of the Commercial Computer Software –– Restricted Rights at 48 CFR
52.227–19, as applicable.

Trademarks
The following terms are either trademarks or registered trademarks of Storage Technology Corporation:
StorageTekR
NearlineR
IBMR is a registered trademark of International Business Machines Corporation.
Other product names mentioned in this manual may be trademarks. They are used for identification purposes
only.

Ninth Edition, August 2001

EC 123273
This edition applies to Version 6.0 of Automated Cartridge System Library Software. Information contained in
this publication is subject to change. Comments concerning the contents of this manual should be directed to:
Storage Technology Corporation
Manager, Software Information Development, MS 5209
One StorageTek Drive
Louisville, Colorado 80028–5209
OR
E–mail us at: 


e Copyright Storage Technology Corporation 2001. All Rights Reserved.


About this Book

ACSLS Software
 
        

S Install and configure ACSLS 6.0


S Upgrade to ACSLS 6.0 from a previous release of ACSLS
S Install a second disk after you have installed ACSLS

Audience
This book is written for StorageTek or customer personnel who
install and configure the Solaris operating system and ACSLS.
As the ACSLS installer, you should already know the following:

S UNIX file and directory structure


S How to use UNIX commands and utilities for your
platform

S UNIX system files


S How to do typical UNIX tasks, such as logging on as 

About this Book iii


9th ed., 313464701

Reader’s We’d like to know what you think about this book. For that
Comments purpose, we’ve included a reader’s comment form in the back of
this book. Please copy the form, fill it out, and mail it to us.
If you prefer, you can e-mail your comments to Software
Information Development directly. Our Internet address is:


Be sure to include the document title and number with your
comments.

iv ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

About the Software


This book supports ACSLS 6.0.
xxxxx Note: The StorageTek Customer Resource Center (CRC) on the
xxx
World Wide Web lets you download ACSLS PTFs and software
support for product enhancements such as new drive or library
types.

To access ACSLS PTFs and software support for


product enhancements:

1. Using an Internet browser such as Netscape, go to the


StorageTek CRC. The URL is:


  

2. Select the  


    

 link.

3. Fill in the information requested in the form.


You should receive your account ID and password within
two days.

4. When you receive your account information, go back to


the CRC and select the   link.
When prompted, fill in your User ID and password.

5. In the       table under


, select the red square opposite ! .
The  !  "" !     #

 #   page appears. Select the PTF or
software support you want from this page.

About this Book v


9th ed., 313464701

How this Guide is Organized


This book contains the following information:

S Chapter 1. “Pre-installation Preparation”


S Chapter 2. “Installing Solaris”
S Chapter 3. “Installing and Configuring ACSLS”
S Chapter 4. “Completing the ACSLS Installation”
S Appendix A. “Utilities”
S Appendix B. “De-installing a Second Disk”
S Glossary

What’s New in This Guide


This guide contains the following new information for
ACSLS 6.0:

S Added procedures for removing group and user IDs,


Chapter 3 “Installing and Configuring ACSLS”, page 50

S Auto backup option changes to configuration options table


in Chapter 1 “Pre–installation Preparation”, page 7

S Minor updates to Solaris 7 and 8 installation procedures in


Chapter 2 “Installing and Configuring Solaris”

vi ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Conventions for Reader Usability


Conventions are used to shorten and clarify explanations and
examples within this book.

Typographic The following typographical conventions are used in this book:

S Bold is used to introduce new or unfamiliar terminology,


or it’s used in steps to indicate either an action or a
decision the user has to make.

S  $ is used to indicate command names,


filenames, and literal output by the computer.

S      is used to indicate literal input to


the computer.

S  

is used to indicate that you must
substitute the actual value for a command parameter. In
the following example, you would substitute your name for
the “username” parameter.
  

S A bar ( | ) is used to separate alternative parameter values.


In the example shown below either username or
systemname must be entered.
   %  

S Brackets [ ] are used to indicate that a command parameter


is optional.

S Ellipses ( ... ) are used to indicate that a command may be


repeated multiple times.

S The use of mixed face characters (bold and not bold)


indicates that not bold letters may be omitted to form
abbreviations. For example, you may simply enter  when
executing the  # command.

About this Book vii


9th ed., 313464701

Keys Single keystrokes are represented by double brackets  


surrounding the key name. For example, press ESC indicates
that you should press only the escape key.
Combined keystrokes use double brackets and the plus sign (+).
The double brackets surround the key names and the plus sign is
used to add the second keystroke. For example, press ALT +
C indicates that you should press the alternate key and the C
key simultaneously.

Enter Command The instruction to “press the ENTER key” is omitted from most
examples, definitions, and explanations in this book.
For example, if the instructions asked you to “enter” 
, you would type in   and press ENTER.

However, if the instructions asked you to “type” 


, you would type in   and you would not press
ENTER.

Symbols The following symbols are used to highlight text in this book.
Warning: Information necessary to keep you from damaging
STOP
your hardware or software.
Caution: Information necessary to keep you from corrupting
! your data.
Hint: Information that can be used to shorten or simplify your
task or that may simply be used as a reminder.
xxxxx Note: Information that may be of special interest to you. Notes
xxx
are also used to point out exceptions to rules or procedures.

viii ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Technical Support
Refer to Requesting Help from Software Support for information
about contacting StorageTek for technical support and for
requesting changes to software products.

Related Documentation

ACSLS 6.0 The following publications provide more information about


Documentation ACSLS 6.0.

S The ACSLS 6.0 Information CD–ROM, part number


313464401, which is automatically shipped with the 6.0
program package and provides PDF format of all the
ACSLS 6.0 publications.

S ACSLS Product Information that is provided in PDF


format on the ACSLS 6.0 Information CD-ROM and on
the StorageTek Customer Resource Center (CRC). See
“ACSLS Information on the StorageTek CRC” on page
x for more information.

S ACSLS System Administrator’s Guide, which is provided


in PDF format on the ACSLS 6.0 Information CD-ROM
and on the CRC. Hardcopy can be ordered by contacting
StorageTek at 1–800–436–5554. The hardcopy part
number is 313464801.

S ACSLS Quick Reference, part number 313465001, which is


automatically shipped with the 6.0 program package.

S ACSLS Messages, which is provided in PDF format on the


ACSLS 6.0 Information CD-ROM and on the CRC.
Hardcopy can be ordered by contacting StorageTek at
1–800–436–5554. The hardcopy part number is
313464901.

About this Book ix


9th ed., 313464701

ACSLS In addition to the PDF collection on the ACSLS 6.0 Information


Information on the CD–ROM, the StorageTek CRC provides PDF collections for
StorageTek CRC ACSLS 6.0. Use the following procedure to access these
collections on the StorageTek CRC.

To access ACSLS PDF collections on the StorageTek


CRC:

1. Using an Internet browser such as Netscape, go to the


StorageTek CRC. The URL is:


  

2. Select the  


    

 link.

3. Fill in the information requested in the form.


You should receive your account ID and password within
two days.

4. When you receive your account information, go back to


the CRC and select the   link.
When prompted, fill in your User ID and password.

5. In the       table under


&
, select the red square opposite ! .
The '
 &   !  "" !  
  #
  #   page appears.
Select the link for the PDF file of the ACSLS document
you want.

x ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

ACS Hardware The StorageTek CRC provides PDF file format of many of
Information on the StorageTek’s ACS hardware publications. Use the following
StorageTek CRC procedure to access these publications on the StorageTek CRC.

To access StorageTek ACS hardware documentation


on the StorageTek CRC:

1. Using an Internet browser such as Netscape, go to the


StorageTek CRC. The URL is:


  

2. Select the  


    

 link.

3. Fill in the information requested in the form.


You should receive your account ID and password within
two days.

4. When you receive your account information, go back to


the CRC and select the link for the hardware product
category you want (for example, (   
, ( 
&)
, or  ).
When prompted, fill in your User ID and password.

5. In the   table that appears, under &


, select
the red square opposite the product you want.
On the page that appears, select the link for the PDF file of
the document you want.

About this Book xi


9th ed., 313464701

Document Effectivity
EC Number Date Doc Kit Edition Effectivity
Number Type
123273 May 2001 –––––– Ninth This document applies to
Edition Automated Cartridge System
Library Software (ACSLS),
Version 6.0

Document Effectivity xiii


9th ed., 313464701

Contents
About this Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii
ACSLS Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii
Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii
Reader’s Comments . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv
About the Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
How this Guide is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
What’s New in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Conventions for Reader Usability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Typographic . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Enter Command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Symbols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii
Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
ACSLS 6.0 Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ix
ACSLS Information on the StorageTek CRC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x
ACS Hardware Information on the StorageTek CRC . . . . . . . . . . . . . . . . . . . . . . . . . . . . xi

Document Effectivity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xiii

Chapter 1. Pre–installation Preparation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1


Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Preparing for Solaris Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Preparing for ACSLS Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Planning ACSLS Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Planning Library Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
Where To Go Next? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Backing Up the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Exporting the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Contents xv
9th ed., 313464701

Chapter 2. Installing and Configuring Solaris . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31


Installing the Solaris 7 Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Installing the Solaris 8 Operating System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41

Chapter 3. Installing and Configuring ACSLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49


Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Removing Group and User IDs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
Verifying Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
Installing ACSLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 52
Applying Maintenance to ACSLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57
Configuring ACSLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
Troubleshooting Library Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64

Chapter 4. Completing the ACSLS Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69


Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
Configuring the Second Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Space Required by ACSLS on the Second Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Partitioning the Second Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 70
Creating the File Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
Installing ACSLS Second Disk Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
Restarting ACSLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
Importing the Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
Verifying the Imported Database and Library Configuration . . . . . . . . . . . . . . . . . . . . . . . . . 84
Verifying ACSLS Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Verifying ACSLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
Running ivp.sh to Verify ACSLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 89
ACSLS Setup for Client Communication . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90
Regressing to a Previous Version of ACSLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 90

Appendix A. Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
Using the ACSLS Database Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
bdb.acsss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
db_export.sh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
db_import.sh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 98
kill.acsss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101
rc.acsss . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102
sd_mgr.sh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103

xvi ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Appendix B. De–installing a Second Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105


Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
De-installing a Second Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 106
Restarting ACSLS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 108

Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109

Contents xvii
9th ed., 313464701

List of Figures
Figure 1. Dual LMU Connection Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Figure 2. Configuration Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Figure 3. Defining Primary Disk Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Figure 4. Defining Secondary Disk Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
Figure 5. Defining Primary Disk Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Figure 6. Defining Secondary Disk Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
Figure 7. Format Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 71
Figure 8. Partition Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Figure 9. Partition Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
Figure 10. Second Disk Partition Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Figure 11. Partition Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 76

List of Figures xix


9th ed., 313464701

List of Tables
Table 1. Pre-Installation Worksheet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Table 2. ACSLS Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Table 3. Library Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

List of Tables xxi


9th ed., 313464701

Chapter 1. Pre–installation Preparation


Caution: You must complete the procedures in this chapter
! before installing Solaris or ACSLS.

Overview
This chapter describes how to prepare for installation of the
Solaris operating system and for installation and configuration of
ACSLS.
This chapter includes:

S Preparing for Solaris Installation


S Preparing for ACSLS Installation
S Planning ACSLS Configuration Options
S Planning Library Configuration Options
S Backing Up the Database
S Exporting the Database

Chapter 1. Pre–installation Preparation 1


9th ed., 313464701

Preparing for Solaris Installation


Before installing Solaris, complete the following steps:

1. Satisfy all requirements specified in Product Information


(see “ACSLS Online Information on the StorageTek
CRC” on page x) prior to installation of Solaris or
ACSLS.

2. Install the library hardware according to the


StorageTek installation manuals. See “Related
Documentation” on page ix.
Caution: If you are installing a SCSI library, you must
! connect the server to the library before installing ACSLS.
The 
 
 script installs device drivers and kernel
patches. If the SCSI cable is not connected, the device
driver installation fails.

3. Install the ACSLS server hardware according to the


hardware manufacturer’s instructions.

4. Determine and record information about network


communication settings in the Your System Values
column in Table 1. “Pre-Installation Worksheet.”
Caution: Consult your system administrator for assistance
! in obtaining this information. It is critical that this
information is correct in order for ACSLS to run properly.

2 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Table 1. Pre-Installation Worksheet


Installation Options Your System Values
- Host Name
- Network Adapter
- Internet Protocol Address
- Name Service
- Network Mask
- Domain Name
- Gateway Address
- Name Server
- Subnets
- System Type
- Software Group

Chapter 1. Pre–installation Preparation 3


9th ed., 313464701

Preparing for ACSLS Installation


Before you install ACSLS, complete the following steps:

1. Verify that the server system hardware is properly


configured, connected, powered on, and ready.

2. If your installation includes a 9300 or 4400 library and


a single LMU:
a. Connect the LMU to serial port-b, reserving port-a
for a remote service modem.
b. If a modem is not used, connect both serial ports to
the LMU for redundant communications.

3. If your installation includes a 9300 or 4400 library and


dual 9330 LMUs:
a. Refer to Serial Parallel Controller User’s Guide
(Sun P.N. 800–6573–12) for installation instructions
of the serial parallel controller card and connection of
the serial patch panel.
b. Attach the serial patch panel to the SBus slot on the
server.
c. From the serial patch panel, run 2 cables to each
LMU (see Figure 1).

LMU
...........................

SPARCStation-5

Serial Patch Panel


LMU

Figure 1. Dual LMU Connection Configuration

4 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

4. If your installation includes a SCSI library and:


a single-ended S Verify proper SCSI cable terminator
SCSI interface attachment.
Make sure that the cable does not exceed
2 meters between the server and the SCSI
library.
Note: The single-ended configuration
allows the LSM to connect to the host
system bus. Noises on the system bus can
corrupt data bound for the system disk.
Common sources of spurious noise should
be avoided, including:
Hot plugging devices on the SCSI bus.
Attaching cables that are not actively
terminated.
Powering down an attached peripheral
while UNIX is running.
S Verify the proper SCSI target address.
Consult the appropriate SCSI hardware
operator ’s guide for setting this address on
the LSM.
S Set the 97 library at SCSI target 0,
target 2, or target 5 for a standard Solaris
platform.
Typically, target 1 is reserved for a second
disk, target 3 is reserved for a boot disk,
target 4 is reserved for an external tape
device, target 6 is reserved for a
CD-ROM, and target 7 is reserved for a
SCSI controller.
Note: If 1, 3, 4, 6, or 7 are already
reserved on your system, use 0, 2, or 5 for
your 97 library.
a differential S Verify proper SCSI cable terminator
SCSI interface attachment.
Make sure the cable does not exceed 20
meters.

Chapter 1. Pre–installation Preparation 5


9th ed., 313464701

5. Make sure that each attached LMU and LSM is fully


configured, powered on, and ready.
xxxxx Note: The configuration script, 

* , will fail


xxx
unless all LMUs and LSMs are fully configured, powered
on, and ready.

6. Verify the SCSI library connection by doing the


following at the boot PROM environment:
    
  
  !"  #     
$  

%   %   &'  (
   
 %      %
  " $
)  *+',   $      !"
      %     #   
$   !"  

7. Obtain the ACSLS 6.0 CD-ROM.

8. If you intend to use removable media for database


backup, have a blank cartridge available for your
backup tape device to complete the configuration
process.

6 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Planning ACSLS Configuration Options


Figure 2 shows the Configuration menu. Descriptions of the
ACSLS configuration options 1 through 5 are found in Table 2.
The Valid Selections column shows valid values for the option,
with defaults shown in bold. Record the value you will use in
the Your Site’s Selection column for reference when you
configure ACSLS using the procedures on page 58.

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: Exit

Figure 2. Configuration Menu

Chapter 1. Pre–installation Preparation 7


9th ed., 313464701

Table 2. ACSLS Configuration Options


Configuration Option Option Type Valid Your
Choice Group Prompt Description Selections Site’s
Selection
+  ,    Maximum times Dynamic 5
  
 the CSI will
)  
 , retransmit a
 message
 

 
-./
+  , 0 1   Maximum timeout Dynamic 172800 sec-
  

interval for onds
)  
  pending requests 600 to
 

 in CSI request 315360000
,  
 queue seconds
  
-+23455/
+  ,    Minimum timeout Dynamic 4
 

interval between
)  
 CSI attempts to



) establish a

-6/ network
connection
+  ,   
 CSI acts as a TCP Static TRUE
  
  RPC server ((') FALSE
)  
 (  or not (7!)

 
  
 
  


 
,

 

 
(  

 
-('/

8 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Table 2. ACSLS Configuration Options


Configuration Option Option Type Valid Your
Choice Group Prompt Description Selections Site’s
Selection
+  ,   
 CSI acts as a UDP Static TRUE
    RPC server ((') FALSE
)  

   or not (7!)
'& 
 
  
 
  


 
,

 

 
'& 

 
-('/

Chapter 1. Pre–installation Preparation 9


9th ed., 313464701

Table 2. ACSLS Configuration Options


+  ,   
 Selecting the Static IF_DUAL_
    !9!: option LAN_NOT_
)  

   means that the port ENABLED
   mapper should ALWAYS
  always be
   interrogated when NEVER
  the CSI is unable
  
to send a message

  to a client.
   Selecting the
  ; option
8!9!:  means that the port
;  mapper should
,7*&'!*!* never be
<(*!=&> interrogated when
-,7*&'!*!* the CSI is unable
<(*!=&/ to send a response
to a client. This
option should be
selected if clients
don’t support a
port mapper. The
default value
IF_DUAL_
LAN_NOT_
ENABLED
specifies that the
port mapper
should be
interrogated only
if dual LAN
support has not
been enabled. If
dual LAN support
has been enabled,
then it is assumed
that clients don’t
support a port
mapper. Choosing
this option
provides for
backward
compatibility in
the product
behavior.

10 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Table 2. ACSLS Configuration Options


Configuration Option Option Type Valid Your
Choice Group Prompt Description Selections Site’s
Selection
3  )    Number of Dynamic 9
  )  rollover event log 0–9
)  

 files; see
  -?/ “Specifying
Options for Event
and Statistic Logs”
on the following
pages.

3  )   
 Pathname for Static $ACS_HOM
     directory E/log
)  
# containing the
  event log
  
 
  


 
9 
#

 
 
 
 
-@! *A<0
 /
3  ) 0 1  Maximum event Dynamic 500
   # log size (Kb); see 32 or more
)  

) ) “Specifying

B  Options for Event
C#
and Statistic Logs”
8D+555 on the following
#
> pages.
-.55/
3  ) &  Date and time Dynamic The E:
     format for all variable can
)  
 
ACSLS logs and specify
-E:FEFE command and 4–digit year
EAE0E/ utility output formats,
which is the
default

Chapter 1. Pre–installation Preparation 11


9th ed., 313464701

Table 2. ACSLS Configuration Options


Configuration Option Option Type Valid Your
Choice Group Prompt Description Selections Site’s
Selection
G    Specifies if Dynamic OFF
   # volume statistics <
  ;  are logged.
 )  

Logging these
)  
$  statistics can take
8<<77> considerable disk
-<77/ space; see
“Specifying
Options for Event
and Statistic Logs”
on the following
pages.
G     Number of Dynamic 9
  

*
 
rollover statistics 0–9
   
 log files; see
 )   -?/ “Specifying
)  
Options for Event
and Statistic Logs”
on the following
pages.
G  0 1  Maximum Dynamic 500
   # statistics log size 32K or more
 
) (Kb); see
 ) 

*
 
“Specifying
)  

B  Options for Event
C#
and Statistic Logs”
8D+555 on the following
#
> pages.
-.55/

12 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Table 2. ACSLS Configuration Options


Configuration Option Option Type Valid Your
Choice Group Prompt Description Selections Site’s
Selection
G   Cleaning cartridge Dynamic VO-
    ordering for LID_SORT
     selection and LEAST_USE
 )   #   D
)  
 display:
-;<,&*<(/ ;<,&*<( order MOST_
by    CAPACITY
!(*'& order
from least to most
used 0<(*
!! ,(: order
from most to least
available cleaning
cycles

Chapter 1. Pre–installation Preparation 13


9th ed., 313464701

Table 2. ACSLS Configuration Options


Configuration Option Option Type Valid Your
Choice Group Prompt Description Selections Site’s
Selection
G    When option is Dynamic TRUE
  ( 
 (' and FALSE
  !    transport indicates
 ) < cleaning is
)  
8('7!> required, ACSLS
-('/ will automatically
clean the transport
before next mount
((') or not
(7!)
Note: You cannot
use the


*
configuration
program to enable
auto-cleaning for
drives attached to
SCSI–attached
LSMs. Using
ACSLS, you can
only clean these
drives by manually
mounting a
cleaning cartridge.
The LSM
hardware,
however, lets you
enable
auto–cleaning via
the LSM control
panel. For more
information, see
your LSM
documen-
tation.
G   # Initialize ACSLS Static RUN
  ) in ' or ,& IDLE
 
   state
 )
 
)  
8',&>
-'/

14 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Table 2. ACSLS Configuration Options


Configuration Option Option Type Valid Your
Choice Group Prompt Description Selections Site’s
Selection
G    
 Number of ACSLS Static 2
     persistent mount 1-10
     processes; see
 ) 


“Specifying
)  
!  Options for


ACSLS Processes”
  on the following
   pages.
 
  


 
  
 


-3/
G    H': (' specifies that Static TRUE
  

 ACSLS executes FALSE
  


queries as one or
 ) 8('7!> more persistent
)  
-('/ processes. Use the
following option
to specify the
number of query
persistent
processes; see
“Specifying
Options for
ACSLS Processes”
on the following
pages.

Chapter 1. Pre–installation Preparation 15


9th ed., 313464701

Table 2. ACSLS Configuration Options


Configuration Option Option Type Valid Your
Choice Group Prompt Description Selections Site’s
Selection
G    
 Number of ACSLS Static 2
     query persistent 1-10
    # processes; see
 ) 


“Specifying
)  
  !  Options for


ACSLS Processes”
  on the following
   pages.
 
  


 
  
 #





-3/
G    
 Maximum ACSLS Static 40
    1  transient 32 and above
     processes; see
 ) !  “Specifying
)  



Options for
  ACSLS Processes”
   on the following
  pages.
  


 
0 1 
  
! 


-65/
G    Log automatic Dynamic FALSE
    mode enters in the TRUE
   event log ((') or
 )   not (7!)
)  
 #
8('7!>
-7!/

16 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Table 2. ACSLS Configuration Options


Configuration Option Option Type Valid Your
Choice Group Prompt Description Selections Site’s
Selection
G    Log database Dynamic FALSE
  )  volume additions TRUE
    and deletions in the
 )  # event log ((') or
)  
8('7!> not (7!)
-7!/
G  &  
 Controls the Static 0-3
  
  database isolation
  )  level
 ) A  See “Specifying
1  
)  
Options for
 )
Isolation Levels”
-+/ on the following
pages.
6    
 Enable command Static FALSE


  access control TRUE


 

((') or not
)  
  (7!)
  
 
  



 
!

 

) 
 

8('7!>
-7!/
6  &  If no access Dynamic ACCESS




 control files, NOACCESS


  
enable default
)  
8!  command access
<! > (! ) or not
-! / (<! )

Chapter 1. Pre–installation Preparation 17


9th ed., 313464701

Table 2. ACSLS Configuration Options


Configuration Option Option Type Valid Your
Choice Group Prompt Description Selections Site’s
Selection
6  0


Log command and Dynamic FALSE


  volume !

TRUE
    & messages
)  


 in event log ((')


 
 or (7!)
) 



8('7!>
-7!/
.  9  # Allows you to Dynamic  or 
    change the default
   #  automatic backup If you respond
  
  schedule, which is , you are
   set to do a backup further


I every day at prompted for
8#  > midnight. the day and
Note: Automatic the time you
backups and want to have
manual backups automatic
need not be done backups.
on the same day.
.    You select the Dynamic Between 4
   period of time that and 30
     you will retain
  
   backups on local
  ,0 disk. You can

) select a period
 
 between 4 and 30
A  days. See “Setting
1   the Retention
-4/ Period” on the
following pages.

18 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Specifying Options for Event and Statistics Logs


The 

* configuration program lets you specify


options for file size and number of rollover files for the event log
( 

*)  ) and the volume statistics log


( 

*
 
 ) as follows:

S You can specify the number of rollover log files to


“journal” entries when the base log file reaches maximum
size. If you specify 0, ACSLS creates only one base log
file with no rollover files. You must manually manage this
base log file, which has no maximum size. If you specify
0 rollover log files and also specify a maximum size for
the volume statistics log, ACSLS logs warning messages
in the event log if the log file exceeds the specified
maximum size.
Alternatively, you can specify 1 to 9 rollover log files.
Rollover log files provide a history to ensure that you
capture all log entries and can more easily locate specific
log entries. For example, if you specify 2 rollover files for
volume statistics logging, when the 

*
 

(base) file reaches maximum size, ACSLS renames it to
the first rollover file ()
 
5  ), then starts a new


*
 
 file. When the 

*
 
 file
again reaches maximum size, ACSLS renames the
)
 
5  file to )
 
+  , renames


*
 
 to )
 
5  , and starts a new


*
 
 file. When all rollover files contain
data and another rollover occurs, the highest numbered
rollover file will be discarded.

S You can specify the maximum log file size; this maximum
applies to both the base log and rollover log files. If you
specify rollover log files, you can typically specify a
smaller maximum file size (that applies to both base log
and rollover files) than the maximum file size you would
specify for a base log only, which must be large enough to
contain enough meaningful entries.

Chapter 1. Pre–installation Preparation 19


9th ed., 313464701

Specifying Options for ACSLS Processes


Note that the Solaris system limit on processes per user is the
limit for the total number of the following processes:

S ACSLS system persistent


S CSI (1)
S ACSLS transient (specified via 

* )
S ACSLS query persistent (specified via 

* )
S ACSLS mount persistent (specified via 

* )
For the ACSLS transient, query persistent, and mount persistent
process options, StorageTek recommends that you accept the
default value at initial configuration, then change the value as
required. Increasing this value may improve performance.
Warning: With a minimum server platform configuration,
STOP
higher than 10 query persistent processes could use up system
resources and not allow ACSLS to start up.
If the total number of all the processes listed above exceeds the
Solaris system limit on processes per user, ACSLS may fail to
start. If this happens, either increase the system limit on
processes per user or lower one or more of the values for the
ACSLS process options that you can specify via 

* .

20 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Specifying Options for Isolation Levels


The isolation level is used to define the degree of concurrency
among processes that attempt to access the same rows
simultaneously in Informix Database. The database isolation
level affects read concurrency when rows are retrieved from the
database as in queries and volume reports. The database server
uses shared locks to support different levels of isolation among
processes attempting to access data. The update or delete process
always acquires an exclusive lock on the row that is being
modified. The level of isolation does not interfere with rows that
are being updated or deleted. If another process attempts to
update or delete rows that are being read with an isolation level
of Repeatable Read, that process is denied access to those rows.
0 – Dirty Read
Provides zero isolation. Dirty Read is appropriate for static
tables that are used for queries. With a Dirty Read isolation
level, a query might return a phantom row, which is an
uncommitted row that was inserted or modified within a
transaction that has subsequently rolled back. No other
isolation level allows access to a phantom row. Dirty Read
is the only isolation level available to databases that do not
have transactions.
1 – Committed Read (default isolation level)
Guarantees that every retrieved row is committed in the
table at the time that the row is retrieved. Even so, no locks
are acquired. After one process retrieves a row because no
lock is held on the row, another process can acquire an
exclusive lock on the same row and modify or delete data
in the row. Committed Read is the default level of isolation
in a database with logging that is not ANSI compliant.

Chapter 1. Pre–installation Preparation 21


9th ed., 313464701

2 – Cursor Stability
Acquires a shared lock on the selected row. Another
process can also acquire a shared lock on the same row, but
no process can acquire an exclusive lock to modify data in
the row. When you fetch another row or close the cursor,
the database server releases the shared lock. If you set the
isolation level to Cursor Stability, but you are not using a
transaction, the Cursor Stability isolation level acts like the
Committed Read isolation level. Locks are acquired when
the isolation level is set to Cursor Stability outside a
transaction, but they are released immediately at the end of
the statement that reads the row.
3 – Repeatable Read
Acquires a shared lock on every row that is selected during
the transaction. Another process can also acquire a shared
lock on a selected row, but no other process can modify
any selected row during your transaction or insert a row
that meets the search criteria of your query during your
transaction. If you repeat the query during the transaction,
you reread the same information. The shared locks are
released only when the transaction commits or rolls back.
Repeatable Read is the default isolation level in an
ANSI–compliant database.

22 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Setting the Retention Period


The retention period is the period of time for which you retain
backups. You should note that ACSLS 6.0 changes the backup
management from previous ACSLS releases. In previous
releases, ACSLS deleted transaction log files at the time of a
backup and reclaimed the space used for log files. In ACSLS
6.0, transaction log files are retained with each backup,
increasing the space needed in the backup partition. When
choosing a retention period, consider the following conditions
specific to your site:

S The size and activity of your library


S The number of automatic and manual backups performed
in a given period of time
xxxxx Notes:
xxx
d When you run a manual backup with the bdb.acsss
utility, an automatic backup to local disk is also
done, thereby increasing the number of backups in
the backup partition.
d The retention period should be greater than the
interval between backups. For example, if you have a
retention period of four days, you should take
automated or manual backups at least three times a
week, with no more than three days between
backups.

S The period of time for which you would like to retain


backups and transaction log files, keeping in mind that
long retention periods increase the space needed in the
backup partition.

S The size of your backup partition


For example, if you have a large library, a lot of library activity,
frequent backups, a small partition size, and your retention
period is set to the maximum, your backup partition is likely to
fill up. If your backup partition is full, the Informix database
will be unable to offload transaction logs, and all database and

Chapter 1. Pre–installation Preparation 23


9th ed., 313464701

ACSLS activity will wait until space on the backup partition is


freed up. (You are issued a warning message when the backup
partition reaches 85% full.) In this scenario, you may want to set
your retention period to a shorter period of time. In general, the
retention period should be set to an acceptable period of time for
retaining backups, but without the risk of filling up the backup
partition.

24 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Planning Library Configuration Options


Descriptions of library configuration options are found in Table
3. The Valid Selections column shows valid values for the
option, with defaults shown in bold. Record the value you will
use in the Your Site’s Selection column for reference when you
configure ACSLS using the procedures on page 58.

Table 3. Library Configuration Options

Option Prompt Option Description Valid Selections Your Site’s Selection


   ! 
 Specifies the number A number between 1

 of ACSs in the library and 127
configuration.
   Number of A number between 1

 !  connections to each and 16,
 ACS. This prompt typically 1 or 2
appears for each (1 for SCSI devices)
configured ACS. You
must specify at least
one connection per
ACS.
&)   " !  Full path name of the Recommended path
 )  device attached to a names:
port. This option Solaris platform:
appears for each port
in the library. )#
)#
)  
( can be 0 to 15)

Chapter 1. Pre–installation Preparation 25


9th ed., 313464701

Where To Go Next?
The remainder of this chapter contains procedures to complete
pre-installation preparation. These procedures include:

S Backing Up the Database


S Exporting the Database
Complete these procedures only if you are upgrading from a
previous version of ACSLS. If you are doing a new installation
of ACSLS, skip this section and go to Chapter 2.

26 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Backing Up the Database


Hint: Doing a backup prior to upgrading or switching platforms
is for disaster recovery in the event that there is a need to return
to the current state.
You will need two blank tapes, one for this backup procedure
and one for the export procedure following it.
The following procedure describes how to shut down ACSLS
and back up your existing database to tape.

To back up the database:

1. Open a command tool and log in as 

2. From the cmd_proc window, idle ACSLS.



Wait for the following message before you proceed.
)
#
 

3. Open another command tool and log in as 

4. Shut down ACSLS.



  

5. Load a blank cartridge into the drive.

6. To back up the database, enter


$$  

7. Remove the cartridge from the drive after the program


finishes.
Caution: You will lose files if you remove the cartridge
! before the program finishes. Write protect the cartridge
and clearly mark it to identify the contents as the backed
up database.

Chapter 1. Pre–installation Preparation 27


9th ed., 313464701

Exporting the Database


This section describes how to migrate the database table data of
a previous version of ACSLS to ACSLS 6.0. See ACSLS
Product Information for information about which previous
versions of ACSLS are upgradable to 6.0. The *1

utility creates an ASCII representation of the database on tape.
It is used by *
 at the time of an upgrade to transfer
existing data instead of auditing a library.
The procedures outlined below are for exporting the database to
tape for default tape devices.
Hint: Refer to Appendix A for instructions on exporting the
database to disk.
Warning: You must use the *1
 and *

STOP
utilities if you are upgrading to ACSLS 6.0. Refer to
Appendix A “Utilities” for more information about using these
utilities.

1. From a command tool log in as 

2. From the * window, idle ACSLS:




3. Open another command tool and log in as 

4. Shut down ACSLS:



  

5. Shut down the database:


$-       & (  . / 0 
1 
$-        & (  . 2

6. Insert a blank tape into the default tape device.

28 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

7. Start the *1


 utility:
$- 3 
As it executes, the utility displays output indicating
successful table data being exported.

8. Remove the cartridge from the drive only when the


program completes and the prompt re-appears.
Caution: You will lose files if you remove the cartridge
! before the program completes the backup. Write protect
the cartridge and clearly mark it to identify the contents as
the exported database.

Chapter 1. Pre–installation Preparation 29


9th ed., 313464701

Chapter 2. Installing and Configuring Solaris


ACSLS 6.0 supports Solaris 7 and 8. StorageTek does not
support down level versions of the operating system. This
chapter describes separate procedures for configuring Solaris 7
and Solaris 8 for ACSLS.

S To install Solaris 7, go to page 32


S To install Solaris 8, go to page 41
Hint: Solaris 7 works in 64-bit support. Solaris 8 works only in
32- bit support.
Warning: Before installing Solaris, you must complete Chapter
STOP
1 “Pre-installation Preparation.”

Chapter 2. Installing and Configuring Solaris 31


9th ed., 313464701

Installing the Solaris 7 Operating System


Hint: While installing the Solaris operating system, refer to
Table 1. “Pre-Installation Worksheet” on page 3 for the network
communication settings recorded during pre-installation
preparation.

To install the Solaris 7 operating system:

1. Boot your system from the CD–ROM containing the


Solaris operating system:
a. Press STOP+A.
b. Insert the Solaris CD-ROM into the CD-ROM drive.
c. From the  prompt, enter
$ 

Press ENTER.
xxxxx Note: If you have configured the SCSI/Ethernet card on
xxx
an Ultra 10 and you are not using the second Ethernet
connection, then disregard the message, “home1: link
down”.
Hint: The  
,
  
 will appear first.
During the installation process, this console provides
messages indicating what the system is doing.

2. Select Language and Locale options, and press


 .
Within five minutes the  
,
     
screen displays.

3. Press   twice to get to the A


   screen.

4. Enter the Host Name for your system and press


 .

5. Answer :
to the prompt  :
 and
press  .

32 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

6. Does your system have multiple networked Ethernet


controller systems?
YES At the prompt, specify which network adapter
(usually 5 for a SPARC 5 or 5 for an Ultra
10) is the system’s primary network interface.
Press  .
Go to Step 7.
NO Go to Step 7.

7. Enter your IP address and press  .

8. Confirm the A
  , I, and , 

in the  ,  screen, and press


 .

9. Select the type of name server used in your system in


the   ) screen, and press  .
xxxxx Note: Do not select the ,J or , services unless your
xxx
system administrator can configure these services correctly.

xxxxx Note: If either ,J or , is selected, a number of


xxx
different prompts appear. Respond to these prompts
appropriately.

10. Confirm the   ) in the 


,  screen, and press  .

11. Select #
in      screen.
Enter your netmask and press  .

12. Select :
or  in the  
screen.
If you selected :
, the 
 screen appears. Enter
your Netmask and press  .

13. Specify your timezone type in the ( K screen and
click .

Chapter 2. Installing and Configuring Solaris 33


9th ed., 313464701

14. Enter the current date and time in the &   (
screen and press  .

15. Press   on the  ,  screen.


The  
, ) ,
   screen
displays.

16. The first  


, ) ,
   screen
describes the differences between an initial installation
and a Solaris upgrade.

17. Press , .

18. The second  


, ) ,
  
screen describes what occurs during an initial install.
Press  .

19. Press   on the !   )

screen.

20. Press   on    


screen.

21. Select  '


 #
   in the 
  screen, and press
B .
The
B   screen appears displaying the
  

   
window.
xxxxx Note: Steps 22 through 25 refer to customization of the
xxx
  

   
window in the

B   screen.

34 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Hint: In the   



   

window, an item is selected when the square preceding it is


completely blacked out. Some items may already be
selected by the system. Make sure that you do not deselect
these items by clicking on items already blacked out.

Deselected Partial Selected Selected

22. Scroll down and locate <F 0    


in the
  

   
window. Click once
to select the 0   
.

23. Continue scrolling down and locate <9

;
 G in the   

   

window. Click twice to fully select that option.

24. Continue to scroll down through the main directory to


   
  
.
a. Click on the triangular arrow (  
 
)
in the left margin of    

 
to expand the subdirectory.
b. Select  
    <.
c. Click on the triangular arrow (  
 
)
in the left margin of    

 
to close the subdirectory.

25. Press <C to exit the


B   screen.

26. Press <C on the warning box.

27. Press   when the    screen


displays.
The  &

screen displays.

Chapter 2. Installing and Configuring Solaris 35


9th ed., 313464701

28. If the boot disk is displayed in the !)   &




window, select it, then press the single-right-arrow


button to move it to the “Selected disks” column.

29. Press   on the  &



screen.
The 
) &  screen displays.

30. Press   for a new installation and/or to


overwrite current file systems and unnamed file
systems. (Press 
) to preserve existing data
during an upgrade installation.)

31. Press 0    #  in the !   #  # 


7 #

I screen.

32. Press
B in the 7 #
  &
  # 
screen to define disk partitions for ACSLS.
The
B &

screen displays.

36 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

33. Define two disk partitions for the database.


xxxxx Note: The product is designed for ACSLS to reside in
xxx
1. If you install ACSLS in another directory,
every command you enter that uses 1 must be
changed to that directory. However, 1 must
still exist because the database installs all its files in that
directory.

Enter the values specified in bold in Figure 3 to define


primary disk partitions for the database:
d Assign the mount point for each of the eight
partitions in the left column.
d Assign the size for each slice in the right column
except for 1.
Do not make  any smaller than 50 MB.
Swap space must be no smaller than 300 MB.
The size of 
 must be at least 700 MB.
1 must be at least:
550 MB for a 2.1 GB disk
800 MB for a 9 GB or larger disk
For information about determining the size of your
primary and secondary disks, see ACSLS Product
Information, “Determining Disk Size Requirements”.
d Assign 1   last. Assign
1   the amount displayed in 7
after entering all other values. You should have no
less than:
400 MB for a 2.1 GB disk
6 GB for a 9 GB disk
~25 GB for a 27 GB disk

Chapter 2. Installing and Configuring Solaris 37


9th ed., 313464701

Disk: c0t0d0
0 / .4 5

1 1 /44 5

2 (  Based on disk size

3 7( 24 5

4 7 37 Based on disk size

5 7 24 5

6 7 644 5

7 7 37$
 Based on disk size

Capacity: disk size


Allocated: MB or GB
Free: MB or GB

Figure 3. Defining Primary Disk Partitions

Enter the values specified in bold in Figure 4 to define


secondary disk partitions for the database.
d Assign 256 MB to 
*
 for all disk sizes.
d 
*
   should be at least:
~1.7 GB for a 2.1 GB disk
~8.7 GB for a 9 GB disk
~26.5 GB for a 27 GB disk

38 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Disk: c0t1d0
0 
*
 0.8 5

1 
*
   Based on disk size

2 )  Based on disk size

Capacity: disk size


Allocated: MB or GB
Free: MB or GB

Figure 4. Defining Secondary Disk Partitions

34. Press <C after you have filled out the


B &


screen.
The 7 #
  &
  #  screen appears.

35. Are the file systems and disk layout correct in the 7
#
  &
  #  screen?
YES Press   to accept the layout displayed.
NO Press
B to change the file system or
layout information.

36. Press   in the 0   7 #



I
screen.

37. Verify that the  screen displays the


configuration that you want and press = 
,
  .

38. Press !   in the next screen.


The installation process takes from 30 minutes to 2 hours
depending on the speed of the CD–ROM drive. The
system activities can be monitored by following the
messages in the  
,
  
 and by the
,
   
  "  

screen,
which shows the progress with a sliding bar.

Chapter 2. Installing and Configuring Solaris 39


9th ed., 313464701

39. When the installation is complete, the system reboots


and prompts for a password. Enter a password.
Reenter the same password at the prompt to verify.
The system then returns to the login prompt.

40. Log in as .

41. Press  to the question & #   


 
F )
 I

42. In a command tool, enter


9  

43. Remove and store the CD–ROM.


Complete the installation by editing the 

file to add
the name of the host(s) and the IP address(es).

44. Change directories to the /etc directory.


 7 

45. Edit the 



file: add the name of each client and the
IP address of each client to the end of the file.

46. At the system prompt enter % 


to verify the
following:
d The total KB space available is at least 550000 for
the 1 file system for the database.
1 will contain the contents of the
installation media. See Step 33 for suggested sizes of
1 for different disk sizes.
d The total space available for 1   is at
least 400000 KB for the database. See Step 33 for
suggested sizes of 1   for different disk
sizes.

40 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Installing the Solaris 8 Operating System


Hint: While installing the Solaris operating system, refer to
Table 1. “Pre-Installation Worksheet” on page 3 for the network
communication settings recorded during pre-installation
preparation.

To install the Solaris 8 operating system:

1. Boot your system from the CD–ROM containing the


Solaris operating system:
a. Press STOP+A.
b. Insert the Solaris CD-ROM ( 
4  )
into the CD-ROM drive.
c. From the  prompt, enter
$ 

Press ENTER.
xxxxx Note: If you have configured the SCSI/Ethernet card on
xxx
an Ultra 10 and you are not using the second Ethernet
connection, then disregard the message, “home1: link
down”.
Hint: The  
,
  
 will appear first.
During the installation process, this console provides
messages indicating what the system is doing.

2. Select Language and Locale options.


Within five minutes the  
,
     
screen displays.

3. In the  )# screen, select #


and
then  .

4. In the &A  screen, select  and  .

5. In the  #  ,  screen, select 5


and then  .

Chapter 2. Installing and Configuring Solaris 41


9th ed., 313464701

6. In the A
   screen, enter the Host Name for your
system and press  .

7. Enter your IP address and press  .

8. Select  to enable IPv6 and press  .

9. Confirm the A
  , I, and , 

in the  ,  screen, and press


 .

10. Select  for    # # and press


 . Then confirm security information.

11. Select the type of name server used in your system in


the   ) screen, and press  .
xxxxx Note: Do not select the ,J or , services unless your
xxx
system administrator can configure these services correctly.

xxxxx Note: If either ,J or , is selected, a number of


xxx
different prompts appear. Respond to these prompts
appropriately.

12. Confirm the   ) in the 


,  screen, and press  .

13. Select #
in      screen.
Enter your netmask and press  .

14. Select :
or  in the  
screen.
If you selected :
, the 
 screen appears. Enter
your Netmask and press  .

15. Specify your timezone type in the ( K screen and
click .

16. Enter the current date and time in the &   (
screen and press  .

42 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

17. Press   on the  ,  screen.


The  
, ) ,
   screen
displays.

18. The first  


, ) ,
   screen
describes the differences between an initial installation
and a Solaris upgrade. Press , .

19. The second  


, ) ,
  
screen describes what occurs during an initial install.
Press  .

20. Select your regions in the  $    

screen and press  .

21. Select  '


 #
   in the 
  screen.

22. Deselect   ,   


L6 =  
to enable 32 bit support. The box is light when it is
deselected.

23. Press
B .
The
B   screen appears displaying the
  

   
window.
Hint: In the   

   

window, an item is selected when the square preceding it is


completely blacked out. Some items may already be
selected by the system. Make sure that you do not deselect
these items by clicking on items already blacked out.

Deselected Partial Selected Selected

24. Scroll down and locate <F 0    


in the
  

   
window. Click once
to select the 0   
.

Chapter 2. Installing and Configuring Solaris 43


9th ed., 313464701

25. Continue scrolling down and locate <9

;
 G in the   

   

window. Click twice to fully select that option.

26. Continue to scroll down through the main directory to


   
  
.
a. Click on the triangular arrow (  
 
)
in the left margin of    

 
to expand the subdirectory.
b. Select  
    <.
c. Click on the triangular arrow (  
 
)
in the left margin of    

 
to close the subdirectory.

27. Press <C to exit the


B   screen.

28. Press   when the    screen


displays.
The  &

screen displays.

29. If the boot disk is displayed in the !)   &




window, select it, then press the single-right-arrow


button to move it to the “Selected disks” column.

30. Press   on the  &



screen.
The 
) &  I screen displays.

31. Press   for a new installation and/or to


overwrite current file systems and unnamed file
systems. (Press 
) to preserve existing data
during an upgrade installation.)

32. Press 0    #  in the !   #  # 


7 #

I screen.

33. Press
B in the 7 #
  &
  # 
screen to define disk partitions for ACSLS.
The
B &

screen displays.

44 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

34. Define two disk partitions for the database.


xxxxx Note: The product is designed for ACSLS to reside in
xxx
1. If you install ACSLS in another directory,
every command you enter that uses 1 must be
changed to that directory. However, 1 must
still exist because the database installs all its files in that
directory.

Enter the values specified in bold in Figure 3 to define


primary disk partitions for the database:
d Assign the mount point for each of the eight
partitions in the left column.
d Assign the size for each slice in the right column
except for 1.
Do not make  any smaller than 50 MB.
Swap space must be no smaller than 300 MB.
The size of 
 must be at least 700 MB.
1 must be at least:
550 MB for a 2.1 GB disk
800 MB for a 9 GB or larger disk
For information about determining the size of your
primary and secondary disks, see ACSLS Product
Information, “Determining Disk Size Requirements”.
d Assign 1   last. Assign
1   the amount displayed in 7
after entering all other values. You should have no
less than:
400 MB for a 2.1 GB disk
6 GB for a 9 GB disk
~25 GB for a 27 GB disk

Chapter 2. Installing and Configuring Solaris 45


9th ed., 313464701

Disk: c0t0d0
0 / .4 5

1 1 /44 5

2 (  Based on disk size

3 7( 24 5

4 7 37 Based on disk size

5 7 24 5

6 7 644 5

7 7 37$
 Based on disk size

Capacity: disk size


Allocated: MB or GB
Free: MB or GB

Figure 5. Defining Primary Disk Partitions

Enter the values specified in bold in Figure 4 to define


secondary disk partitions for the database.
d Assign 256 MB to 
*
 for all disk sizes.
d 
*
   should be at least:
~1.7 GB for a 2.1 GB disk
~8.7 GB for a 9 GB disk
~26.5 GB for a 27 GB disk

46 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Disk: c0t1d0
0 
*
 0.8 5

1 
*
   Based on disk size

2 )  Based on disk size

Capacity: disk size


Allocated: MB or GB
Free: MB or GB

Figure 6. Defining Secondary Disk Partitions

35. Press <C after you have filled out the


B &


screen.
The 7 #
  &
  #  screen appears.

36. Are the file systems and disk layout correct in the 7
#
  &
  #  screen?
YES Press   to accept the layout displayed.
NO Press
B to change the file system or
layout information.

37. Press   in the 0   7 #



I
screen.

38. Verify that the  screen displays the


configuration that you want and press = 
,
  .

39. Press !   in the next screen.


The installation process takes from 30 minutes to 2 hours
depending on the speed of the CD–ROM drive. The
system activities can be monitored by following the
messages in the  
,
  
 and by the
,
   
  "  

screen,
which shows the progress with a sliding bar.

Chapter 2. Installing and Configuring Solaris 47


9th ed., 313464701

40. When the installation is complete, the system reboots


and prompts for a password. Enter a password.
Reenter the same password at the prompt to verify.
The system then returns to the login prompt.

41. Log in as .

42. Press  to the question & #   


 
F )
 I

43. In a command tool, enter


9  

44. Remove and store the CD–ROM.


Complete the installation by editing the 

file to add
the name of the host(s) and the IP address(es).

45. Change directories to the /etc directory.


 7 

46. Edit the 



file: add the name of each client and the
IP address of each client to the end of the file.

47. At the system prompt enter % 


to verify the
following:
d The total KB space available is at least 550000 for
the 1 file system for the database.
1 will contain the contents of the
installation media. See Step 33 for suggested sizes of
1 for different disk sizes.
d The total space available for 1   is at
least 400000 KB for the database. See Step 34 for
suggested sizes of 1   for different disk
sizes.

48 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Chapter 3. Installing and Configuring


ACSLS

Warning: Before installing ACSLS 6.0, you must:


STOP
1. Export the database, if this is an upgrade installation (see
Chapter 1)
2. Install and configure Solaris (see Chapter 2)
xxxxx Note: StorageTek does not support ACSLS 6.0 running on
xxx
unsupported versions of the operating system. ACSLS 6.0
supports Solaris 7 and 8 only.

3. Do the following before installing ACSLS if you are


upgrading from ACSLS 5.3, 5.3.2 or 5.4 and you already
had Solaris 7or 8 installed:
Remove group and user IDs on page 50 from the 
directories.

Chapter 3. Installing and Configuring ACSLS 49


9th ed., 313464701

Overview
This chapter describes how to install and configure ACSLS on a
Solaris platform. It includes:

S Removing group and user IDs


S Verifying disk space
S Installing ACSLS
S Configuring ACSLS
S Troubleshooting Library Connections

Removing Group and User IDs


Before you install ACSLS 6.0, you must remove certain group
and user IDs if you are upgrading from ACSLS 5.3, 5.3.2, or 5.4
and you already had Solaris 7 or 8 installed.

To remove the IDs:

1. Log in as root.

2. Bring up the Administration Tool by entering:


 
An interactive window displays.

3. From the menu select Browse –> Users

4. Check for the value 11 under the '


 ,& column.
Scroll down if necessary.

5. If you find 11 and you decide to delete, select


Edit –> Delete.

6. From the menu select Browse –> Groups.

50 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

7. Check for the value 106 under the Group ID column.


Scroll down if necessary.

8. If you find the value 106 and you decide to delete, select
Edit –> Delete.

9. From the menu select File –> Exit to exit the tool.

10. Reboot the server.

11. Go to “Verifying Disk Space” on page 51.

Verifying Disk Space


Before installing ACSLS, verify that the hard disk was
partitioned appropriately when the operating system was
installed and configured.

To verify disk partitions:

1. At the system prompt enter % 


to verify the
following:
d The total KB space available for the 1
file system, where ACSLS will reside, is at least:
550000 KB for a 2.1 GB disk
800000 KB for a 9 GB disk
800000 KB for a 27 GB disk
d The total KB space available for 1   is
at least:
400000 KB for a 2.1 GB disk
6000000 KB for a 9 GB disk
25000000 KB for a 27 GB disk

Chapter 3. Installing and Configuring ACSLS 51


9th ed., 313464701

Installing ACSLS
To install ACSLS:

1. Log in as .

2. Is this a new installation?


YES Go to Step 9.
NO Make sure you exported the database in Chapter 1.
Complete Steps 3, 4, 5, 6, and 7 below.
Then continue with Step 9.

3. Deinstall second disk support:


See Appendix A of this book for instructions.

4. Shut down ACSLS and the database:


 8from a cmd_proc)

   (from a command tool)
If you are upgrading from ACSLS 5.3 or 5.3.2, enter the
following command:
$-   
If you are upgrading from ACSLS 5.4, enter the following
command:
$-    

5. Enter the following:


 7 37
If you installed ACSLS in another directory other than
/export/home, cd to that directory.

52 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

6. Remove ACSLS files and database files:


If you are upgrading from ACSLS 5.3 or 5.3.2:
d Enter:  % &  
d cd to 1   and enter:  %  
If you are upgrading from ACSLS 5.4:
d Enter:  % & $
d cd to 1   and enter:  % $
If you are upgrading from 5.3, 5.3.2, or 5.4:
d cd to 
*
   and remove all
directories there

7. Reboot by entering:
 $

8. Log in as .

9. Insert the ACSLS 6.0 CD-ROM.


xxxxx Note: If the Solaris operating system CD or the Solaris
xxx
CDE CD is still in the drive, enter 9   . Remove
the CD and store it.

10. In a terminal window or at the system prompt, enter


 7  7  47  4

Chapter 3. Installing and Configuring ACSLS 53


9th ed., 313464701

11. To initiate the installation shell script, enter


7 
If shared memory settings have not been defined, you are
prompted to allow the script to set shared memory and
reboot the server:
(

) 

 
  #
   !    &  


  #   
)   
   )I 8#  >
Respond  to the prompt.
The server reboots.
When the server comes back, log in as  and restart
install.sh.
The shell script completes processing in ten to twenty
minutes.

12. If you installed Solaris 8, you may get this message:



 
 +.6? 9    
. 4  # 

 " #
       
       
Ignore the message if you installed Solaris 8 with 32–bit
support and proceed with the ACSLS installation.

13. Enter  or  at the prompt to install ACSLS in the


default directory 1.
Use the default directory 1 or enter the
directory where you want ACSLS installed.
xxxxx Note: If you install ACSLS in a directory other than
xxx
1, every command you enter that uses
1 must be changed to that directory.

54 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

14. Press ENTER to accept the default directory


1   for database backups.
Caution: During this time the CD drive may appear idle,
! without sound or flashing lights. DO NOT remove the
CD from the drive until the installation is complete.

15. Respond  or  to the prompt for automatic startup on


reboot.
& #   # 
#
  
   
 
M    # 
 

! I 8#  >

Building the mchanger Driver (Steps 16 and 17)

16. Respond (y or n) to the prompt for installing a SCSI


device driver for SCSI libraries.
& #    
  

 ) )
  ,  
I 8#  >

YES The following message displays:


   , )8
>   

    #    )


  81  6 . L>     ,
)
  
 5  +.
Notes:
S On most Solaris machines, target-7 is not a valid
device address because target-7 is reserved for
the SCSI initiator on the host-bus adapter.
S If you are not sure what numbers to enter in this
Step, follow the procedure in Step 6 of the
section “Preparing for ACSLS Installation” in
Chapter 1.
Continue with Step 17.
NO Go to Step 19.

Chapter 3. Installing and Configuring ACSLS 55


9th ed., 313464701

17. Respond (y or n) to the prompt after the specified SCSI


device numbers display.
,

I 8#  >

18. You see the following message:



 
 +.5+ :    




  
 #   ',N
  O 1! 
 P

* 
Q
You can enable second disk support after you complete the
procedures in this chapter. See Chapter 4 for steps on
enabling second disk. See Appendix B for steps on
disabling second disk support.

19. Respond  or  to the prompt for adding a modem.


9  #     
  
)# I 8#  >
StorageTek recommends that you attach a modem.

20. Enter  to the following prompt for rebooting:


,      
     

#
 
    I 8#  >
Warning: You must reboot for kernel changes to take
STOP
place and in order to configure and run ACSLS.

21. Log in as .

22. Enter
9  

23. Remove and store the ACSLS 6.0 CD-ROM.


Warning: Installation is not complete at this point.
STOP
Complete this chapter and Chapter 4 to ensure that all
necessary procedures are done prior to running ACSLS.

56 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Applying Maintenance to ACSLS


Before you configure ACSLS, please check the StorageTek CRC
web page to see whether there is any maintenance for this
release. If there is any maintenance, please download it and
apply the most current PUTs, SPEs, or PTFs.
To apply the maintenance, refer to the installation instructions in
the associated PUT or SPE or PTF document included with the
PUT CD–ROM, or the document associated with the
maintenance tar file on the StorageTek Customer Resource
Center (CRC) web page.

Chapter 3. Installing and Configuring ACSLS 57


9th ed., 313464701

Configuring ACSLS

To configure ACSLS:

1. Exit from the desktop.

2. Log in as 

3. At the password prompt, press ENTER.

4. Shut down ACSLS if it is running.



  
xxxxx Note: If subsequent system messages indicate that the PID
xxx
file does not exist, this means that ACSLS was not
running.

5. To run the configuration script, enter


 - %
The !        screen appears.
xxxxx Note: The configuration script, 

* , will fail


xxx
unless all LMU’s, LSM’s, and transports are fully
configured, powered on, and ready.

6. Do you want to custom configure ACSLS?


YES Go through each item of the menu, selecting
options 1 through 6, and enter the variable informa-
tion referring to Table 2. on page 8.
NO Go to Step 7.

7. Select 2 to exit the menu and continue the


configuration process.
The script displays progress messages during database
creation. This takes about five minutes.

58 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

8. Enter  at the following prompt:


   #   
I 8#>

9. Do you want to reconfigure the library?


YES Enter  at the following prompt:
 #
)   
 1

  
)M  I 8#  >
and continue with Step 10.
NO Enter  at the following prompt:
 #
)   
 1

  
)M  I 8#  >
and continue with Step 14.

10. Enter the number of ACSs that will be supported at


your site. (See Table 3, “Library Configuration
Options.”)
   ! 
 

You must answer at least : to this prompt. Hardware must
be installed to support one or more ACSs.

11. Enter the number of connections to your ACS.


   
 !  R

12. Enter the device name for each connection. (See Table
3, “Library Configuration Options.”)
&)   " ! RM ) R
Example device names for 4400 or 9300 libraries
&)   " !  R5M ) R5 7 (7
&)   " !  R5M ) R+ 7 (7$

Example device name for SCSI library


&)   " !  R+M ) R5 7 (7  0

Chapter 3. Installing and Configuring ACSLS 59


9th ed., 313464701

xxxxx Note: The device name is assigned during ACSLS


xxx
installation when the SCSI device number is entered.

13. The installation script verifies that each defined port


communicates with an LMU or SCSI LSM.
If communication is verified, you see messages similar to
the following:
  

)## 
     0'   
) ++
)  . 
     0 (C
?265 ) +?.5
If communication is not verified, you see messages similar
to the following before the program exits:
  

)# 
      0'
)  . 
     0 (C
?265 ) +?.5
   
        
    #    #   
     #  
#  1
Refer to the section “Troubleshooting Library
Connections” at the end of this chapter and follow
procedures there.

60 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

xxxxx Note: If you are using 9840 10– or 20–drive panels, you
xxx
must have Compatibility Level 12 LMU microcode
installed. If you have Compatibility Level 11 and 12 or
Compatibility 6 LMUs, you receive the following
message:

  



)# 
     0'   
) ++
)# 
     0'   
) +3
!    ) 1

  "+3
 #     
(
   

      

 
+5")  35")  
  #
 # 6")  

 
 #I 8#  >
If you respond #, the old panel files will be used. If you
respond , the configuration routine will exit with the
message:
( 
)  M 
   
)"+3     # 
xxxxx Note: If you are running Compatibility Level 6 on a 4430
xxx
LMU, you must upgrade your library hardware to include a 9330
LMU.

14. Enter  at the following prompt to build/verify the


library configuration.
(

  
  
    # 
  #      
=  M  
   # 
 # 
#  M   


#

      
= ;#  #   I
8#  >

Chapter 3. Installing and Configuring ACSLS 61


9th ed., 313464701

15. Have you previously configured the system?


YES Enter  at the following prompt:
 #
)   
 1

  
)M  I 8#  >
As the script builds the library configuration, it
displays the following message for each panel in
each LSM.
!  R M 0 R M ! R M  
The script also generates a library configuration
report and appends it to the following file:
1!   

* 
NO Continue with Step 16.

16. Respond ( or ) when the system asks whether to


configure client system interfaces.
  
#
  
I
8#  >
YES The following message displays:
,  (,< (!=
+> <! ,  
3> <  , ! #


& #        ,

  8>

If , the following message appears:


 <! , 8>
ONC/RPC is always selected.
NO Continue with Step 17.

62 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

17. Are you backing up the database to tape (for


reconfiguring ACSLS only)?
Hint: At this point in the configuration, StorageTek
recommends that you back up the database to a tape that
can be stored offsite and used, if needed, for disaster
recovery of the database.
YES Insert a blank tape when the following message
displays:

     
   
,
   
     


('   
The database backup procedure  

automatically executes and captures the


configuration data to enable database journaling.
When the database backup is completed, the
following message displays:
&  
   


 # 
NO Press CTRL+ C and refer to  

on page
93 in Appendix A to back up the database to disk
file. This completes this procedure.

Caution: The tape drive may appear idle during the


! backup. It may not make any sounds or flash any lights
during this time. DO NOT remove the tape from the drive
until you see the following success message indicating the
backup is complete:

&  
   


 # 
Warning: Interrupting the backup process before
STOP
completion will cause a corrupted backup file or tape.

18. Remove the tape and store it in a safe place.


Warning: Installation is not complete at this point. Complete
STOP
this chapter and Chapter 4 to ensure that all necessary
procedures are done prior to running ACSLS.

Chapter 3. Installing and Configuring ACSLS 63


9th ed., 313464701

Troubleshooting Library Connections


This section describes how to troubleshoot both serial library
connections and SCSI library connections. You must first have
completed the ACSLS installation and configuration described
earlier in this chapter.

To troubleshoot connections with serial libraries


(4400, 9300, 9740):

1. Make sure the library is powered on and functional


and the subsystems are properly connected with the
appropriate cables.

2. Change directories:
 7 37 7&77$

3. Enter:
 

4. Is the library communicating?


YES Rerun the configuration program (Step 5 in
“Configuring ACSLS”).
NO Go to Step 5 below.

5. Observe the error that is returned from 



.

6. Is an error returned?
YES Continue with Step 7.
NO The problem points to a hardware condition such as
faulty cable connections or a faulty LMU. Check
all connections. Then rerun the configuration
program (Step 5 in “Configuring ACSLS”).

64 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

7. If 

failed with a permission error, you get
output such as:
<8>     )#
 D +GM 

 
)# 
      0'
This error message indicates that permissions need to be
changed on the low level tty device.

8. Find the actual device node by looking at the symbolic


link to your tty device:
  7 (7  7$
Example output from an Ultra 10:
""""""" 
)
S+M5S+M+
S+
S+6M655555
Example output from a SPARC 5:
)
B
S5M+55555

9. Change permissions on the device node so it is rw for


all users:
  888 7 ( 7
following the path down to the device node.

10. To avoid future problems related to port permissions,


you should disable the specific ACSLS ports from
access by any other applications. One specific
application you should disable is the Solaris port
monitor.
To disable the ports and  from the Solaris port monitor,
log in as  and enter:
    ;   
    ;   $

Chapter 3. Installing and Configuring ACSLS 65


9th ed., 313464701

To troubleshoot connections with SCSI libraries (97xx


and L–series):

1. Check for the following:


d The library is powered on and functional.
d The subsystems are properly connected with the
appropriate cables.
d The library interface matches the controller interface
in terms of single-ended vs differential signal
definitions.
d The bus is properly terminated at the library end with
a compatible (single-ended or differential) SCSI
terminator.

2. Run 

.

3. Is the library communicating?


YES Rerun the configuration program (Step 5 in
“Configuring ACSLS”).
NO Go to Step 4 below.

4. Verify the hardware connection using the PROM


monitor utility:
a. Enter the PROM monitor by pressing the
Stop key + a.
b. At the  prompt, enter the command:
$ < <
This command displays the target number, the device
type, make and model of each SCSI-attached device.
A valid response might return something like the
following:
(   .
' 5 )  &) (# 4 (C 255

66 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

c. Was a valid response returned for the STK library?


YES Reboot the system and go to Step 5 below.
NO Verify the library hardware including the
SCSI target ID defined on the library device.
Make sure all cables and terminators are
properly connected.
Reset the library and wait until the IPL has
completed. Then repeat Step 4.

Chapter 3. Installing and Configuring ACSLS 67


9th ed., 313464701

5. Remove and rebuild the SCSI device driver:


a. Switch user to .
b. Issue the following commands to remove the existing
drivers:
 -(  
 7 (  =
Then reboot the system.
c. Log in as  and rebuild the mchanger device
driver:
   #     
1! 
 .
)    
 *

*

.
>    #  %     ( '?
 1   1   
$ < <
'%       1 # 
    @&% &A 
  

*
If your troubleshooting efforts fail, contact StorageTek
Software Support for assistance.

68 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Chapter 4. Completing the ACSLS Installation


Warning: Before completing the ACSLS installation, you must
STOP
complete Chapter 1 “Pre-Installation Preparation,” Chapter 2
“Installing Solaris,” and Chapter 3 “Installing and Configuring
ACSLS.”

Overview
This chapter describes the steps necessary to complete the
ACSLS installation. They include:

S Configuring the Second Disk


S Importing the Database (for upgrade installations only)
S Verifying the Imported Database and Library
Configuration

S Verifying ACSLS Software

Chapter 4. Completing the ACSLS Installation 69


9th ed., 313464701

Configuring the Second Disk


xxxxx Note: If you have already partitioned the second disk when you
xxx
installed the operating system in Chapter 2, skip this section and
go to page 79, “Installing ACSLS Second Disk Support”.
If you did not partition the second disk when you installed the
operating system in Chapter 2, or you are installing a new
second disk, complete this section.

Space Required by Second disk is used to contain the transaction logs in order to
ACSLS on the assure recoverability to the most recent transaction, even in the
Second Disk event of primary disk failure. The storage requirements for
second disk can be met with 256 MB in Partition 0 and the
remainder in Partition 1.

Partitioning the In this procedure, you create two partitions.


Second Disk
To partition the second disk:

1. Is ACSLS running?
YES Continue with Step 2.
NO Go to Step 7.

2. Open a terminal or a command tool and log in as




3. From the cmd_proc window, idle ACSLS.




4. Open another command tool and log in as 

5. Shut down ACSLS.



  

6. Shut down the database.


$-   

70 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

7. Log in as .

8. Open a terminal window. At the prompt, enter


% 
The system prompts you to select a disk. On a SPARC or
Ultra system, the second disk is typically c0t1d0.

9. Enter the number of the second disk (typically menu


number 1).
The Format Menu displays, shown in Figure 7.

7<0!( 0'


 "
 

# "
 8> 
 #
  "
 8>    
  " 
    

  "     #B  

  "   )

  "      

 #B "
   #


 "  


   
   "
       

)# "    
 #  

) "
)  
  

 # "


 )M    )

)  "
 4"   )   
 

Figure 7. Format Menu

10. Enter  from the Format Menu.


The Partition Menu displays, shown in Figure 8.

Chapter 4. Completing the ACSLS Installation 71


9th ed., 313464701

!(,(,< 0'
5 "    T5U  
+ "    T+U  
3 "    T3U  
G "    TGU  
6 "    T6U  
. "    T.U  
L "    TLU  
2 "    T2U  

 "
   
# " #     
  "       
 " 
 #     
  "           

 

Figure 8. Partition Menu

11. Enter  to display the disk partitions.


The Current Partition Table displays, shown in Figure 9.

72 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Current partition table (original):


Total disk cylinders available: 2036+2 (reserved cylinders)

Part Tag Flag Cylinders Size Blocks

0 unassigned wm 0-2035 1002.09MB (2036/0/0)


1 unassigned wm 0 0 (0/0/0)
2 unassigned wm 0 0 (0/0/0)
3 unassigned wm 0 0 (0/0/0)
4 unassigned wm 0 0 (0/0/0)
5 unassigned wm 0 0 (0/0/0)
6 unassigned wm 0 0 (0/0/0)
7 unassigned wm 0 0 (0/0/0)

Figure 9. Partition Table

xxxxx Note: The values in your partition table might differ from those
xxx
shown, depending on the size of your disk and whether you have
previously partitioned it.
Warning: Modifying an existing partition will destroy any data
STOP
in that partition.

12. Enter 4 to change the 0 partition.


The partition 0 table is displayed. Enter the values shown.
a.      - 

 /
Accept either the default 

  or enter  
to bring up a list of available id tags.
b.    

 
-/ 1
c.  
  # -5/ 4
d.   
B -5M 5M 5 55/ 0.8

13. Enter  to confirm changes made to partition 0.

Chapter 4. Completing the ACSLS Installation 73


9th ed., 313464701

14. Note the number of cylinders in partition 0.


Subtract the number of cylinders in partition 0 from the
total number of disk cylinders. This number will be used
in Step 15.

15. Enter : to change partition 1.


The partition 1 table is displayed. Enter the values shown.
a.      - 

 /
Accept the default.
b.    

 
-/ 1
c.  
  # -5/
To determine this value, add 1 to the highest
numbered cylinder in partition 0. For example, if
partition 0 contains cylinders 5".35, enter .0:
d.   
B -5M 5M 5 55/
Enter the amount displayed in 7 (see Chapter 2,
page 38).

16. Enter  to confirm the changes entered.


The display should now look like the configuration shown
in Figure 10.
The remaining partitions should all be unassigned with
starting cylinder of 0 and partition size of 0.

74 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Current partition table (original):


Total disk cylinders available: 2036 + 2 reserved cylinders

Part Tag Flag Cylinders Size Blocks

0 unassigned wm 0-520 256MB (520/0/0)


1 unassigned wm 521–2035 17xxMB (1515/0/0)
2 unassigned wm 0 0 (0/0/0)
3 unassigned wm 0 0 (0/0/0)
4 unassigned wm 0 0 (0/0/0)
5 unassigned wm 0 0 (0/0/0)
6 unassigned wm 0 0 (0/0/0)
7 unassigned wm 0 0 (0/0/0)

Figure 10. Second Disk Partition Table

xxxxx Note: On your display, 

  should appear on size


xxx
0 entries.

17. Enter B to display the partition menu.


The   0 appears, shown in Figure 11.

Chapter 4. Completing the ACSLS Installation 75


9th ed., 313464701

!(,(,< 0'
5 "    T5U  
+ "    T+U  
3 "    T3U  
G "    TGU  
6 "    T6U  
. "    T.U  
L "    TLU  
2 "    T2U  

 "
   
# " #     
  "       
 " 
 #     
  "           

 

Figure 11. Partition Menu

18. Enter $  from the partition menu to update the


disk with the new partitions.

19. Enter  at the  #    


M  I
prompt.

20. From the partition prompt, enter CTRL+D to exit.

76 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Creating the File In this procedure, you create the file systems on the disk you just
Systems partitioned.

To create file systems:

1. At the prompt, enter  to construct a new filesystem.

2. At the system prompt, enter


 1% 7 (7
7 
where   is cntndns0, and cntndn matches the disk
you just installed.
For example,
 1% 7 (7
7 4:44
The system may display:
)
5+5
5 
  

*


3. To have second disk file systems automatically mounted


on boot up, use an editor (such as ) or 1) to
edit the )
  file to define the mount points.
Note that each field is separated by tabs.
Add entries to the file such as the following two entries:
)
5+5
+ )
5+5
+

*
 
+ #
"

)
5+5
5 )
5+5
5

*
   
+ #
"

4. Verify that there is a directory for your mount point



*
 by entering
  7 -

If the directory does not exist, create one by entering



 7 -

or enter an optional directory name.

Chapter 4. Completing the ACSLS Installation 77


9th ed., 313464701

5. Make sure that the second disk is mounted:


 7 -

or enter the optional directory name specified in the


previous step.

6. Make a directory for the backup portion of the second


disk.

 7 -
7$

This directory is the default directory for the backup
portion of the second disk. You may create another
directory name for second disk backups.

7. Make sure the second disk backup is mounted on the


directory specified in the previous step.
 7 -
7$


78 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Installing ACSLS
Second Disk
Support

To install second disk support:

1. Is ACSLS running?
YES Continue with Step 2.
NO Go to Step 6.

2. Open a command tool and log in as 

3. From the cmd_proc window, idle ACSLS.




4. Shut down ACSLS.



  

5. Shut down the database.


$-   

6. Log in as .

7. Change directories.
 7 37 7&7

8. Run the second disk utility.


7-  

9. Choose : to install second disk:


+ ,
   
   
 


10. When you are prompted for the directory for second
disk support, press ENTER to accept the default of

*
 if you used 
*
 as the mount
point in your )
  entry (see “Creating the File
Systems” on page 77). If you used an optional directory

Chapter 4. Completing the ACSLS Installation 79


9th ed., 313464701

name instead of /second_disk on page 77, enter that


name.

11. When you are prompted for the second disk directory
for database backups, press ENTER to accept the
default of 
*
   if you used

*
   as the mount point in your
)
  entry (see “Creating the File Systems” on page
77). If you used an optional directory name instead of
/second_disk/backup on page 77, enter that name.

12. When you see the  &


   menu, select /
to exit the system.
You should see a message about doing a mandatory backup
and a prompt to insert a database backup tape.

13. Insert the tape if you need to and wait for the backup
to complete.

14. When the prompt returns, log out.

80 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Restarting ACSLS

To restart ACSLS:

1. Log in as .

2. In a terminal window or at the shell prompt, enter


 $
xxxxx Note: If the  
     option was
xxx
enabled during ACSLS installation, ACSLS is initiated
automatically when the server system is rebooted. If this is
the case, go to Step 3.

3. Log in as 

4. In a terminal window or at the shell prompt, enter


  
It takes a few seconds to start the database and return to the
shell prompt.

5. When the shell prompt returns, log out.

6. Log back in as 

to use the ACSLS software.

Chapter 4. Completing the ACSLS Installation 81


9th ed., 313464701

Importing the Database


If this is a new installation and an existing database was not
exported, skip this section and go to “Verifying ACSLS
Software” on page 87.
This section describes how to import and recreate the ACSLS
database that you exported in Chapter 1 using the *1

utility.
Hint: The procedures outlined below are for importing the
database from the default tape device. Refer to Appendix A
“Utilities” for instructions on importing the database from disk.
Caution: To complete the upgrade, use the *

! utility to import the database you exported with the
*1
 utility in Chapter 1 of this book. For more
information about the *
 utility, see Appendix A
“Utilities”.

To import the database from tape:

1. Determine whether you are currently the 

user by
entering:

If the response is not 

in the parenthesis following


the UID portion of the output, log out by pressing CTRL +
D, then log back in as 

2. Insert the exported database tape that you exported in


Chapter 1 with the *1
 command into the
tape drive.

82 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

3. Run the database import utility by entering the


following at a UNIX prompt.
$-  
The *
 utility displays several messages as it
executes.
This utility can take up to 15 minutes to complete.

4. Press CTRL+C to exit when you see the following


message. Do not insert a database backup tape.
     
   
) 1  
,
   
     
-A ('     CTRL + C 
1/

Chapter 4. Completing the ACSLS Installation 83


9th ed., 313464701

Verifying the Imported Database and Library Configuration


In this procedure you use the 

* program to verify


the database and the library configuration.

To verify that the database has been imported:

1. Run the configuration program:


 - %
The !         screen appears.

2. Enter 6 to skip library ACSLS feature configuration.


At this point, the system generates a series of messages
indicating that the database is being verified.

3. Enter  at the prompt to skip library communication


software configuration.
   #   
I 8#  >

4. Enter  at the prompt to build/verify the library


configuration.
(

  
  
    # 
  #      
=  M  
   # 
 # 
#  M   


#

      
= ;#  #   I
8#  >

84 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

5. Enter  when the following prompt displays:


 #
)   
 1

  
)M  I 8#  >
As the script builds the library configuration, it displays
one of following messages for each panel in each LSM.
!   M 0  M !  M   
!   M 0  M !  M  
The script also generates a library configuration report and
appends it to the
1!   

*  file.

6. Enter  at the prompt to skip CSI configuration.


  
#
  
I
8#  >

Chapter 4. Completing the ACSLS Installation 85


9th ed., 313464701

7. Are you backing up the database to tape or disk?


Tape Insert a blank tape when the following message
displays:
     
   
,
   
     


('   
The database backup procedure  

automatically executes and captures the


configuration data to enable database journaling.
When the database backup is completed, the
following message displays:
&  
   


 # 
Disk Enter CTRL + C and refer to  

on
page 93 to back up the database to disk file. Then
continue with Step 9.

Caution: The tape drive may appear idle during the


! backup. It may not make any sounds or flash any lights
during this time. DO NOT remove the tape from the drive
until you see the following success message indicating the
backup is complete:

&  
   


 # 

Warning: Interrupting the backup process before


STOP
completion will result in corruption of the database.

8. Remove the tape and store it in a safe place.

9. Run    to start the server.


If the  
     option is enabled,
ACSLS is initiated automatically when the server system
is rebooted.
The ACSLS is now ready for library operations. You may log
out and log back in as 

86 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Verifying ACSLS Software


The IVP (Initial Verification Program) is an exerciser that is used to
verify that a newly installed library is fully functional. This step is
optional. It will mount and dismount specified volumes to specified
drives.

To verify ACSLS, mount and dismount a volume by either:


1. Entering mount and dismount commands from a *
(See “Verifying ACSLS”).
2. Running the Initial Verification Program (IVP) (See
“Running ivp.sh to Verify ACSLS”).

Verifying ACSLS

Mount/dismount a volume to verify ACSLS:

1. Log in as 

2. Query the server from the * by entering


   ( 
If messages are displayed indicating that the server is in
recovery mode, wait for a message indicating that the
server is running.

3. If ACSLS is not running, start it by entering


  

4. Do you have at least one volume in an LSM?


YES Continue with the procedure.
NO Enter a volume into an LSM. For more
information, see “Operator Tasks” in ACSLS System
Administrator ’s Guide and continue with the
procedure.

Chapter 4. Completing the ACSLS Installation 87


9th ed., 313464701

5. Mount a volume by entering:


      
Hint: Use the  # ) command to get the ID of an
available drive and the  # (  command to get the
ID of a library volume. See “Command Reference” in
ACSLS System Administrator’s Guide for more
information.

6. Did you see a message indicating a successful mount?


A successful mount message is:
0          
YES Procedure is complete.
NO If an error message appears, run this verification
procedure again, ensuring that you specified a
valid, available drive and a library volume. If the
mount/dismount still fails, call StorageTek for
assistance.

7. Dismount the volume by entering:


        %
where    is the volume and    is the drive you
specified in Step 5.

88 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Running ivp.sh to Use this procedure to run the IVP program ()
) to mount
Verify ACSLS and dismount a volume. You specify the volume and drive that
)
 uses in the )   file.

Run )
 to mount/dismount a volume to verify
ACSLS:

1. Open a Terminal or a Command tool.

2. Change to the directory that contains the )   file.


 7 37 7&77

3. Using any text editor (for example, ) or 1),


open the )   file and enter a drive ID and volume
ID in the following format at the bottom of the file:
     
Hint: Use the  # ) command to get the ID of an
available drive and the  # (  command to get the
ID of a library volume. See “Command Reference” in
ACSLS System Administrator’s Guide for more
information.

4. To start the IVP program, enter


7 37 7&77(7( 
)
 mounts and dismounts the volume that you
specified in the )   file in about 30 seconds.

5. Did you see a message indicating a successful mount?


YES Procedure is complete.
NO If an error message appears, run this verification
procedure again, ensuring that you specified a
valid, available drive and a library volume in the
)   file. If the mount/dismount still fails, call
StorageTek for assistance.

Chapter 4. Completing the ACSLS Installation 89


9th ed., 313464701

ACSLS Setup for Client Communication


To set up ACSLS for client communication, you include the
client host name and IP address in 

or in the NIS
lookup table.

Regressing to a Previous Version of ACSLS


If for whatever reason you need to regress to a previous version
of ACSLS after you install ACSLS 6.0, contact StorageTek
Software Support. For more information, see Requesting Help
from Software Support.

90 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Appendix A. Utilities

Overview
This appendix contains general guidelines for using specific
ACSLS database utilities and descriptions of the library utilities
mentioned in this book. These include the following:

S bdb.acsss
S db_export.sh
S db_import.sh
S kill.acsss
S rc.acsss
S sd_mgr.sh

Appendix A. Utilities 91
9th ed., 313464701

Using the ACSLS Database Utilities


Follow these general guidelines for using the ACSLS database
utilities:

S You must log in as 

to set up the correct paths and


ownership to run ACSLS utilities; you cannot
to 

S Backups created by  

are primarily for disaster


recovery. To restore the database, use  

as
described in the System Administrator’s Guide.

S StorageTek recommends that you use  

to
manually back up the database for disaster recovery after:
d A large number of enters or ejects
d A large number of scratch mounts
d Running *

d Running 

*
d Any database recovery

S To ensure that you recover an accurate and consistent


database, always use the most current database backup.

S *1
 and *
 database utilities are for
capturing and recovering database table data and
miscellaneous files for upgrades or OS changes to avoid
having to run a lengthy audit.

S After you upgrade to a new version of ACSLS, make sure


to create a new backup as soon as you have upgraded. Do
not recover your database with backups or exports created
with previous versions.

S Retain all utility event logs. These logs will help


StorageTek resolve any problems.

92 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

bdb.acsss
The  

utility backs up the ACSLS database and


miscellaneous library resource files.
xxxxx Note: When you run the  

utility, ACSLS
xxx
automatically creates a backup on local disk as well.

Format
 

-"   %  


/

Hint: If you enter  

with no options, the backup


utility defaults to the default tape device attached and configured
to the ACSLS server.

Options
F  
specifies a UNIX file to contain the ACSLS database. You
must have write permissions to the file.
F  

specifies any tape device attached and configured to the
ACSLS server.

Usage Use the  

utility to manually back up the ACSLS


database to tape or to an external network file to create backups
that can be used, if needed, for disaster recovery of the database.
A tape backup, for example, lets you recover the database if both
disks fail on a two-disk server.
How often you back up the database depends on the amount of
library activity. In general, you should back up the database
often for frequent changes to library contents or configuration.

Appendix A. Utilities 93
9th ed., 313464701

StorageTek recommends that you use  

to manually
back up the database to tape after:

S Running 

* .
S Importing the database. After you upgrade to a new
version of ACSLS, do not use database backups or exports
created with previous versions. Make sure, however, to
create a new backup as soon as you have upgraded.

S A significant number of enters, ejects, scratch mounts, or


volume state changes, such as from scratch to data or from
locked to unlocked.

S Any database recovery.

94 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

db_export.sh
The *1
 utility exports the ACSLS database table
data and miscellaneous files in preparation for an upgrade
installation or a reinstallation of ACSLS.

Format
*1
 F  
Hint: If you enter *1
 with no options, the export
utility defaults to the default tape device attached and configured
to the ACSLS server.

Options
F  
specifies a UNIX file to contain a backup of the ACSLS
database. You must have write permissions to the file.
xxxxx Note: If you export the database to a file, the file must reside in
xxx
a directory above /export/home/ACSSS.

Usage Use the *1


 utility to prepare for a reinstallation of
ACSLS or an upgrade installation of ACSLS.

Examples The following examples:

S Describe how to export the database to the default tape


device attached to the ACSLS server.

S Describe how to export the database to disk file.

Appendix A. Utilities 95
9th ed., 313464701

To export the ACSLS database to the default tape


device:

1. Open a command tool and log in as 

2. From the cmd_proc window, idle ACSLS:




3. Open another command tool and log in as 

4. Shut down ACSLS.



  

5. Shut down the database.


$-      %  & ( 
3  . 2
$-        & (  . 2


6. Insert a blank tape into the default tape device.

7. Start the *1


 utility.
$- 3 

8. Press  to accept 6.0 as the target release of


ACSLS) at the following prompt:

      
  !  -L 5/
As it executes, the utility displays output indicating
successful table data is being exported.

9. Remove the cartridge from the drive only when you see
a message indicating the export is complete.
Caution: You will lose files if you remove the cartridge
! before the program completes. Write protect the cartridge
and clearly mark it to identify the contents as the exported
database.

96 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

To export the ACSLS database to a disk file:


Caution: The files created during the export must be
! saved to some filesystem or other workstation so that they
are not destroyed by the upgrade.

1. Open a command tool and log in as 

2. From the cmd_proc window, idle ACSLS.




3. Open another command tool and log in as 

4. Shut down ACSLS.



  

5. Shut down the database.


$-       & (  . / 0 
1 
$-        & (  . 2

6. Start the *1


 utility.
$- 3  % db_file
The *1
 utility creates two files: * and
* 
. Verify that the * and
* 
 files are in a remote location that will not
be destroyed by the upgrade (i.e., not on the primary disk).
As it executes, the utility displays output indicating
successful table data is being exported.
When the program finishes, you see a message indicating
the export is complete.

Appendix A. Utilities 97
9th ed., 313464701

db_import.sh
The *
 utility imports the ACSLS database table
data and the miscellaneous files that you exported when you
used the *1
 utility.

Format
*
 F  

Options
F  
specifies a UNIX file created by db_export.sh.

Usage Use the *


 utility to import the ACSLS database
that you exported using the *1
 utility.
Caution: To ensure that you import accurate and consistent
! data, terminate ACSLS before running *
.

Examples The following examples:

S Describe how to import the database from the default tape


device attached to the ACSLS server.

S Describe how to import the database from disk files.

98 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

To import the ACSLS database from the default tape


device:

1. Open a command tool and log in as 

2. From the cmd_proc window, idle ACSLS.




3. Open another command tool and log in as 

4. Shut down ACSLS.



  

5. Insert the export tape into the default tape device.

6. Start the db_import.sh utility.


$-  

7. When you see the prompt about tables being destroyed


from the ACSLS database, respond  to continue.

8. When the import completes, remove the tape.

9. Run 

* to verify the imported database and


 

to back up the database.

Appendix A. Utilities 99
9th ed., 313464701

To import the ACSLS database from disk file:

1. Open a command tool and log in as 

2. From the cmd_proc window, idle ACSLS.




3. Open another command tool and log in as 

4. Shut down ACSLS.



  

5. Start the db_import.sh utility.


$-   % db_file

6. When you see the prompt about tables being destroyed


from the ACSLS database, respond  to continue.

7. Run 

* to verify the imported database and


 

to back up the database.

100 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

kill.acsss
The  

utility terminates ACSLS.

Format
 

Options None.

Usage Use the  

utility to terminate ACSLS.

See Also  

Notes
Caution: Do not run  

while an ACSLS request is in


! progress! You must first idle ACSLS (with the  command)
before you run  

. This allows any outstanding jobs


to finish before terminating ACSLS.

Appendix A. Utilities 101


9th ed., 313464701

rc.acsss
The  

utility starts ACSLS.

Format
 

-/

Options

puts the ACSLM in the idle state.

Usage Use the  

utility to start ACSLS. When you start


ACSLS, it goes through recovery mode to online state. ACSLS
initialization includes checking its database and “recovering”
status of the library volumes and library hardware; thus, the term
“recovery mode”.

See Also  

Notes The utility will automatically log in as 

, so you may be
prompted to enter the 

password. Only one copy of


ACSLS can be running on the server. The utility will not
proceed if ACSLS is already running.

102 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

sd_mgr.sh
The
* 
 utility installs or deinstalls second disk support.

Format

* 


Options None.

Usage Use the


* 
 utility to install or deinstall a second disk.
See Chapter 4 or Appendix B.
You can deinstall a second disk to go back to a single–disk
system. You may want to do this to take the second disk offline
for service or replacement.

Appendix A. Utilities 103


9th ed., 313464701

Appendix B. De–installing a Second Disk

Overview
De-installing a second disk is usually done when the second disk
needs to be serviced or replaced.
Caution: De-installation of the second disk should be used if
! there is a hardware failure of the second disk. ACSLS will not
start if a hardware failure occurs.

Appendix B. De–installing a Second Disk 105


9th ed., 313464701

De-installing a Second Disk


To de-install the second disk:

1. If you are not already logged in as  log in as


.

2. From the cmd_proc window, idle ACSLS.




3. Shut down ACSLS.




4. Shut down the database.



   

5. Log in as .

6. Change directories.
    

7. Run the second disk utility.


   
This command starts the second disk manager. With this
function, you can remove second disk support.

8. Enter  to de-install second disk support when you are


prompted for a menu choice.

        

9. Respond  or  when you see the following prompt:


          
  
Select  if your second disk is damaged and
non-functioning.
Select  if your second disk is not damaged.

106 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

10. When the Second Disk Support menu appears, select 3


to exit the menu.
A message and prompt display indicating you must do a
mandatory backup and to insert a database backup tape.

11. Insert the tape and wait for the backup to complete.
The backup takes several minutes to complete.

12. When the backup is completed, remove the backup


tape and store it in a safe place.

13. Log out by selecting   from the 


menu.

Appendix B. De–installing a Second Disk 107


9th ed., 313464701

Restarting ACSLS
To restart ACSLS:

1. Log in as .

2. In a terminal window or at the shell prompt, enter


reboot
xxxxx Note: If the       option was
xxx
enabled during ACSLS installation, ACSLS is initiated
automatically when the server system is rebooted. If this is
the case, go to Step 5.

3. Log in as  .

4. In a terminal window or at the shell prompt, enter


rc.acsss
It takes a few seconds to start the database and return to the
shell prompt.

5. When the shell prompt returns, log out.

6. Log back in as  to use the ACSLS software.

108 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Restarting ACSLS
To restart ACSLS:

1. Log in as .

2. In a terminal window or at the shell prompt, enter


 $
xxxxx Note: If the  
     option was
xxx
enabled during ACSLS installation, ACSLS is initiated
automatically when the server system is rebooted. If this is
the case, go to Step 5.

3. Log in as 

4. In a terminal window or at the shell prompt, enter


  
It takes a few seconds to start the database and return to the
shell prompt.

5. When the shell prompt returns, log out.

6. Log back in as 

to use the ACSLS software.

108 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Glossary
ACS—See Automated Cartridge System. ACSLS platform—The server hardware and
software that provide the proper
ACSEL—See ACS Event Logger. environment for ACSLS.

ACS Event Logger (ACSEL)—The ACS Library Software (ACSLS)—


software component that receives messages Manages ACS library contents and controls
from other ACSLS components and writes ACS library hardware to mount and
them to an Event Log. dismount cartridges on ACS cartridge
drives.
ACS ID—A unique identifier for an ACS.
ACSLS database—A database used by
ACSLH—See ACS Library Handler. ACSLS to track the library configuration
and the locations and IDs of all tape
ACS library—A library is composed of one cartridges in the library.
or more ACSs, attached tape drives, and
cartridges residing in the ACSs. ACSSA— See ACS System Administrator.
ACS Library Handler (ACSLH)—The ACS System Administrator
part of the ACSLM that communicates (ACSSA)—The interface between the
directly with the LMU. Command Processor and the rest of the
system.
ACSLM—See ACS Library Manager.
ADI—Application Data Interchange.
ACS Library Manager (ACSLM)—The
software component that validates and audit—A physical inventory of the contents
routes library requests and responses. of all or part of a library.
ACSLS—See ACS Library Software. Automated Cartridge System
ACSLS database—ACSLS database (ACS)—The library subsystem consisting
containing information about the location of one LMU, and one to 24 LSMs connected
and status of the tape cartridges. The to that LMU.
information includes cell location, scratch automated library—See library.
status, etc.)

Glossary 109
9th ed., 313464701

beginning of tape (BOT)—The location on CD—See cartridge drive.


a tape where written data begins.
cell—A receptacle in the LSM in which a
BOT— See Beginning of Tape. cartridge is stored.

CAP—See Cartridge Access Port. channel—A device that connects the host
and main storage with the input and output
CAP ID—A unique identifier for the control units.
location of a CAP. A CAP ID consists of the
ACS ID, the LSM number, and the CAP client applications—Software applications
number. that manage tape cartridge contents. They
access tape cartridges by interacting with
cartridge—A plastic housing containing a ACSLS. Any number of client applications
length of data recording tape. The tape is can be resident on a client system.
threaded automatically when loaded in a
transport. A plastic leader block is attached client computing system—A computer and
to the tape for automatic threading. The an executable image of the operating
spine of the cartridge can contain an system.
OCR/Bar Code label listing the volume ID.
client software— This software manages
Cartridge Access Port (CAP)—A tape cartridge contents, generates requests
bidirectional port built into the door panel of for cartridges, and transfers data to and from
an LSM, which provides for the manual cartridges. The client software is not part of
entry or automatic ejection of tape ACSLS.
cartridges.
Client System Component—Software
cartridge drive (CD)—A device containing which provides an interface between the
two or four cartridge transports and their client computing system’s operating system
associated power and pneumatic supplies. and ACSLS.

cartridge tape I/O driver—Operating Client System Interface (CSI)— The


system software which issues commands software component that translates and
(e.g., read, write, and rewind) to cartridge routes messages between the ACS Library
subsystems. Manager and the Client System Component.

cartridge transport—An command area—The bottom area of the


electromechanical device that moves tape cmd_proc interface where you enter requests
from a cartridge over a head that writes and and receive response.
reads data from the tape. A transport is
distinct from the power and pneumatic command processor (cmd_proc)— The
sources that supply the electricity and air it screen interface of the ACSSA. cmd_proc
needs to function. See cartridge drive. lets you enter the commands described in
Chapter 7.
CCI—See client computing system.

110 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

control path adapter—A hardware device end of tape (EOT)— The location on a tape
which converts from a Client Computing where written data ends.
System’s control protocol to the control
protocol of the StorageTek Library Control EOT— See end of tape.
System.
EPO—Emergency Power Off.
control unit (CU)—A microprocessor-based
unit logically situated between a channel EPROM—See erasable programmable read
and up to sixteen cartridge transports. The only memory.
CU translates channel commands into
transport commands and sends transport
erasable programmable read-only
status to the channel. memory (EPROM)—A special memory
chip that can be erased and reprogrammed.
CSE—Customer Services Engineer.
Event Log—A file, maintained by the
CSC—Client System Component. ACSEL, that contains messages describing
library and ACSLS events.
CSI—See Client System Interface.
Event Logger—See ACS Event Logger.
CSI variables—Used to define various
options to fine–tune communications external label identifiers— A
between a CSC and the CSI. You change six–character alphanumeric label on the
these variables in the 

* outside edge of a cartridge used to identify a


program. physical tape volume. It may consist of
uppercase letters A through Z, numerals 0
CU—See control unit. through 9, and blanks.

cycle error messages—Messages that full installation—A complete software


indicate a library or ACSLS failure. installation required for new customer sites
or for existing sites where a new library has
database—A collection of interrelated data been installed.
records. See also ACSLS Database.
home location—The cell associated with a
data path—The network path that allows given cartridge.
client applications read/write access to tape
cartridges. ID—Identifier or identification.

data path adapter—A hardware device Informix—The relational database used by


which translates from a Client Computing ACSLS 6.0.
System’s data protocol to the data protocol
of the StorageTek Control Unit. Informix Storage Manager (ISM)—The
Informix database manager, which manages
display area—The top area of the cmd_proc database backups and offloaded transaction
interface that collects messages regarding logs.
the status of the library.

Glossary 111
9th ed., 313464701

Initial Program Load (IPL)—A process library configuration options—Allows


that activates a machine reset, initiates wake the customer to specify the number of ACSs
up diagnostics (from EPROMs) and loads in the library and the connections between
functional code. each ACS and the server system.

inline diagnostics— Routines that test library control component—Software


components of a subsystem while operating which controls the mounting and
on a time-sharing basis with the functional dismounting of cartridges in the ACS.
microcode in the subsystem component.
library control processor—Properly
in–transit cartridges—Cartridges between configured computer hardware that, with the
their source and destination locations. addition of appropriate software, supports
Cartridges are considered in–transit if they the operation of the Library Control
are in the pass–thru ports, robot hands, or Software.
playground.
library control system—The library
I/O—Input/Output. control platform loaded with library control
software (ACSLS).
IPC—Interprocess Communication.
library control software—The software
IPL—See Initial Program Load. components of ACSLS including the library
control component, the Client System
ISM—See Informix Storage Manager.
Interface and Library Utilities.
journal—A sequential log of changes made Library Control Unit—The portion of the
to the database since the last checkpoint.
LSM that controls the picking, mounting,
LAD— Lock Access Door. dismounting, and replacing of tape
cartridges.
LAN—See local area network.
library drive—A cartridge transport
large CAP (LCAP)—A 40–cartridge CAP attached to an LSM that is connected to, and
with the storage cells arranged in four controlled by, a client system. Library
removable magazines of ten cells each. The drives interact with the LCU during
magazines appear as a single column of 40 automated tape cartridge mount and
cells to the host software. dismount operations. Library drives interact
with a client application during tape data
LCAP—See large CAP. transfer operations. Library drives are
individually addressable by the ACSLM and
LCU—See Library Control Unit. are individually accessible by client
applications. See Cartridge Transport.
LED—See Light Emitting Diode.
library errors—Errors that occur because
library—A library is composed of one or the library is offline, has suffered hardware
more ACSs, attached tape drives, volumes in failure, is unavailable, etc.
the ACSs, and the ACSLS software that
controls and manages the ACSs.

112 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

Library Management Unit (LMU)—The Open Systems Interconnection


portion of an ACS that manages LSM’s, (OSI)—A software architecture model of
allocates their resources, and communicates the International Organization for
with ACSLS. Standardization. The OSI model provides
standards for the interconnection of data
Library Storage Module (LSM)—An processing systems.
ACS structure that provides the storage area
for cartridges, cartridge drives, CAPs, and OSI— See Open Systems Interconnection.
the robot necessary for moving them.
OSLAN—Open Systems Local Area
light emitting diode (LED)—A light Network.
emitting device that uses little energy and is
used mainly to indicate on/off conditions. Pass–Thru Port (PTP)—Mechanism that
allows a cartridge to be passed from one
LMU—See Library Management Unit. LSM to another in a multiple LSM ACS.

local area network (LAN)—A computer PCAP—See priority CAP.


network in which any component in the
network can access any other component. playground— A reserved area of special
This is the type of interface between an cells (within an LSM) used for storing
LMU and attached LSM’s. diagnostic cartridges and cartridges found
in–transit upon power–on and before
LSM—See Library Storage Module. initialization of the LSM is completed.

LSM ID—A unique identifier for an LSM. pool—A collection of tape cartridges having
The LSM ID consists of the ACS ID and the one or more similar features or attributes,
LSM number. such as a pool of scratch tapes.

network adapter—Equipment that provides POST— Power–on self–test.


an electrical and logical interface between a
network and specific attached equipment. priority CAP (PCAP)—A single–cartridge
CAP used for priority entry and ejection of
Network Interface (NI)—An interface cartridges.
between the server system and the client
systems that maintains network connections processing errors—Errors that result from
and controls the exchange of messages. The processing or network communication
NI is resident on the server system and each failures.
client system.
PROM—Programmable read-only memory.
NI—See Network Interface.
PTP—See Pass–Thru Port.
OCR—Optical character recognition.
RDBMS—Relational database management
ONC—Open network computing. system.

Glossary 113
9th ed., 313464701

redo log files—Backup files used to restore SQL—See structured query language.
the ACSLS database.
SRN. See service request number.
relational database—A database that is
organized and accessed according to SSI—See Storage Server Interface.
relationships between the data items;
relationships are represented by tables. SSR—Software Support Representative.

ROM—Read–only memory. Standard CAP (SCAP)—A 21–cartridge


CAP with the storage cells arranged in three
RPC—Remote Procedure Call. rows of seven fixed cells.

SCAP—See standard CAP. Storage Server Interface (SSI)—A


software component, resident on a client
scratch—An attribute of a tape cartridge, system, that translates and routes messages
indicating that it is blank or contains no between client applications and the CSI.
useful data.
structured query language (SQL)—A
SCSI—Small computer serial interface. language used to define, access, and update
data in a database.
second disk journaling—Allows for the
database’s journal records to be written to a system resource variable—Used to control
second disk device, instead of writing the amount of system resources used by
records to the primary disk. This improves ACSLS.
the chances of recovery from a disk failure.
system unit—The Library Control Platform.
server system—The part of the library that
is the residence for ACSLS, now referred to tape library management system
as the Library Control System. The Library (TLMS)— A type of client application.
Control System acts as an interface between
a library and client systems. TCP—Transmission Control Protocol.

server system user—A person who invokes TLMS—See tape library management
ACSLS commands, utilities, or procedures system.
on the server system. Server system users
are generally site and maintenance personnel TOD—Time of day.
(for example, library operators, tape
librarians, system administrators, CSEs, and UDP—User Datagram Protocol.
systems personnel).
UNIX—An operating system originally
servo—A system that uses feedback to developed by Bell Laboratories (now UNIX
control a process. Systems Laboratories, Inc.) and used by a
variety of computer systems.
silo—A commonly used term for an LSM.
unsolicited messages—Messages that
See Library Storage Module.
indicate an error or notify you when a
SIMM—Single inline memory module. particular routine action can be taken.

114 ACSLS Installation and Configuration Guide for Solaris


9th ed., 313464701

UOC—Usable on codes. volser—Volume Serial Number.


upgrade installation—Performed when volume—A tape cartridge.
installing a new version of ACSLS at an
existing customer site. volume access control—Limits access to
volumes, usually by the client.
user–selectable features and options
variables—Used to define various volume identifier—A six-character string
user–selectable features and options. that uniquely identifies a tape cartridge to
the database.
validation errors—Errors that result from
format and syntax validation performed by volume serial number (volser)—A
cmd_proc. synonym for external label identifier.

virtual label—A logical label that can be WTM—write tape mark.


assigned to a cartridge when its physical
label is missing or unreadable. XDR— External data representation.

Glossary 115