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...
Purpose of This book describes how to install and configure DataMgr on both the server and on clients’ machines. This Book Who Should This book is written for the system administrators who has been assigned the task of installing DataMgr. Read This Book The table below lists DataMgr books that a system...
System Administrator’s Guide to Installing DataMgr How This This book contains the following chapters: Book is Chapter 1: Prerequisites — Defines system requirements for Organized DataMgr. Chapter 2: Install DataMgr — Instructions for installing DataMgr as well as special startup & shutdown procedures. Chapter 3: Setup Tasks —...
Conventions The conventions used throughout the DataMgr technical books are listed below: Convention The word “library” is a generic way to reference a storage device. Screen text, file names, program names, and commands are in Courier font. The root prompt is shown as a number symbol.
System Administrator’s Guide to Installing DataMgr Books The books described below are part of the technical documentation set and are shipped on CD along with the DataMgr software: System Administrator’s Guide to Installing DataMgr Install and configure DataMgr on a UNIX server and on clients’...
To receive access to the secured site on our home page containing technical product information (Release Notes, Site Product Alerts, Product Bulletins, FAQs), send e-mail to swpubs@adic.com and include the items below. In return, we will send you instructions and a password. • Name.
Page 16
System Administrator’s Guide to Installing DataMgr • Address. • Telephone number and fax number. • DataMgr serial number (or enter “reseller” if you are not a customer). • Your e-mail address. Preface...
Page 17
System Administrator’s Guide to Installing DataMgr NOTES Preface...
Page 18
System Administrator’s Guide to Installing DataMgr NOTES P-10 Preface...
Page 20
System Administrator’s Guide to Installing DataMgr Roadmap Install AMASS before installing DataMgr. Verify that you have the necessary system requirements. Install DataMgr. Setup tasks: • Establish access for clients. • Edit cron jobs. • Change GUI colors and fonts. Post installation tasks: •...
Capacity- ADIC issues a DataMgr license based on the amount of disk space each client machine mounts for management. based Capacity-based license levels are described below: License • Level 1 = Less than or equal to 5GB. • Level 2 = Over 5GB but less than or equal to 25GB.
Page 22
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.
file import. Step 1. Step 2. System Administrator’s Guide to Installing DataMgr Contact ADIC to receive an authorization string. /etc/bfs/usr/utils/bfsmaint initializes the license file. Therefore, when you update the temporary Product Key to a permanent Authorization String, use this utility as shown...
Page 24
System Administrator’s Guide to Installing DataMgr Step 3. License information for host zanzibar: Temporary license expires in 1 month Okay to overwrite license file? [n] y Enter your Authorization string for a permanent license: AAAA292X2QUV487BJAM License file written License information for host zanzibar: Number of level 1: 10 Number of level 2: 1 Number of level 3: 0...
BFS Issues The BFS issues each DMFS client the appropriate license level after receiving information on the amount of disk storage it License to manages on the client machine. If a license for the appropriate Clients level is not available, the BFS issues the client a license for the next higher level.
System Administrator’s Guide to Installing DataMgr If a client goes down while files are being migrated or reloaded, How to Refresh /etc/bfs/registered Registration File with the current client configurations. To refresh the File” on page 6-39 DataMgr. Prerequisites file can become out-of-sync file, refer to “Refresh Registration registered...
file pathnames can be a total of 997 characters in length. File System File system size is important. ADIC recommends that your file system not exceed 1 million files. As the number of files Size & Name approaches 1 million, the system slows considerably. The smaller the file system, the faster most utilities and commands...
System Administrator’s Guide to Installing DataMgr Large Files 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. •...
Page 29
System Administrator’s Guide to Installing DataMgr HP-UX Fileset X11R5-SHLIBS /usr/lib/Motif1.2/libXm.sl /usr/lib/X115R/libX11.sl /usr/lib/X11R5/libXt.sl IRIX Fileset 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.so Libraries Included Libraries Included Prerequisites 1-11...
Page 30
System Administrator’s Guide to Installing DataMgr Open Windows SUNWmfrun Add both LD_LIBRARY_PATH 1-12 Prerequisites Solaris X Windows Libraries Included /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 /usr/dt/lib /usr/openwin/lib environment variable. to the...
Disk Space The table below shows the amount of disk space required by DataMgr: Operating DMFS System 32MB 14MB HP-UX 30MB 13MB IRIX 37MB 12MB Solaris 31MB 10MB * The /etc/dm/log and /etc/dm/raima/log contain log files so this initial size will grow. # Use the equations found in “Size Databases”...
System Administrator’s Guide to Installing DataMgr Create Create a platform-specific directory to contain the DataMgr files extracted from the CD. The default directory is Installation /usr/dminstall Directory if space is limited, see If, for example, you have extracted Solaris-specific DataMgr files from the CD, your directory hierarchy would look similar to the illustration below: Determine...
• DMFS: Install the DMFS on all client machines that have file systems managed by DataMgr. The number of machines is limited by the number and level of licenses you have purchased. Summary of The illustration attempts to give you an overview of the DataMgr elements described below.
System Administrator’s Guide to Installing DataMgr • Location of DataMgr databases: • DataMgr-specific directories on AMASS: Create During the installation process, DataMgr creates and writes to the directories listed in the table below. If you do not use the Directories default directories, DataMgr creates the directory names that you enter in the script and the appropriate symbolic links.
Default Component Directory DMFS (clients) /etc/dmfs Complete Table 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 Link Path Component...
System Administrator’s Guide to Installing DataMgr Size The following database are used in DataMgr: Databases • 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.
Page 37
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. Example 1: if you have client files using a File Replication policy with 1 primary copy and 1 secondary copy, the equation would look like the following:...
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 The Managed File System Database is located under /etc/dm/raima/dmfs File System Database for each client’s managed file system. The Database Database contains all the information on each file in the managed file system and stores information used in generating a list of files...
Edit Paths The following environmental paths are not automatically set up during installation. man Pages Step 1. setenv MANPATH ${MANPATH}:/etc/dm/usr/share/man MANPATH=$MANPATH:/etc/dm/usr/share/man export MANPATH Utilities Step 2. set path=($path /etc/dm/usr/utils /etc/dmfs/usr/bin\ /etc/dmfs/usr/utils /etc/bfs/usr/bin /etc/bfs/usr/utils\ /etc/sld/usr/daemons /etc/ssd/usr/daemons /etc/bfs/usr/daemons) PATH=$PATH:/etc/dm/usr/utils:/etc/dmfs/usr/bin:/etc/dmfs/usr/utils:\ /etc/sld/usr/daemons:/etc/ssd/usr/daemons:/etc/bfs/usr/daemons:\ /etc/bfs/usr/ export PATH System Administrator’s Guide to Installing DataMgr To use the pages, set the following path.
System Administrator’s Guide to Installing DataMgr GUIs Step 3. Step 4. Step 5. Step 6. Step 7. # cp /etc/dm/usr/share/gui/xdmfskeysym # cp /etc/dm/usr/share/gui/xdmfskeysym 1-22 Prerequisites To run the Client GUI, add xdmfs to your /etc/dmfs/usr/bin PATH To run the Administrative xdmadm to your /etc/bfs/usr/bin...
Edit The DataMgr bringing space usage levels for a managed file system in line Temporary with the values defined by the DataMgr administrator with the Storage low and prestage watermarks. Space dmfsscan temporary file storage. If you want these files to be directed elsewhere, edit the / the "...
System Administrator’s Guide to Installing DataMgr System The system mount table defines the file systems and disk partitions that are mounted at boot time. Mount Table The file system name defined to DataMgr in the /etc/dmfs/config/dmfstab this system mount file. The location and format of this table varies by system architecture.The table below shows the location of this file on the various supported platforms:...
Page 43
System Administrator’s Guide to Installing DataMgr NOTES Prerequisites 1-25...
Page 44
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 .
Page 46
System Administrator’s Guide to Installing DataMgr Roadmap Install AMASS before installing DataMgr. Verify that you have the necessary system requirements. Install DataMgr. Setup tasks: • Establish access for clients. • Edit cron jobs. • Change GUI colors and fonts. Post installation tasks: •...
Extract Files From Local Step 2. Step 3. Step 4. # tar -xmvf/ cdrompath /datamgr/ platform.TAR Step 5. Step 6. System Administrator’s Guide to Installing DataMgr To install DataMgr from CD on a local host, perform the following procedure: Step 1. Log in as root Create a temporary directory under...
System Administrator’s Guide to Installing DataMgr Extract Files From Remote Step 2. Step 3. Step 4. # rsh nodename -n dd if=/cdrompath/datamgr/platform.TAR bs=20b | tar xmvBf - Installation To install DataMgr from CD on a remote host, perform the following procedure: Step 1.
Page 49
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.
BFS. • SSD. • DMFS. ADIC recommends that each component be started before the next component is installed. This will ensure that each component can talk to the others correctly. Caution The installation script inserts entries into various system files.
Page 51
Step 1. Step 2. a) DMFS - Data Manager File System (provides migrating file systems) b) BFS - Bitfile Server (requires installed SSD) c) SLD - Service Locator Daemon (must be one per network) d) SSD - Storage Server Daemon (provides local SSD; requires AMASS) e) ALL - All of the above Please enter a, b, c, d, e, or a list (eg, ab): Please enter a, b, c, d, e, or a list (eg, ab): e...
Page 52
System Administrator’s Guide to Installing DataMgr Step 4. Please enter the numeric user ID (uid) for the dmfs account: 357 Please enter the base group ID (gid) for the dmfs account: 86 Step 5. Installation • If you respond with y (default), the installation script will continue.
Page 53
Step 6. Step 7. Enter actual DataMgr home location [/install/datamgr/dm]: ________________ Append logging entries to /etc/syslog.conf? (y | n) [n]: ________________ Enter actual SLD (Service Locator Daemon home location [/etc/sld]: ________________ Enter actual DMFS (DataMgr FileSystem) home location [/etc/dmfs]:_____________ Enter actual BFS (Bitfile Server) home location [/etc/bfs]:__________________ Enter actual Raima database journal home location [/etc/dm/raima/journal]: ________________________________...
Page 54
System Administrator’s Guide to Installing DataMgr Please enter the hostname of the Storage Server to be used for storing database backups: ____________________________ Step 8. Enter actual Storage Server Archive directory location [/archive/FMSclients]:________________ Enter actual DataMgr database backup directory location [/archive/BFSDB_Backup]:______________ Step 9.
Page 55
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. of each file that it recovers to standard output, one per line. This utility can also be run manually.
Startup & Although the command to automatically start DataMgr at bootup is added to the system startup file during installation, a Shutdown special startup is required, for example, after the system administrator performs system maintenance. Step 1. Step 2. System Administrator’s Guide to Installing DataMgr To gracefully bring DataMgr down, run the script below.
Page 58
System Administrator’s Guide to Installing DataMgr NOTES 2-14 Installation...
Page 59
System Administrator’s Guide to Installing DataMgr NOTES Installation 2-15...
Page 60
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 .
Page 62
System Administrator’s Guide to Installing DataMgr Roadmap Install AMASS before installing DataMgr. Verify that you have the necessary system requirements. Install DataMgr. Setup tasks: • Establish access for clients. • Edit cron jobs. • Change GUI colors and fonts. Post installation tasks: •...
Establish Step 1. Access for DMFS Clients Step 2. System Administrator’s Guide to Installing DataMgr 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.
System Administrator’s Guide to Installing DataMgr Schedule During installation, DataMgr puts entries in the that perform the tasks described below. If the default schedule cron Jobs does not suit your site’s needs, edit the information, see DMFS cron job On all DMFS Clients, the jobs: •...
• Nightly at 1 a.m.: Runs the /etc/dm/usr/scripts/clean_emasslogs 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 clean_emasslogs script also saves seven old log files per log type plus the current log.
files according to the defined storage policy as well as manages the retention and expiration of migrated files. ADIC recommends that you schedule these administrative tasks after the backup of a client’s managed file systems has completed. Therefore, the sequence of execution should be as follows: Step 1.
Step 3. Step 4. Assign a Backup Step 1. Volume System Administrator’s Guide to Installing DataMgr If this nightly backup fails, DataMgr sends a mail message to notifying the system administrator root the status of the . Failed backups are bfsdb_backup sent to /etc/dm/raima/log/...
Page 68
System Administrator’s Guide to Installing DataMgr Step 2. Step 3. Step 4. Setup Tasks Enter the AMASS commands to assign setvolgrp directory to /archive/BFSDB_Backup volume group 600: # cd /archive/BFSDB_Backup # setvolgrp /archive/BFSDB_Backup 600 To make sure the directory assignment is correct, enter the AMASS commands to view the vgroot...
Save SSD Logs DataMgr saves all file movement by the SSD to the /etc/dm/log/ssd/transfile named with the smaller number being the most current. At installation, DataMgr schedules a nightly backs up the SSD log and saves the current transfile log to a transfile.x transfile deleted.
filepath To review these files in case of system errors, ADIC recommends that you do not delete these “old” files, but place them in one of the following areas: • A DataMgr-managed directory so they can be migrated to AMASS.
System Administrator’s Guide to Installing DataMgr Logging System log messages are designed to help: • Assess system operation. • Monitor performance. • Check system health. • Resolve problems. Logging The figure below illustrates the logging hierarchy with the customer-specific Hierarchy System Messages 3-12...
Format of The format of a system log message is illustrated below: Messages Aug 14 1:16:12 nserv dataMgr dmfsd[1001]: E0006 (5) <00000> Message. Host name. Product name, DataMgr in this case. Process that logs message. Month, day, time message was generated. Priority Levels All messages are contained within a single file for easy reading and problem solving.
System Administrator’s Guide to Installing DataMgr Priority Level DEBUG: messages. ADIC technical support trace message. Modify Logging Several characteristics of a system log message can be modified with environment variables in the Characteristics /usr/dm/emasslogs/emasslog_parms at install time. When the reload_dmlog the new options.
Page 75
Modifiable Variables Environment Variable EL_SYSLOG_FACILITY (DataMgr defaults to 1) (AMASS defaults to 2) EL_SYSLOG_OPTIONS (defaults to p) System Administrator’s Guide to Installing DataMgr The environment variables listed in the table below can be modified if required: Description Identifies the UNIX user-definable logging process that sends DataMgr messages to the system log.
Page 76
System Administrator’s Guide to Installing DataMgr Environment Variable EL_SYSLOG_MASK (defaults to ud) Logging that shows which commands have been run, the time it ran, and whether or not the command succeeded are located in /etc/dm/emasslogs/history/el_hist_00 3-16 Setup Tasks Description The log mask used for priority 0-7 messages that are directed to the syslog.
Page 77
clean_emasslogs 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:25:01:00:00...
Page 78
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 script, •...
Start Step 1. Administra- tive GUI Step 2. To quit, select Services-->Exit. Start Client GUI Step 1. System Administrator’s Guide to Installing DataMgr To run the Administrative GUI, enter the command. # xdmadm The Services menu displays status and error messages.
System Administrator’s Guide to Installing DataMgr Step 2. To quit, select File-->Exit. Change Colors When you start both GUIs, they will use default colors and fonts. To change the defaults file, follow the steps below: and Fonts Step 1. Step 2. 3-20 Setup Tasks The Client Main menu appears.
Page 81
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: server*fontlist: server*background: server*forground: Caution DO NOT CHANGE any other text in this file. 9x15 9x15 steelblue...
Page 82
System Administrator’s Guide to Installing DataMgr NOTES 3-22 Setup Tasks...
Page 84
System Administrator’s Guide to Installing DataMgr Roadmap Install AMASS before installing DataMgr. Verify that you have the necessary system requirements. Install DataMgr. Setup tasks: • Establish access for clients. • Edit cron jobs. • Change GUI colors and fonts. Post installation tasks: •...
Deinstall If you no longer want to run DataMgr, you can deinstall it from your system by running the deinstallation script. It will remove DataMgr 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.
System Administrator’s Guide to Installing DataMgr Reinstall If you upgrade a machine’s operating system, you must reinstall DataMgr. DataMgr Step 1. Step 2. Step 3. Step 4. Post Installation Tasks 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.
Page 87
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. # /etc/dm/scripts/install_dm Post Installation Tasks...
System Administrator’s Guide to Installing DataMgr Remove Load After the installation is complete, if space is limited you may want to remove the extracted DataMgr files from the machine Directory where they were loaded. Step 1. solaris/ books/ Step 2. Post Installation Tasks In our example, you have extracted Solaris-specific DataMgr files as well as the PDF books from the...
Page 89
System Administrator’s Guide to Installing DataMgr NOTES Post Installation Tasks...
Page 90
System Administrator’s Guide to Installing DataMgr NOTES Post Installation Tasks...
Need help?
Do you have a question about the DataMgr Version 3.5 and is the answer not in the manual?
Questions and answers