Instruction/ maintenance manual of the product 3.5 ADIC
Go to page of 94
System Administrator’ s Guide to Installing DataMgr DataMgr V ersion 3.5 January , 2000 Document Number 600922.
Trademark Notice AMASS, EMASS, DataMgr, FileServ, and VolServ are either trademarks or registered trademarks of ADIC, Advanced Digital Information Corporation. DAS is a trademark of Grau, an ADIC subsidiary. All other product names and identifications are trademarks or registered trademarks of their respective manufacturers.
ADIC includes this Form in an effort to provide 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: swpubs@adic.
NO TES.
i Contents Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 How This Book is Organized .
System Administrator ’ s Guide to Installing DataMgr ii Contents Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13 Create Installation Directory . . . . . . . . . . . . . . .
System Administrator ’ s Guide to Installing DataMgr Contents iii DMFS cron job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4 BFS cron job . . . . . . . . . . . . . . . . . . . . . . . . .
System Administrator ’ s Guide to Installing DataMgr iv Contents.
Preface P P Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . P-3 How This Book is Organized . . . . . . . . . . . . . . . . P-4 Conventions . . . . . . . . . . . .
System Administrator’ s Guide to Installing DataMgr P-2 Preface NO TES.
System Administrator’ s Guide to Installing DataMgr Preface P-3 Preface Purpose of This Book This book describes ho w to install and configure DataMgr on both the server and on clients’ machines. Who Should Read This Book This book is written for the system administrators who has been assigned the task of installing DataMgr .
System Administrator’ s Guide to Installing DataMgr P-4 Preface How This Book is Organized This book contains the follo wing chapters: Chapter 1: Prer equisites — Defines system requirements for DataMgr . Chapter 2: Install DataMgr — Instructions for installing DataMgr as well as special startup & shutdo wn procedures.
System Administrator’ s Guide to Installing DataMgr Preface P-5 Preface Conventions The con ventions used throughout the DataMgr technical books are listed belo w: Con vention Example The word “library” is a generic way to ref erence a storage de vice.
System Administrator’ s Guide to Installing DataMgr P-6 Preface Books The books described belo w are part of the technical documentation set and are shipped on CD along with the DataMgr software: Online Documentation The software CD contains DataMgr book files and Adobe ® Acrobat ® Reader .
System Administrator’ s Guide to Installing DataMgr Preface P-7 Preface Related Publications The publications described in the table belo w are created and distributed on an as-needed basis: Contact.
System Administrator’ s Guide to Installing DataMgr P-8 Preface • Address. • T elephone number and f ax number . • DataMgr serial number (or enter “reseller” if you are not a customer).
System Administrator’ s Guide to Installing DataMgr Preface P-9 Preface NO TES.
System Administrator’ s Guide to Installing DataMgr P-10 Preface NO TES.
Prerequisites 1 Prerequisites Capacity-based License . . . . . . . . . . . . . . . . . . . . . 1-3 BFS Issues License to Clients . . . . . . . . . . . . . . . . 1-7 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9 Create Installation Directory .
System Administrator’ s Guide to Installing DataMgr 1-2 Prerequisites Roadmap T ask Refer T o Chapter Install AMASS bef ore installing DataMgr . V erify that you ha v e the necessar y system requirements. 1 Install DataMgr . 2 Setup tasks: • Establish access f or clients.
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-3 Prerequisites Capacity- based License ADIC issues a DataMgr license based on the amount of disk space each client machine mounts for management. Capacity-based license le vels are described belo w: • Le vel 1 = Less than or equal to 5GB.
System Administrator’ s Guide to Installing DataMgr 1-4 Prerequisites • All strung together . If your Software Certificate does not contain this string, call ADIC at (303) 792-9700 or F AX (303) 792-2465 or email techsup@adic.com and they will issue you an authorization string after you provide them with the required information.
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-5 Prerequisites T emporary Product Ke y The generic 30-day temporary product ke y is: U3QEYUCJ . At the end of 30 days, if a permanent Authorization String has not been entered, DataMgr expires, b ut migrated data will not be lost.
System Administrator’ s Guide to Installing DataMgr 1-6 Prerequisites Step 3. DataMgr replies with the message illustrated belo w , which confirms that you want to o verwrite the license file. When prompted, enter a new authorization string. Your responses are shown in bold.
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-7 Prerequisites BFS Issues License to Clients The BFS issues each DMFS client the appropriate license le vel after recei ving information on the amount of disk storage it manages on the client machine.
System Administrator’ s Guide to Installing DataMgr 1-8 Prerequisites How to Refresh Registration File If a client goes do wn while files are being migrated or reloaded, the /etc/bfs/registered file can become out-of-sync with the current client configurations.
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-9 Prerequisites Requirements Make sure you read the DataMgr “Release Notes” to obtain the follo wing information: • A list of current patches and packages required by your servers.
System Administrator’ s Guide to Installing DataMgr 1-10 Prerequisites Large Files If a DMFS client requires DataMgr to manage files larger than 2GB, the BFS must support large files. Lar ge file support is provided on the follo wing operating system: • AIX 4.
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-11 Prerequisites HP-UX Fileset Libraries Inc luded X11R5-SHLIBS /usr/lib/Motif1.2/libXm.sl /usr/lib/X115R/libX11.sl /usr/lib/X11R5/libXt.sl IRIX Fileset Libraries Inc luded x_eoe.s w .
System Administrator’ s Guide to Installing DataMgr 1-12 Prerequisites Solaris X Windows Libraries Inc luded Open Windows SUNWmfrun /usr/dt/lib/libXaw .so /usr/openwin/lib/libXaw .so /usr/openwin/lib/libXmu.so /usr/openwin/lib/libXt.so /usr/openwin/lib/libX11.
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-13 Prerequisites Disk Space The table belo w sho ws the amount of disk space required by DataMgr: The DataMgr installation script will verify that there is enough space av ailable in the installation directory before proceeding.
System Administrator’ s Guide to Installing DataMgr 1-14 Prerequisites Create Installation Directory Create a platform-specific directory to contain the DataMgr files extracted from the CD. The def ault directory is /usr/dminstall . For instructions on deleting this directory if space is limited, see “Remov e Load Directory” on page 4-6 .
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-15 Prerequisites • DMFS : Install the DMFS on all client machines that hav e file systems managed by DataMgr . The number of machines is limited by the number and le vel of licenses you ha v e purchased.
System Administrator’ s Guide to Installing DataMgr 1-16 Prerequisites • Location of DataMgr databases: - Transaction Database is on each client’ s machine. - Managed File System Database is on each client’ s machine. T o calculate the size of this database, see “Size Managed File System Database” on page 1-20 .
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-17 Prerequisites Complete T able Complete the table belo w when answering the installation questions. If you are installing a DMFS client component on more than one machine, make as man y copies of this table as needed.
System Administrator’ s Guide to Installing DataMgr 1-18 Prerequisites Size Databases The follo wing database are used in DataMgr: • BFS Database on the BFS component. • Managed File System Database on each client. • Client T ransaction Database on each client.
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-19 Prerequisites If File Replication or Multi-tier Policies are used, then the equation is: Example 1: if you hav e client files .
System Administrator’ s Guide to Installing DataMgr 1-20 Prerequisites Size Managed File System Database The Managed File System Database is located under /etc/dm/raima/dmfs .There is a Managed File System Database for each client’ s managed file system.
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-21 Prerequisites Edit P aths The follo wing en vironmental paths are not automatically set up during installation. man P ages Step 1. T o use the man pages, set the following path. For each c shell environment: For each bourne shell environment: Utilities Step 2.
System Administrator’ s Guide to Installing DataMgr 1-22 Prerequisites GUIs Step 3. T o run the Client xdmfs GUI, add /etc/dmfs/usr/bin to your PATH .
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-23 Prerequisites Edit T emporar y Storage Space The DataMgr dmfsscan command controls migration by bringing space usage le vels for a managed file system in line with the v alues defined by the DataMgr administrator with the lo w and prestage watermarks.
System Administrator’ s Guide to Installing DataMgr 1-24 Prerequisites System Mount T able The system mount table defines the file systems and disk partitions that are mounted at boot time. The file system name defined to DataMgr in the /etc/dmfs/config/dmfstab file must match an entry in this system mount file.
System Administrator’ s Guide to Installing DataMgr Prerequisites 1-25 Prerequisites NO TES.
System Administrator’ s Guide to Installing DataMgr 1-26 Prerequisites NO TES.
Installation 2 Installation Extract Files From Local CD . . . . . . . . . . . . . . . . . 2-3 Extract Files From Remote CD . . . . . . . . . . . . . . . 2-4 Install DataMgr . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Startup File . . .
System Administrator’ s Guide to Installing DataMgr 2-2 Installation Roadmap T ask Refer T o Chapter Install AMASS bef ore installing DataMgr . V erify that you ha v e the necessar y system requirements. 1 Install DataMgr . 2 Setup tasks: • Establish access f or clients.
System Administrator’ s Guide to Installing DataMgr Installation 2-3 Installation Extract Files Fr om Local CD T o install DataMgr from CD on a local host, perform the follo wing procedure: Step 1. Log in as root . Step 2. Create a temporary directory under /tmp and cd to that directory .
System Administrator’ s Guide to Installing DataMgr 2-4 Installation Extract Files Fr om Remote CD T o install DataMgr from CD on a remote host, perform the follo wing procedure: Step 1. Log in as root . Step 2. Create a temporary directory under /tmp and cd to that directory .
System Administrator’ s Guide to Installing DataMgr Installation 2-5 Installation Step 5. If you hav e loaded the extracted files onto a machine that will not be running DataMgr , log onto the target machine and NFS mount the platform-specific directory from the machine where the files are located.
System Administrator’ s Guide to Installing DataMgr 2-6 Installation Install DataMgr If the v arious components are going to be installed on dif ferent machines, the installation sequence is as follo ws: • SLD. • BFS. • SSD. • DMFS. ADIC recommends that each component be started before the next component is installed.
System Administrator’ s Guide to Installing DataMgr Installation 2-7 Installation Step 1. Change directory to the specific platform directory created earlier and run the DataMgr installation script. For example, the commands below go to the hpux directory and runs the DataMgr script.
System Administrator’ s Guide to Installing DataMgr 2-8 Installation • If you respond with y (default), the installation script will continue. • If you respond with n, the installation script will terminate. Y ou can Start DataMgr , perform a full BFS Database backup, then run the installation script again.
System Administrator’ s Guide to Installing DataMgr Installation 2-9 Installation Step 6. If the SLD and the DMFS are going to be installed on dif ferent machines, you must go to the SLD machine and start the SLD (run /etc/rc.dm ) before continuing with this installation.
System Administrator’ s Guide to Installing DataMgr 2-10 Installation Step 8. If you accept the default location for the mount point, AMASS bitfiles directory , and BFS Database backup directory , press <Enter>. Ho we ver , if you want DataMgr to create another directory , enter a ne w path.
System Administrator’ s Guide to Installing DataMgr Installation 2-11 Installation Step 11. Enter the license strings that were purchased. For information, see “Capacity- based License” on page 1-3 .
System Administrator’ s Guide to Installing DataMgr 2-12 Installation Star tup File The startup file performs the follo wing tasks: • Cleans up any migrations or reloads that were in progress when the system went do wn by running /etc/dmfs/usr/utils/dmfsck.
System Administrator’ s Guide to Installing DataMgr Installation 2-13 Installation Star tup & Shutdown Although the command to automatically start DataMgr at bootup is added to the system startup file during installation, a special startup is required, for example, after the system administrator performs system maintenance.
System Administrator’ s Guide to Installing DataMgr 2-14 Installation NO TES.
System Administrator’ s Guide to Installing DataMgr Installation 2-15 Installation NO TES.
System Administrator’ s Guide to Installing DataMgr 2-16 Installation.
Setup T asks 3 Setup T asks Establish Access for DMFS Clients . . . . . . . . . . . 3-3 Schedule cron Jobs . . . . . . . . . . . . . . . . . . . . . . . . . 3-4 DMFS cron job . . . . . . . . . . . . . . . . . . . . . . . . . 3-4 BFS cron job . . . . .
System Administrator’ s Guide to Installing DataMgr 3-2 Setup T asks Roadmap T ask Refer T o Chapter Install AMASS bef ore installing DataMgr . V erify that you ha v e the necessar y system requirements. 1 Install DataMgr . 2 Setup tasks: • Establish access f or clients.
System Administrator’ s Guide to Installing DataMgr Setup Tasks 3-3 Setup T asks Establish Access f or DMFS Clients Step 1. DataMgr is shipped so that only the DataMgr administrator can select clients’ file systems for management and can define migration criteria.
System Administrator’ s Guide to Installing DataMgr 3-4 Setup T asks Schedule cron Jobs During installation, DataMgr puts entries in the root crontab that perform the tasks described belo w . If the default schedule does not suit your site’ s needs, edit the cron file.
System Administrator’ s Guide to Installing DataMgr Setup Tasks 3-5 Setup T asks • Nightly at 1 a.m.: Runs the /etc/dm/usr/scripts/clean_emasslogs script to mov e the current set of logs to a file in the same directory with the same name, b ut appended with a timestamp.
System Administrator’ s Guide to Installing DataMgr 3-6 Setup T asks Bac k Up Databases T o effecti v ely and efficiently manage your clients’ file systems, coordinate the ex ecution of the follo wing utilities by scheduling them as cron jobs: • /etc/dmfs/user/utils/dmfsscan — controls file migration.
System Administrator’ s Guide to Installing DataMgr Setup Tasks 3-7 Setup T asks If this nightly backup fails, DataMgr sends a mail message to root notifying the system administrator the status of the bfsdb_backup . Failed backups are sent to /etc/dm/raima/log/ bfsdb_backup.
System Administrator’ s Guide to Installing DataMgr 3-8 Setup T asks Step 2. Enter the AMASS setvolgrp commands to assign the /archive/BFSDB_Backup directory to volume group 600: Step 3. T o make sure the directory assignment is correct, enter the AMASS vgroot commands to vie w the relati ve paths for v olume group 600.
System Administrator’ s Guide to Installing DataMgr Setup Tasks 3-9 Setup T asks Save SSD Logs DataMgr saves all file mo v ement by the SSD to the /etc/dm/log/ssd/transfile log file. The log files are named transfile.x , where “ x” is an age-related counter with the smaller number being the most current.
System Administrator’ s Guide to Installing DataMgr 3-10 Setup T asks T o revie w these files in case of system errors, ADIC recommends that you do not delete these “old” transfile.x files, but place them in one of the follo wing areas: • A DataMgr -managed directory so they can be migrated to AMASS.
System Administrator’ s Guide to Installing DataMgr Setup Tasks 3-11 Setup T asks In the crontab on the BFS: In the crontab on all DataMgr components: Step 3.
System Administrator’ s Guide to Installing DataMgr 3-12 Setup T asks Logging System log messages are designed to help: • Assess system operation. • Monitor performance.
System Administrator’ s Guide to Installing DataMgr Setup Tasks 3-13 Setup T asks Format of Messages The format of a system log message is illustrated belo w: Priority Levels All messages are contained within a single file for easy reading and problem solving.
System Administrator’ s Guide to Installing DataMgr 3-14 Setup T asks Modify Logging Characteristics Se veral characteristics of a system log message can be modified with en vironment variables in the /usr/dm/emasslogs/emasslog_parms file that is created at install time.
System Administrator’ s Guide to Installing DataMgr Setup Tasks 3-15 Setup T asks Modifiable V ariab les The en vironment v ariables listed in the table belo w can be modified if required: En viro.
System Administrator’ s Guide to Installing DataMgr 3-16 Setup T asks Logging that sho ws which commands hav e been run, the time it ran, and whether or not the command succeeded are located in /etc/dm/emasslogs/history/el_hist_00 . EL_SYSLOG_MASK (def aults to ud ) The log mask used f or prior ity 0-7 messages that are directed to the syslog.
System Administrator’ s Guide to Installing DataMgr Setup Tasks 3-17 Setup T asks The clean_emasslogs script will be added to the user’ s cron file upon installation. When this script is run it mov es the current set of logs to a file in the same directory with the same name, but appended with a timestamp.
System Administrator’ s Guide to Installing DataMgr 3-18 Setup T asks • The second way to sa ve logs and to mak e sure that there is always enough disk space, is to create a clean_emasslogs directory in AMASS with it’ s o wn volume group, in which to store the mov ed files.
System Administrator’ s Guide to Installing DataMgr Setup Tasks 3-19 Setup T asks Star t Administra- tive GUI Step 1. T o run the Administrativ e GUI, enter the xdmadm command. Step 2. The Services menu displays status and error messages. Star t Client GUI Step 1.
System Administrator’ s Guide to Installing DataMgr 3-20 Setup T asks Step 2. The Client Main menu appears. Change Colors and Fonts When you start both GUIs, they will use def ault colors and fonts. T o change the defaults file, follo w the steps belo w: Step 1.
System Administrator’ s Guide to Installing DataMgr Setup Tasks 3-21 Setup T asks Step 3. Use a text editor , such as vi, and edit the original file by substituting the desired colors or fonts. server*font: 9x15 server*fontlist: 9x15 server*background: steelblue server*forground: white Caution DO NO T CHANGE any other te xt in this file.
System Administrator’ s Guide to Installing DataMgr 3-22 Setup T asks NO TES.
P ost Installation 4 P ost Installation T asks Deinstall DataMgr . . . . . . . . . . . . . . . . . . . . . . . . . 4-3 Reinstall DataMgr . . . . . . . .
System Administrator’ s Guide to Installing DataMgr 4-2 Post Installation T asks Roadmap T ask Refer T o Chapter Install AMASS bef ore installing DataMgr . V erify that you ha v e the necessar y system requirements. 1 Install DataMgr . 2 Setup tasks: • Establish access f or clients.
System Administrator’ s Guide to Installing DataMgr Post Installation Tasks 4-3 P ost Installation Deinstall DataMgr If you no longer want to run DataMgr , you can deinstall it from your system by running the deinstallation script. It will remov e all DataMgr directories and files.
System Administrator’ s Guide to Installing DataMgr 4-4 Post Installation T asks Reinstall DataMgr If you upgrade a machine’ s operating system, you must reinstall DataMgr . Step 1. Back up the DataMgr directories and files listed belo w . Depending on the DataMgr component installed, all of these directories may not exist on the same machine.
System Administrator’ s Guide to Installing DataMgr Post Installation Tasks 4-5 P ost Installation Step 5. Run the installation script, which detects the existence of DataMgr configuration files and will not ov erwrite them.
System Administrator’ s Guide to Installing DataMgr 4-6 Post Installation T asks Remo ve Load Directory After the installation is complete, if space is limited you may want to remo ve the e xtracted DataMgr files from the machine where they were loaded.
System Administrator’ s Guide to Installing DataMgr Post Installation Tasks 4-7 P ost Installation NO TES.
System Administrator’ s Guide to Installing DataMgr 4-8 Post Installation T asks NO TES.
INX-1 Inde x Symbols /archive/FMSclients . . . . . . . . . . . . . 1-16 /etc/bfs . . . . . . . . . . . . . . . . . . . . . . . . 1-16 /etc/bfs/registered File . . . . . . . . . 1-7, 1-8 /etc/dm . . . . . . . . . . . . . . . . . . . . . . . . 1-16 /etc/dm/log/ssd .
System Administrator ’ s Guide to Installing DataMgr INX-2 Index D Database BFS . . . . . . . . . . . . . . . . . . . . . . . 2-10 DNS . . . . . . . . . . . . . . . . . . . . . . . 3-3 managed file system illustration . 1-16 NIS . . . . . . . . . . .
System Administrator ’ s Guide to Installing DataMgr Index INX-3 features . . . . . . . . . . . . . . . . . . . . . 1-3 issued to clients . . . . . . . . . . . . . . . 1-7 Load directory remove . . . . . . . . . . . . . . . . . . . . . . 4-6 Logs . .
System Administrator ’ s Guide to Installing DataMgr INX-4 Index T Table user completes prior to install . . . 1-17 transfile . . . . . . . . . . . . . . . . . . . . . . . . 3-9 U User ID . . . . . . . . . . . . . . . . . . . . . . . . 2-8 Utility bfsd_backup .
An important point after buying a device ADIC 3.5 (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 3.5 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 3.5 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, ADIC 3.5 you will learn all the available features of the product, as well as information on its operation. The information that you get ADIC 3.5 will certainly help you make a decision on the purchase.
If you already are a holder of ADIC 3.5, 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 3.5.
However, one of the most important roles played by the user manual is to help in solving problems with ADIC 3.5. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device ADIC 3.5 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
