ADIC Version 5.0 manual

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. Copyright Notice © [...]

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.com Is there anything you especially like or dislike about the organization, pr[...]

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. Any software programs or related materials provided by ADIC shall be subject to th[...]

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. This grant is specifically l[...]

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. Title to Software The Software and all copies t[...]

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. ADIC assumes no [...]

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. ADIC does not[...]

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. Third-P ar ty W arranties No reseller or distributor of the Softw are who may ha ve part[...]

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. Upon such termination, ADIC shall promptly refund to Licensee any License Fees paid and other payments made for [...]

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 . If this Li[...]

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. Modification This License or any Exhibit thereto can onl[...]

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. Further , Licensee agrees that this is the complete and exclus i ve statement of the agreement between the parties which supersedes all propo sals or prior agreemen[...]

601351 Rev A i Contents Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 How This Book is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

Installing V olServ ii Contents 601351 Rev A Installation Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5 Extract Files from CD . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Install VolServ . . . . . . . . . . . . . . . . . . . . . . . [...]

Preface P Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . P-3 How This Book is Organized . . . . . . . . . . . . . . . . P-3 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-4 Books . . . . . . . . . . . . . . . . . . . . . . . . . [...]

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 . Use this guide for the installation and setup of a V olServ system. It assumes th[...]

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” . The root prompt[...]

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 . The Reader allo ws you to view and navig ate the online documentat[...]

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.com. [...]

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 . . . . . . . . . . . . . . . . . . 1-7 Configure UNIX Envir onment . . . . . . .[...]

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 .cshrc file[...]

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 . NO TE : If you are also using FileSer v , first ins[...]

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 . The default v alue of VS_DIR is /volserv/volserv b ut yo[...]

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 *.config files. F or example, the user can elect to add or to remov e V olSer v capabilities av ailable to the clients or V olServ system administr ator by modif[...]

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 . Information Needed Default Customer Entry User ID f or V olSer v administrator vsadm Grou[...]

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 . If you do not want to accept the def a ults, crea[...]

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 . The format of each entry is: where: The newly created line s hould look si[...]

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. This file must contain a line entry for each user recognized by t[...]

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. Step 6. Reset the /etc/shadow f ile access mode to 400. Step 7. Run the passwd c[...]

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. Obtain a site license strings b y calling the ADIC T echnical Assistance Center: ?[...]

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 . . . . . . . . . . . . . . . . . . . . . . . 2-6 Install V olServ . . . . [...]

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 .cs[...]

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 file to perform installation • One or more data fi les to be installed The installation process in volv es verifying the header f ile and loading and [...]

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. The V olServ administrator en vironment is created during installation. The e xact setup of th e [...]

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 . 1-3 2 Extract the files from the CD . 2-6 3 Use the vs_install script to install V olS[...]

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. Step 4. Remote only: Edit the remote host?[...]

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. Option Description platform Enter your UNIX server[...]

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. T o answer the script questions, use the table under ?[...]

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. VolServ creates the volserv subdirectory in the / (root) directory. Are you installing from CDROM (<y> or n)? y Is your intended response (<y> or n)? y --------------[...]

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. The CLI executables are e xtracted from the distrib ution media. The installat[...]

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 . Do you wish to [...]

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. You must create them now if y[...]

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 . Step 11. Enter the appropriate licen se[...]

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. --------------------------------------- --------------------------- The home directory of the linter dat[...]

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. Step 15. The Applicat[...]

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. Do you wish to install/update the VolServ API files now (<y> or n) ? y ----------------------------------[...]

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. After installation, the VS_DIR environment variable indicates the home directory of the VolServ binary and supp[...]

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 . . . . . . . . . . . . . . . . . . . 3-4 Database Recovery . . . . . . . . . . . . . . . . . . . . . . 3-6 Media Management . . [...]

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 .cs[...]

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 . If Lint[...]

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. All maintenance operations are established during the initial V o[...]

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 .” Step 3. When you are finished edi ting, restart the Linter Database and backup process by running the follo wing: This backup script includes the following two device pa[...]

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. If the Linter Database ( $VS_DIR/linter/db) becomes either[...]

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. This file may need to be modified if the shell used is dif ferent fr [...]

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. Step 2. Connect a properly termi nated SCSI library . Step 3. Power -up SC[...]

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.7 FPU: MIPS R10010 Floating Point Chip Revision: 0.0 Main memory size: 1[...]

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 entered for configuration of this SCSI library for V olServ is sc2d6l0 where c2 corresponds to Controller 2, d6 corresponds to SCSI ID (Unit) 6, l0 and co[...]

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. Additionall[...]

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 . Be prepared to immediately do another STOP-A sequenc[...]

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. Step 3. Configure all dri ves and associate them with their appropr[...]

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 . Vie w inf or mation contain ed in t[...]

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. operator .config A list of V olServ commands a vailab le to the system[...]

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. Vie w inf or mation c[...]

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. The sa me utilities in vok ed by the installation script are used to ma ke these updates; therefore, the procedures (after in voking the ut ili[...]

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. Step 3. T o simplify the printcap f ile mo[...]

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. Select the Serial P o r t Manager and disable communication to both serial ports. Close the[...]

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 . Step 9. Close the admint ool windo w .[...]

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 . . . . . . . . . . . . . . 1-6 B Book audience . . . . . . . . . . . . . . . . . . . . P-3 conventions . . . . . . . . . . [...]

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 . . . . . . . . . . . . . . . . . . P-6 Product Alerts . . . . . . . . . . . . . . . P-6 Product Bulletins . . . . [...]