Instruction/ maintenance manual of the product Version 5.0 ADIC
Go to page of 76
Installing V olSer v ® V olServ V ersion 5.0 September 2001 601351 Rev A.
Trademark Notice AMASS, DataMgr, EMASS, File Serv, and VolServ are either trademarks or registered trademarks of ADIC, Advanced Digital Info rmation Corporation. DAS is a trademark of Grau, an ADIC subsidiary. All other product na mes and identifications are trademarks or registered trademarks of their respective manufacturers.
ADIC includes this Form in an effort to pr ovide the best possible documentation to our customers. Please take a few moments to mail or FAX your response to: ADIC Software Documentation 10949 East Peakview Ave. Englewood, CO 80111 FAX: 303-792-2465 E-mail: techdocs@adic.
NOTES.
Installing V olServ License Agreement v Premise of This License This License sets forth the term s and conditions under which ADIC agrees to grant and Licensee agrees to accept a license to us e certain of ADIC’ s proprietary soft w are and related docume ntat ion.
Installing V olServ vi License Agreement Use Licensee is authorized hereby to use the Software on the Designat ed Computer(s) only , or on backup equipment if the Designated Computer is inoperati ve until such time as the De signated Computer is restored to operation and processing on the backup equipment is complet ed.
Installing V olServ License Agreement vii Ownership & Pr otection ADIC’ s W arranty ADIC warrants that it is the owner of the Software and all portions thereof, except for an y embedded third party so ftware, and that it has the right to modify the Software and to grant this License for its use.
Installing V olServ viii License Agreement Responsibility Licensee has sole responsibility for use of the program and any information entered, used, or stored thereon. This responsibi lity includes protection of data from modification, destruction, or disclosure, and for the accuracy and integrity of the results from improp er use.
Installing V olServ License Agreement ix W arranty & Servicing W arranty ADIC warrants that for a period of 90 days from installation, the Software will conform to all substantial oper ational features in ADIC’ s current published specifications and will be free of defects which substantially af fect performance of the Software.
Installing V olServ x License Agreement Disclaimer EXCEPT FOR THE EXPRESS LIMITED W ARRANTY ST A TED ABO VE, ADIC MAKES NO W ARRANTIES, EXPRESS OR IMPLIED, FOR THE SOFTW ARE, INCLUDING THE W A RRANTIES OF MERCHANT ABILITY AND FITNESS FOR A P AR TICULAR PURPOSE.
Installing V olServ License Agreement xi Upon failure of (1), (2) or (3) abov e, despite the reas onable ef forts of ADIC, Licensee may terminate this License only with respect to the Software adversely af fected by such action or claim.
Installing V olServ xii License Agreement This License may be terminated by ADIC if the Licensee: • terminates or suspends its b usiness; • becomes subject to any bankruptc y or insolvency proceeding under governmental statute or • becomes insolvent or becomes subject to direct control by a trustee, recei ver or similar authority .
Installing V olServ License Agreement xiii General No Assignme nt This License is not assignab le. None of the Software or Documentatio n may be sublicensed, assigned or transferred to any other party without ADIC’ s prior written consent. Any ef fort contradictory of this is null and void.
Installing V olServ xiv License Agreement Entirety Licensee ackno wledges that it has read this Soft w are License, und erstands it, and agrees to be bound by its terms a nd conditions.
601351 Rev A i Contents Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Installing V olServ ii Contents 601351 Rev A Installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Extract Files from CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface P Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . P-3 How This Book is Organized . . . . . . . . . . . . . . . . P-3 Conventions . . . . . . . . . . . .
Installing V olServ P-2 Preface 601351 Re v A NO TES.
Installing V olServ 601351 Rev A Preface P-3 Preface Purpose of This Book This book describes ho w to install V olServ . Who Should Read This Book This book is intended as a refe rence guide for use by the V olServ installation team and the site system administrator .
Installing V olServ P-4 Preface 601351 Re v A Con ventions The con ventions used throughout the V olServ technical books are listed belo w: Con vention Example Screen te xt, file names, pr og ram names, and commands are in Cou rier f ont. Request to add a new volume: Volume group will be “20” Volume position will be “A123” .
Installing V olServ 601351 Rev A Preface P-5 Preface Books The books described belo w ar e part of the technical documentation set, and are shipped on CD along with the V olServ software: Online Books The documentation CD contains V olServ book files and Adobe ® Acrobat ® Reader .
Installing V olServ P-6 Preface 601351 Re v A Related Publications The publications described in th e table belo w are created and distributed on an as-needed basis. Contact Publications Depart ment T o make corrections or to comment on V olServ publications, please contact Software T echnical Publications at our e-mail address: techdocs@adic.
Getting Started 1 Getting Star ted Prior to Installation . . . . . . . . . . . . . . . . . . . . . . . . 1-3 V olServ Directory Structur e . . . . . . . . . . . . . . . . . 1-4 System Parameters Checklist . . . . . . . . . . . . . . . . 1-6 Create V olServ Directories .
Installing V olServ 1-2 Getting Started 601351 Re v A Roadmap T opic Refer T o Chapter Prepare to install V olSer v 1 Install V olSer v 2 T asks after installing V olSer v: • Star tup and shutdo wn scr ipts • Put Linter engine in P A TH • Database maintena nce and recov er y • Media management Site-specific ta sks: • Modifying .
Installing V olServ 601351 Rev A Getting Started 1-3 Getting Started Prior to Installation The tasks belo w are presented as guidelines only since the actual steps for your specific site are unique: Step T ask Refer to Pag e 1 Install the hardw are and connect the storage de vices to the network .
Installing V olServ 1-4 Getting Started 601351 Re v A Vo l S e r v Directory Structure The VS_DIR en vironment v ariable is set up in the local . cshrc f ile by the installation script. During ex ecution of the script, a prompt asks for the name of the directory in which to install V olServ .
Installing V olServ 601351 Rev A Getting Started 1-5 Getting Started config A series of *.config files. Ch anges to V olServ operatin g enviro nment can be made b y altering entries in the *.
Installing V olServ 1-6 Getting Started 601351 Re v A System Pa r a m e t e r s Chec klist The installation script prom pts you for configuration information. Therefore, before running the script, complete the System Pa rameters Checklist table sho wn belo w .
Installing V olServ 601351 Rev A Getting Started 1-7 Getting Started Create Vo l S e r v Directories During the V olServ installation process, you are requested to either: • Accept the default directo ries. • Or , supply directory locations fo r certain f iles that assist in database recov ery .
Installing V olServ 1-8 Getting Started 601351 Re v A Configure UNIX En vironment Step 1. Login as root user . Step 2. Use an editor , such as vi, to add the vsadmin group to the /etc/group f ile. This f ile must contain a line entry for each group recognized by the system .
Installing V olServ 601351 Rev A Getting Started 1-9 Getting Started Step 3. Use an editor , such as vi, to v ie w the /etc/passwd fi le. If this f ile already contains a vsadm entry , no further action is necessary . Otherwise, the user must add a vsadm user definition to the f ile.
Installing V olServ 1-10 Ge tting Started 60 1351 Rev A Step 4. Change the /et c/shadow f ile access mode to 600. Step 5. Use an editor , such as vi, to view the /etc/shadow f ile. Make the follo wing vsadm entry: Make sure to enter eight colons after the vsadm string.
Installing V olServ 601351 Rev A Getting Started 1-11 Getting Started Obtain Vo l S e r v License Strings Step 1. Display the host identif ication number for the host server . •O n S G I , use the follo wing command: • On Sun, use the follo wing command: Step 2.
Installing V olServ 1-12 Ge tting Started 60 1351 Rev A NO TES.
Installation Procedures 2 Installation Pr ocedures Distribution Media . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Running the Installation Script . . . . . . . . . . . . 2-3 Installation Summary . . . . . . . . . . . . . . . . . . . . . . 2-5 Extract Files from CD .
Installing V olServ 2-2 Installation Procedure s 601351 Re v A Roadmap T opic Refer T o Chapter Prepare to install V olSer v 1 Install V olSer v 2 T asks after installing V olSer v: • Star t-up and shutdown scripts • Put Linter engine in P A TH • Database maintena nce and recov er y • Media management Site-specific ta sks: • Modifying .
Installing V olServ 601351 Rev A Installation Procedures 2-3 Installation Procedures Distrib ution Media The V olServ distrib u tion CD contains: • Information describing the release • A script fi.
Installing V olServ 2-4 Installation Procedure s 601351 Re v A V olServ parameter f iles are AS CII text files that can be modif ied using a text editor . The system administrator can change these parameters to tune the system for site-specif ic needs.
Installing V olServ 601351 Rev A Installation Procedures 2-5 Installation Procedures Installation Summary The following steps are require d for a su ccessful installation: Step T ask Refer to Pag e 1 Complete the steps in the “Pr ior to Insta llation” table .
Installing V olServ 2-6 Installation Procedure s 601351 Re v A Extract Files fr om CD Step 1. Place the V olServ CDR OM into the CD driv e. Step 2. Login to the V olServ host computer as the root user . Step 3. If a windo wing en vironment is used, expand the shell windo w to a width of 80 columns or more.
Installing V olServ 601351 Rev A Installation Procedures 2-7 Installation Procedures where: Step 7. T o start extracting the V olServ f iles, press <RETURN>. The VolServ support and executables files are extracted from the instal lation CD. Extraction time depends on platforms and media type.
Installing V olServ 2-8 Installation Procedure s 601351 Re v A Install Vo l S e r v Step 1. At the command line, enter the follo wing command to begin the V olServ install script: Step 2. The ADIC copyright license and the date the distribution CD w as created displays as shown belo w: Step 3.
Installing V olServ 601351 Rev A Installation Procedures 2-9 Installation Procedures Step 4. Either accept the default volserv installation directory or enter a ne w path.
Installing V olServ 2-10 Installa tion Procedures 601351 Rev A Step 5. V olServ checks the av ailable disk space for the specif ied load directory . If insuf ficient space is av ailable, an error is returned. Step 6. Install the command line interface (CLI) ex ecutables.
Installing V olServ 601351 Rev A Installation Procedures 2-11 Installation Procedures Step 7. If you hav e a DataShelf, Stage, DataT o wer , AML, Silo, or SCSI library c onnected, you are asked about installing those ex ecutables as well. Step 8. For default user IDs and group IDs, see “System Parameters Checklist” on page 1-6 .
Installing V olServ 2-12 Installa tion Procedures 601351 Rev A Step 9. Either accept the defaults or enter new pathnames for the following: • V olServ Database name • Database journal f iles • Database checkpoint f i les The “vsadm” user and “vsadmin” group must exist before the installation can continue.
Installing V olServ 601351 Rev A Installation Procedures 2-13 Installation Procedures Step 10. Enter the V olServ license string. If you do not enter it no w or want to change the string later use the $VS_DIR/util/change_license utility . F or instructions, see “Updating the License String” on page 3-17 .
Installing V olServ 2-14 Installa tion Procedures 601351 Rev A Step 12. The V olServ database (Lin ter) is installed under $VS_DIR/linter . --------------------------------------- --------------------------- Setting VolServ permissions … done.
Installing V olServ 601351 Rev A Installation Procedures 2-15 Installation Procedures Step 13. After all the database tables are entered, V olServ automatically makes an initial checkpoint of the Linter Database. Step 14. Either accept the default path or enter a new pathname where the database checkpoint files will be stored.
Installing V olServ 2-16 Installa tion Procedures 601351 Rev A Either accept the default path or enter a new pathname. --------------------------------------------------------------------- Ready to install the necessary VolServ API files.
Installing V olServ 601351 Rev A Installation Procedures 2-17 Installation Procedures Step 16. At the end of the installation, the files installed will be displayed and a copy of the installation conf iguration will be written to a fi le.
Installing V olServ 2-18 Installa tion Procedures 601351 Rev A NO TES.
P ost Installation Ta s k s 3 Po s t Installation Ta s k s Post Installation T opics . . . . . . . . . . . . . . . . . . . . . 3-7 Put Linter in P A TH . . . . . . . . . . . . . . . . . . . . . . 3-3 Database Maintenance . . . . . . . . . . . . . . . .
Installing V olServ 3-2 Post Installation T asks 601351 Re v A Roadmap T opic Refer T o Chapter Prepare to install V olSer v 1 Install V olSer v 2 T asks after installing V olSer v: • Star t-up and shutdown scripts • Put Linter engine in P A TH • Database maintena nce and recov er y • Media management Site-specific ta sks: • Modifying .
Installing V olServ 601351 Rev A Post Installation Tasks 3-3 P ost Installation Ta s k s Po s t Installation T opics Setting up the V olServ en vir onment includes the follo wing tasks: Put Linter in PAT H V olServ uses a Linter Database to store and track information about the archi ved f iles, tape driv es, and media managed by V olServ .
Installing V olServ 3-4 Post Installation T asks 601351 Re v A Database Maintenance Linter must be acti ve before V olS erv initiates. Periodic database maintenance is required to pr e vent data loss, to impro ve V olServ performance, and to simp lify recov ery procedures, if needed.
Installing V olServ 601351 Rev A Post Installation Tasks 3-5 P ost Installation Ta s k s Step 2. Enter the time in the scr_unix.bsl script for “Everyday” and “CWEEKD A Y .
Installing V olServ 3-6 Post Installation T asks 601351 Re v A Database Reco ver y All changes to the database can be reco vered by the follo wing operations: • Journaling enabled for the Linter Database. • Linter software maintaining a record of e very update since the last checkpoint.
Installing V olServ 601351 Rev A Post Installation Tasks 3-7 P ost Installation Ta s k s Site-Specific T opics Additional tasks include the follo wing topics: Modifying the .cshrc File During ex ecution of the V olServ installation script, the . cshrc f ile for vsadm was created.
Installing V olServ 3-8 Post Installation T asks 601351 Re v A Configuring SCSI Device Nodes If you are attaching a SCSI-connect ed library , use the following procedures. SGI/IRIX Host T o conf igure a SCSI device node to an IRIX host: Step 1. Power -down the IRIX mac hine.
Installing V olServ 601351 Rev A Post Installation Tasks 3-9 P ost Installation Ta s k s Here is an example of the repo rt from hinv : This report identifies the Jukebox as unit 6 on SCSI controller 2 $ hinv 2 195 MHZ IP30 Processors CPU: MIPS R10000 Processor Chip Revision: 2.
Installing V olServ 3-10 Post Installation T asks 601351 Rev A Step 7. Enter ls /dev/scsi to display the nodes for all SCSI de vices. An example report is: In this example, the SCSI De vice to be ente.
Installing V olServ 601351 Rev A Post Installation Tasks 3-11 P ost Installation Ta s k s Step 6. Edit the /kernel/drv/sgen.conf file as sho wn belo w . The lines beginning with a # are comments. The lines can be un-commented out b ut the line corresponding to the known target ID of the connected SCSI library MUST NO T be commented out.
Installing V olServ 3-12 Post Installation T asks 601351 Rev A An OK prompt will appear on the desktop, not in a CDE window. Step 8. Reboot the Solaris host machine using boot -r to force re-conf iguration of hardware de vices. This will create the de vice node required for the attached library .
Installing V olServ 601351 Rev A Post Installation Tasks 3-13 P ost Installation Ta s k s Configuring f or FileServ Perform the follow ing steps to pro vide V olServ media management capabilities for FileServ . Step 1. Start V olServ . Step 2. Configure the appropr iate librarie s.
Installing V olServ 3-14 Post Installation T asks 601351 Rev A Step 3. Edit the appropriate *.config f iles. where: *.config File Description command.config A list of V olServ commands a vailab le to client software . This file is used by V olServ to determine per mission of clients to e xecut e th ese commands .
Installing V olServ 601351 Rev A Post Installation Tasks 3-15 P ost Installation Ta s k s label_printers.c onfig Printer name and type of the label printers used b y V olSer v to print or repr int media labels. Vie w inf or mation contain ed in this file f or more inf or mation.
Installing V olServ 3-16 Post Installation T asks 601351 Rev A process.con fig A list of processes t hat are star ted up f ollowing processes contained in the servers.config file or are ter minated bef ore those in servers . config . Inf or mation in this file should not be modifie d unless directed by ADIC technical suppor t.
Installing V olServ 601351 Rev A Post Installation Tasks 3-17 P ost Installation Ta s k s Updating the License String After installation, you may need to update a license string or subsystem conf iguration.
Installing V olServ 3-18 Post Installation T asks 601351 Rev A Step 2. If these printers are not attached to the V olServ host machine serial ports A and/or B or if they are attached to parallel ports or a remote ma chine, the system administrator must set up the /etc/printcap f ile to define the printers.
Installing V olServ 601351 Rev A Post Installation Tasks 3-19 P ost Installation Ta s k s Step 1. Login as root . Step 2. Connect the printer data ca ble to the appropriate port on the back of the V olServ host computer . Step 3. Enter the following: Step 4.
Installing V olServ 3-20 Post Installation T asks 601351 Rev A • Enable Printer Queue: Yes • Accept Print Jobs: Yes Step 8. Close the Printe r Ma n ager .
Installing V olServ 601351 Rev A Post Installation Tasks 3-21 P ost Installation Ta s k s NO TES.
Installing V olServ 3-22 Post Installation T asks 601351 Rev A.
601351 Rev A INX-1 Inde x A Adobe Acrobat Reader . . . . . . . . . . . . P-5 API . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7 Archive Controller hostname . . . . . . . . . . . . . . . . . . . 1-6 internet address . . . . . . . . . . . . .
Installing V olServ INX-2 Index 601351 Rev A stop . . . . . . . . . . . . . . . . . . . . . . . . 3-3 P Printers barcode label . . . . . . . . . . . . . . . 3-18 seiko shelf label . . . . . . . . . . . . . 3-18 Publications Department . . . . . . . . .
An important point after buying a device ADIC Version 5.0 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought ADIC Version 5.0 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data ADIC Version 5.0 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, ADIC Version 5.0 you will learn all the available features of the product, as well as information on its operation. The information that you get ADIC Version 5.0 will certainly help you make a decision on the purchase.
If you already are a holder of ADIC Version 5.0, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime ADIC Version 5.0.
However, one of the most important roles played by the user manual is to help in solving problems with ADIC Version 5.0. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device ADIC Version 5.0 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center