System Administrator’s Guide to Installing DataMgr DataMgr Version 3.
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. Copyright Notice Copyright © 1996-2000 by ADIC. All rights reserved. This document is the property of ADIC.
READER COMMENT FORM 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.com Question Circle One Information was complete. Agree Disagree Information was easy to find. Agree Disagree Information was easy to follow.
NOTES
Contents Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .P-3 How This Book is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .P-4 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .P-5 Books . . . . . . .
System Administrator’s Guide to Installing DataMgr Disk Space . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13 Create Installation Directory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14 Determine Location for Components . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14 Summary of Elements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Administrator’s Guide to Installing DataMgr DMFS cron job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4 BFS cron job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5 Back Up Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6 Assign a Backup Volume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Administrator’s Guide to Installing DataMgr iv Contents
Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . .P-3 Who Should Read This Book . . . . . . . . . . . . . . . .P-3 How This Book is Organized . . . . . . . . . . . . . . . .P-4 Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .P-5 Books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .P-6 Online Documentation . . . . . . . . . . . . . . . . . .P-6 Related Publications . . . . . . . . . . . . . . . . . . . .
System Administrator’s Guide to Installing DataMgr NOTES P-2 Preface
Purpose of This Book This book describes how 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. The table below lists DataMgr books that a system administrator should read: Books for System Administrators to Read Topic DataMgr Overview Understand how DataMgr works and know what features are available.
System Administrator’s Guide to Installing DataMgr How This Book is Organized This book contains the following chapters: Chapter 1: Prerequisites — Defines system requirements for DataMgr. Chapter 2: Install DataMgr — Instructions for installing DataMgr as well as special startup & shutdown procedures. Chapter 3: Setup Tasks — Instructions for the following tasks: • Establish access for clients. • Edit cron jobs. • Change color and fonts on GUIs.
Conventions The conventions used throughout the DataMgr technical books are listed below: Convention Example The word “library” is a generic way to reference a storage device. If using HP SunSpot libraries, install patch 1234. Screen text, file names, program names, and commands are in Courier font. Files/Dirs created for MFS /mrktcol: /mrktcol/Migration /mrktcol/Migration/locklist The root prompt is shown as a number symbol. # su root What you should type in is shown in Courier bold font.
System Administrator’s Guide to Installing DataMgr Books System Administrator’s Guide to Installing DataMgr Install and configure DataMgr on a UNIX server and on clients’ workstations. DataMgr Overview An introduction to DataMgr, an hierarchical storage management (HSM) application. Contains a glossary. System Administrator’s Guide to Using DataMgr Define managed file system criteria with either commands or GUI. Describes DataMgr commands and utilities. Describe backup and restore issues.
Related Publications The publications described in the table below are created and distributed on an as-needed basis: Related Publications “Release Notes” Description For each version of DataMgr, the “Release Notes” contain: • Summary of enhancements. • Describes: - Fixed problems. - Known problems. - Installation and configuration issues. • Lists: - Operating system patches. - System requirements. “Product Alerts” Informs customers of technical problems and solutions.
System Administrator’s Guide to Installing DataMgr P-8 Preface • Address. • Telephone number and fax number. • DataMgr serial number (or enter “reseller” if you are not a customer). • Your e-mail address.
NOTES Preface P-9 Preface System Administrator’s Guide to Installing DataMgr
System Administrator’s Guide to Installing DataMgr NOTES P-10 Preface
1 Prerequisites Prerequisites Capacity-based License . . . . . . . . . . . . . . . . . . . . . 1-3 BFS Issues License to Clients . . . . . . . . . . . . . . . . 1-7 Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9 Create Installation Directory . . . . . . . . . . . . . . . 1-14 Determine Location for Components . . . . . . . . 1-14 Size Databases . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18 Edit Paths . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
System Administrator’s Guide to Installing DataMgr Roadmap Task Refer To Chapter Install AMASS before installing DataMgr. Verify that you have the necessary system requirements. 1 Install DataMgr. 2 Setup tasks: 3 • Establish access for clients. • Edit cron jobs. • Change GUI colors and fonts. Post installation tasks: • Deinstall and reinstall DataMgr. • Remove installation directory.
System Administrator’s Guide to Installing DataMgr Capacitybased License ADIC issues a DataMgr license based on the amount of disk space each client machine mounts for management. Capacity-based license levels are described below: Level 1 = Less than or equal to 5GB. • Level 2 = Over 5GB but less than or equal to 25GB. • Level 3 = Greater than 25GB. The license is entered when installing the BFS component. The BFS provides the licenses needed by the individual DMFS clients.
System Administrator’s Guide to Installing DataMgr • All strung together. If your Software Certificate does not contain this string, call ADIC at (303) 792-9700 or FAX (303) 792-2465 or email techsup@adic.com and they will issue you an authorization string after you provide them with the required information. How to find this required information is described below: Serial Number Look at the DataMgr CD and write down the serial number.
System Administrator’s Guide to Installing DataMgr Temporary Product Key The generic 30-day temporary product key is: U3QEYUCJ. Note The temporary product key does not enable File Replication, Multi-tier, or File Import. Changing Authorization String Change the authorization string if any of the following conditions apply: • You proceed from an evaluation to a purchase. • You add clients or upgrade clients (therefore add to the disk space) that DataMgr manages.
System Administrator’s Guide to Installing DataMgr Note Use the bfsmaint -i utility option only when DataMgr is running. Step 3. DataMgr replies with the message illustrated below, which confirms that you want to overwrite the license file. When prompted, enter a new authorization string. Your responses are shown in bold.
System Administrator’s Guide to Installing DataMgr BFS Issues License to Clients For example, if a client has 3GB of space for management, it needs a Level 1 license. If a Level 1 licenses is not available, the BFS will try to issue a Level 2 license, and if there are none available, it will try to issue a Level 3 license. If a client attempts to use either file replication or multi-tier migration, but the BFS does not have the appropriate feature license, the operation will fail.
System Administrator’s Guide to Installing DataMgr How to Refresh Registration File If a client goes down while files are being migrated or reloaded, the /etc/bfs/registered file can become out-of-sync with the current client configurations. To refresh the registered file, refer to “Refresh Registration File” on page 6-39 in System Administrator’s Guide to Using DataMgr.
System Administrator’s Guide to Installing DataMgr Requirements Make sure you read the DataMgr “Release Notes” to obtain the following information: A list of current patches and packages required by your servers. • GUI requirements. • Known problems. • The latest AMASS compatibility matrix. Install a compatible version of AMASS on a server on your network to provide storage server resources. Note Install and start AMASS before installing DataMgr.
System Administrator’s Guide to Installing DataMgr Large Files Shared Libraries If a DMFS client requires DataMgr to manage files larger than 2GB, the BFS must support large files. Large file support is provided on the following operating system: • AIX 4.2.1 and 4.3. • HP-UX 10.20 HP-UX 11.0. • IRIX 6.2, 6.4, and 6.5 • Solaris 2.6 and 7.0. The tables below list required shared libraries for successful operation of both the Client GUI and the Administrative GUI.
System Administrator’s Guide to Installing DataMgr HP-UX Fileset /usr/lib/Motif1.2/libXm.sl Prerequisites X11R5-SHLIBS Libraries Included /usr/lib/X115R/libX11.sl /usr/lib/X11R5/libXt.sl IRIX Fileset Libraries Included x_eoe.sw.eoe /usr/lib/libXaw.so motif_eoe.sw.eoe /usr/lib/libXmu.so /usr/lib/libXt.so /usr/lib/libX11.so /usr/lib/libXext.
System Administrator’s Guide to Installing DataMgr Solaris X Windows Libraries Included 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.so /usr/openwin/lib/libXext.so Add both /usr/dt/lib and /usr/openwin/lib to the LD_LIBRARY_PATH environment variable.
System Administrator’s Guide to Installing DataMgr Disk Space Operating System The table below shows the amount of disk space required by DataMgr: BFS SLD SSD /etc/dm* AIX 32MB 14MB 140KB 4MB 8MB HP-UX 30MB 13MB 66KB 10MB 5MB IRIX 37MB 12MB 156KB 4MB 5MB Solaris 31MB 10MB 91KB 4MB 5MB Prerequisites DMFS /etc/dm/raima/bfs and /etc/dm/raima/dmfs# BFS Database and Managed File System Database * The /etc/dm/log and /etc/dm/raima/log contain log files so this initial size will
System Administrator’s Guide to Installing DataMgr Create Installation Directory Create a platform-specific directory to contain the DataMgr files extracted from the CD. The default directory is /usr/dminstall. For instructions on deleting this directory if space is limited, see “Remove Load Directory” on page 4-6.
System Administrator’s Guide to Installing DataMgr • DMFS Client Stub The illustration attempts to give you an overview of the DataMgr elements described below. BFS & SLD Administrative xdmadm GUI. Stub file is left behind after DataMgr migrates a file. BFS Database correlates BFIDs with RIDs. Client xdmfs GUI. Client Transaction Database. Library RIDs & Bitfiles for migrated files Bitfile IDs for migrated files Has file systems managed by DataMgr.
System Administrator’s Guide to Installing DataMgr • Location of DataMgr databases: • - Transaction Database is on each client’s machine. - Managed File System Database is on each client’s machine. To calculate the size of this database, see “Size Managed File System Database” on page 1-20. - BFS Database is on BFS. To calculate the size of this Database, see “Size BFS Database” on page 1-18.
System Administrator’s Guide to Installing DataMgr Component DMFS (clients) Component Description /etc/dmfs Location of DMFS executables. Complete the table below when answering the installation questions. If you are installing a DMFS client component on more than one machine, make as many copies of this table as needed. If symbolic links are used, write down the appropriate path for each machine in both the Default Path and Symbolic Link Path columns.
System Administrator’s Guide to Installing DataMgr Size Databases The following database are used in DataMgr: • BFS Database on the BFS component. • Managed File System Database on each client. • Client Transaction Database on each client. Both the BFS Database and the Managed File System Database must be sized.
System Administrator’s Guide to Installing DataMgr If File Replication or Multi-tier Policies are used, then the equation is: Database size = ((64 + (factor * 16)) * Number of files being migrated factor = Number of replicated copies or number of tiers.
System Administrator’s Guide to Installing DataMgr Note A BFS Database that is 2GB in size can contain information for 20 million managed files. 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. The Database contains all the information on each file in the managed file system and stores information used in generating a list of files to migrate.
System Administrator’s Guide to Installing DataMgr Edit Paths The following environmental paths are not automatically set up during installation. man Pages Step 1. To use the man pages, set the following path. Prerequisites For each c shell environment: setenv MANPATH ${MANPATH}:/etc/dm/usr/share/man For each bourne shell environment: MANPATH=$MANPATH:/etc/dm/usr/share/man export MANPATH Utilities Step 2.
System Administrator’s Guide to Installing DataMgr GUIs Step 3. To run the Client xdmfs GUI, add /etc/dmfs/usr/bin to your PATH. Step 4. To run the Administrative xdmadm GUI, add /etc/bfs/usr/bin to your PATH. Step 5. Both the Client GUI and the Administrative GUI require the files below to be in the /etc/dm/usr/share/gui directory. These files are located in this directory during a normal DataMgr installation. • • • • Step 6. server xdmfs xdmfs.
System Administrator’s Guide to Installing DataMgr The DataMgr dmfsscan command controls migration by bringing space usage levels for a managed file system in line with the values defined by the DataMgr administrator with the low and prestage watermarks. The dmfsscan command, as a default, uses /usr/tmp for temporary file storage.
System Administrator’s Guide to Installing DataMgr System Mount Table 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. The location and format of this table varies by system architecture.
System Administrator’s Guide to Installing DataMgr NOTES Prerequisites Prerequisites 1-25
System Administrator’s Guide to Installing DataMgr NOTES 1-26 Prerequisites
Extract Files From Local CD . . . . . . . . . . . . . . . . . 2-3 Extract Files From Remote CD . . . . . . . . . . . . . . . 2-4 Install DataMgr . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6 Startup File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-12 Startup & Shutdown . . . . . . . . . . . . . . . . . . . . . .
System Administrator’s Guide to Installing DataMgr Roadmap Task Refer To Chapter Install AMASS before installing DataMgr. Verify that you have the necessary system requirements. 1 Install DataMgr. 2 Setup tasks: 3 • Establish access for clients. • Edit cron jobs. • Change GUI colors and fonts. Post installation tasks: • Deinstall and reinstall DataMgr. • Remove installation directory.
System Administrator’s Guide to Installing DataMgr Extract Files From Local CD L To install DataMgr from CD on a local host, perform the following procedure: Step 1. Log in as root. Step 2. Create a temporary directory under /tmp and cd to that directory. Step 3. Do an ls on the cdrompath to determine the case (upper or lower) of the file names. Some platforms will change the name from upper case (DM) to lower case (dm) letters. Step 4.
System Administrator’s Guide to Installing DataMgr Extract Files From Remote CD R To install DataMgr from CD on a remote host, perform the following procedure: Step 1. Log in as root. Step 2. Create a temporary directory under /tmp and cd to that directory. Step 3. Do an ls on the cdrompath to determine the case (upper or lower) of the file names. Some platforms will change the name from upper case (DM) to lower case (dm) letters. Step 4.
System Administrator’s Guide to Installing DataMgr Step 5. If you have 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. Step 6. Continue with “Install DataMgr” on Page 2-6.
System Administrator’s Guide to Installing DataMgr Install DataMgr If the various components are going to be installed on different machines, the installation sequence is as follows: • SLD. Note The SLD component should be installed first and must be running when the DMFS is installed. This only applies if the two components are located on different machines. • BFS. • SSD. • DMFS. ADIC recommends that each component be started before the next component is installed.
System Administrator’s Guide to Installing DataMgr 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. # cd /usr/dminstall/hpux1020 # ./install_dm Step 2. The installation script prompts you to enter the letter that corresponds to the component you want to install.
System Administrator’s Guide to Installing DataMgr Step 4. • If you respond with y (default), the installation script will continue. • If you respond with n, the installation script will terminate. You can Start DataMgr, perform a full BFS Database backup, then run the installation script again. The installation script prompts you to enter both the User ID and Group ID. The specified GID should already exist, but DataMgr will add the UID to the machine’s passwd file.
System Administrator’s Guide to Installing DataMgr Step 6. If the SLD and the DMFS are going to be installed on different machines, you must go to the SLD machine and start the SLD (run /etc/rc.dm) before continuing with this installation. Step 7. If you want to accept the default location for the files specific to the components, press . However, if you want DataMgr to create another directory for these files, enter a new path.
System Administrator’s Guide to Installing DataMgr Please enter the hostname of the Storage Server to be used for storing database backups: ____________________________ Step 8. If you accept the default location for the mount point, AMASS bitfiles directory, and BFS Database backup directory, press . However, if you want DataMgr to create another directory, enter a new path.
System Administrator’s Guide to Installing DataMgr Step 11. Enter the license strings that were purchased. For information, see “Capacity- based License” on page 1-3. Step 12. If you have installed DMFS and the script indicates that you should reboot (some systems require a reboot when the kernel is modified), then reboot when the script is complete.
System Administrator’s Guide to Installing DataMgr Startup File The startup file performs the following tasks: • Cleans up any migrations or reloads that were in progress when the system went down by running /etc/dmfs/usr/utils/dmfsck.It writes the bitfile ID of each file that it recovers to standard output, one per line. This utility can also be run manually. For information, refer to the Utility Reference chapter in System Administrator’s Guide to Using DataMgr.
System Administrator’s Guide to Installing DataMgr Startup & 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. Step 1. To gracefully bring DataMgr down, run the script below. This stops DataMgr and unloads the DMFS driver on systems that support loadable device drivers. # /etc/dm/usr/utils/killdmfs Step 2.
System Administrator’s Guide to Installing DataMgr NOTES 2-14 Installation
System Administrator’s Guide to Installing DataMgr NOTES Installation Installation 2-15
System Administrator’s Guide to Installing DataMgr 2-16 Installation
Establish Access for DMFS Clients . . . . . . . . . . . 3-3 Schedule cron Jobs . . . . . . . . . . . . . . . . . . . . . . . . . 3-4 DMFS cron job . . . . . . . . . . . . . . . . . . . . . . . . . 3-4 BFS cron job . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5 Back Up Databases . . . . . . . . . . . . . . . . . . . . . . 3-6 Save SSD Logs . . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12 Logging Hierarchy . . . .
System Administrator’s Guide to Installing DataMgr Roadmap Task Refer To Chapter Install AMASS before installing DataMgr. Verify that you have the necessary system requirements. 1 Install DataMgr. 2 Setup tasks: 3 • Establish access for clients. • Edit cron jobs. • Change GUI colors and fonts. Post installation tasks: • Deinstall and reinstall DataMgr. • Remove installation directory.
System Administrator’s Guide to Installing DataMgr Establish Access for 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. By default, clients can only view managed file system selections and migration criteria. Therefore, give clients root access if you want them to be able to add file systems and edit migration criteria. For information on file permission, refer to the chmod manual page.
System Administrator’s Guide to Installing DataMgr Schedule cron Jobs During installation, DataMgr puts entries in the root crontab that perform the tasks described below. If the default schedule does not suit your site’s needs, edit the cron file. For more information, see “Edit cron File” on page 3-10.
System Administrator’s Guide to Installing DataMgr • Nightly at 1 a.m.: Runs the /etc/dm/usr/scripts/clean_emasslogs script to move the current set of logs to a file in the same directory with the same name, but appended with a timestamp. For more information, see “Edit cron File” on page 3-10. The clean_emasslogs script also saves seven old log files per log type plus the current log. BFS cron job On the BFS, the crontab performs the following jobs: • Nightly at 2 a.m.
System Administrator’s Guide to Installing DataMgr Back Up Databases To effectively and efficiently manage your clients’ file systems, coordinate the execution of the following utilities by scheduling them as cron jobs: • /etc/dmfs/user/utils/dmfsscan — controls file migration. • /etc/bfs/usr/utils/bfsmaint — copies and replicates migrated files according to the defined storage policy as well as manages the retention and expiration of migrated files.
System Administrator’s Guide to Installing DataMgr 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.logfilename. You can recover a previous backup version of the database by using the /etc/bfs/usr/utils/bfsdb_restore utility that allows you to either restore the most recent backup or restore a specified version.
System Administrator’s Guide to Installing DataMgr Step 2. Enter the AMASS setvolgrp commands to assign the /archive/BFSDB_Backup directory to volume group 600: # cd /archive/BFSDB_Backup # setvolgrp /archive/BFSDB_Backup 600 Step 3. To make sure the directory assignment is correct, enter the AMASS vgroot commands to view the relative paths for volume group 600. # vgroot 600 Step 4. 3-8 Setup Tasks Assign volumes to volume group 600 with the AMASS volgroup command.
System Administrator’s Guide to Installing DataMgr Save SSD Logs DataMgr saves all file movement 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. At installation, DataMgr schedules a nightly cron job that backs up the SSD log and saves the current transfile log to a transfile.x file and then creates a new file called transfile. However, the old transfile.x files are never deleted.
System Administrator’s Guide to Installing DataMgr Field Description ftoken AMASS RID (record ID). bfsserver BFS server name. Valid only for Creat type. logid Internal log ID number used by DataMgr. errors Zero indicates success; non-zero indicates failure. filepath Path name to file. For Renam type, this is the new filename. To review these files in case of system errors, ADIC recommends that you do not delete these “old” transfile.
System Administrator’s Guide to Installing DataMgr In the crontab on the BFS: 0 2 * * * /etc/bfs/usr/utils/bfsmaint -v -d 1 -m 0 4 * * 0-5 /etc/bfs/usr/utils/bfsdb_backup -v -n 0 4 * * 6 /etc/bfs/usr/utils/bfsdb_backup -v -n -f Note The -n option of bfsdb_backup causes bfsdb_notify to send a mail message to root notifying the system administrator of any bfsdb_backup failure.
System Administrator’s Guide to Installing DataMgr Logging Logging Hierarchy System log messages are designed to help: • Assess system operation. • Monitor performance. • Check system health. • Resolve problems. The figure below illustrates the logging hierarchy with the customer-specific parms/ directory annotated.
System Administrator’s Guide to Installing DataMgr Format of Messages The format of a system log message is illustrated below: Aug 14 1:16:12 nserv dataMgr dmfsd[1001]: E0006 (5) <00000> Message. Actual Text. Host name. Transaction number, always 00000. Product name, DataMgr in this case. Priority level, in parentheses. Process that logs message. Log number, begins with “E.” Month, day, time message was generated. Message destination PID in brackets [ ].
System Administrator’s Guide to Installing DataMgr Priority Level Description 7 DEBUG: messages. 8 ADIC technical support trace message. Modify Logging Characteristics Several characteristics of a system log message can be modified with environment variables in the /usr/dm/emasslogs/emasslog_parms file that is created at install time. When the emasslog_parms file is modified, run the reload_dmlog script, or stop and start the DMFS to activate the new options.
System Administrator’s Guide to Installing DataMgr Modifiable Variables The environment variables listed in the table below can be modified if required: Environment Variable EL_SYSLOG_FACILITY (DataMgr defaults to 1) (AMASS defaults to 2) Description Identifies the UNIX user-definable logging process that sends DataMgr messages to the system log.
System Administrator’s Guide to Installing DataMgr Environment Variable EL_SYSLOG_MASK (defaults to ud) Description The log mask used for priority 0-7 messages that are directed to the syslog. From the options available use one option or any option combined with “u.” Options are: a = use LOG_ALERT for priority level 1 e = use LOG_EMERG for priority level 0.
System Administrator’s Guide to Installing DataMgr The clean_emasslogs script will be added to the user’s cron file upon installation. When this script is run it moves the current set of logs to a file in the same directory with the same name, but appended with a timestamp.Shown below is an example of a moved logs with the timestamp applied. # ls /etc/dm/emasslogs/history el_hist_00 el_hist_00.1999:11:28:01:00:00 el_hist_00.1999:11:25:01:00:00 el_hist_00.1999:11:29:01:00:00 el_hist_00.
System Administrator’s Guide to Installing DataMgr • The second way to save logs and to make sure that there is always enough disk space, is to create a clean_emasslogs directory in AMASS with it’s own volume group, in which to store the moved files. Then edit the clean_emasslogs script, SAVE_DIR parameter. • To use the reload_dmlog script with the emasslog_parms file, follow the steps below: Step 1. Edit the emasslog_parms file to indicate which logging levels to turn on and off.
System Administrator’s Guide to Installing DataMgr Start Administrative GUI Step 1. To run the Administrative GUI, enter the xdmadm command. # xdmadm Step 2. The Services menu displays status and error messages. To quit, select Services-->Exit. To display help, select Help-->General Help. Setup Tasks Start Client GUI Step 1. To run the Client GUI, enter the xdmfs command.
System Administrator’s Guide to Installing DataMgr Step 2. The Client Main menu appears. To quit, select File-->Exit. Change Colors and Fonts 3-20 Setup Tasks To display help, select Help-->General Help. When you start both GUIs, they will use default colors and fonts. To change the defaults file, follow the steps below: Step 1. Administrative GUI: Make a backup copy of the /etc/dm/usr/share/gui/server file, which contains default values. Step 2.
System Administrator’s Guide to Installing DataMgr 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 NOT CHANGE any other text in this file.
System Administrator’s Guide to Installing DataMgr NOTES 3-22 Setup Tasks
Deinstall DataMgr . . . . . . . . . . . . . . . . . . . . . . . . . 4-3 Reinstall DataMgr . . . . . . . . . . . . . . . . . . . . . . . . . 4-4 Remove the Installation Directory . . . . . . . . . . . .
System Administrator’s Guide to Installing DataMgr Roadmap Task Refer To Chapter Install AMASS before installing DataMgr. Verify that you have the necessary system requirements. 1 Install DataMgr. 2 Setup tasks: 3 • Establish access for clients. • Edit cron jobs. • Change GUI colors and fonts. Post installation tasks: • Deinstall and reinstall DataMgr. • Remove installation directory.
System Administrator’s Guide to Installing DataMgr Deinstall DataMgr If you no longer want to run DataMgr, you can deinstall it from your system by running the deinstallation script. It will remove all DataMgr directories and files. Caution Do not run deinstall_dm before upgrading or reinstalling DataMgr because it will totally remove all DataMgr files from your system. On the other hand, the install_dm script will remove just the files it needs to before reinstalling DataMgr. Step 1.
System Administrator’s Guide to Installing DataMgr Reinstall DataMgr If you upgrade a machine’s operating system, you must reinstall DataMgr. Step 1. Back up the DataMgr directories and files listed below. Depending on the DataMgr component installed, all of these directories may not exist on the same machine. • • • • • /etc/dm /etc/dmfs /etc/bfs /etc/sld /etc/ssd Step 2. When you reinstall DataMgr, both GUI default files (/etc/dm/usr/share/gui/server and /etc/dm/usr/share/gui/xdmfs) are replaced.
System Administrator’s Guide to Installing DataMgr Step 5. Run the installation script, which detects the existence of DataMgr configuration files and will not overwrite them.
System Administrator’s Guide to Installing DataMgr Remove Load Directory After the installation is complete, if space is limited you may want to remove the extracted DataMgr files from the machine where they were loaded. Step 1. In our example, you have extracted Solaris-specific DataMgr files as well as the PDF books from the CD, your directory hierarchy would look similar to the illustration below: / (root) usr/ home/ tmp/ lib/ bin/ dminstall/ solaris/ books/ Step 2.
System Administrator’s Guide to Installing DataMgr NOTES 4-7 Post Installation Post Installation Tasks
System Administrator’s Guide to Installing DataMgr NOTES 4-8 Post Installation Tasks
Index 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 . . . . . . . . . . . . . . . . . . 3-9 /etc/dm/raima . . . . . . . . . . . . . . . . . . . 2-9 /etc/dm/usr/share/gui . . . . . . . . . . . . . 3-20 /etc/dmfs . . . . . . . . . . . . . . . . . . . . . . 1-17 /etc/dmfs/config/dmfstab . . . . . . . . . .
System Administrator’s Guide to Installing DataMgr D Database BFS . . . . . . . . . . . . . . . . . . . . . . . 2-10 DNS . . . . . . . . . . . . . . . . . . . . . . . 3-3 managed file system illustration . 1-16 NIS . . . . . . . . . . . . . . . . . . . . . . . . 3-3 Deinstall DataMgr . . . . . . . . . . . . . . . 4-3 deinstall_dm script . . . . . . . . . . . . . . . 4-3 Directory /archive/FMSclients . . . . . . . . . . 1-16 /etc/bfs. . . . . . . . . . . . . . . . . . . . . 1-16 /etc/dm . . . . . . . . . .
System Administrator’s Guide to Installing DataMgr features . . . . . . . . . . . . . . . . . . . . . 1-3 issued to clients . . . . . . . . . . . . . . . 1-7 Load directory remove. . . . . . . . . . . . . . . . . . . . . . 4-6 Logs. . . . . . . . . . . . . . . . . . . . . . . 3-4, 3-9 clear . . . . . . . . . . . . . . . . . . . . . . . . 3-9 Registration file . . . . . . . . . . . . . . . . . 1-7 refresh . . . . . . . . . . . . . . . . . . . . . . 1-8 Reinstall DataMgr. . . . . . . . . . . . . . . .
System Administrator’s Guide to Installing DataMgr T Table user completes prior to install. . . 1-17 transfile . . . . . . . . . . . . . . . . . . . . . . . . 3-9 U User ID . . . . . . . . . . . . . . . . . . . . . . . . 2-8 Utility bfsd_backup . . . . . . . . . . . . . . . . 3-11 bfsdb_backup . . . . . . . . . . . . . . . . 3-5 bfsmaint . . . . . . . . . . . .3-5, 3-6, 3-11 dmfsaudit . . . . . . . . . . . . . . 3-4, 3-10 dmfsscan . . . . . . . . . . . . 3-4, 3-6, 3-10 set up path to. . . . . . . . . . . .
