Raining Data Corporation mvEnterprise 4.1.0 on AIX, Installation Manual

Page 1: ...pril 02 2002 mvEnterprise Release 4 1 0 on AIX Ó 1998 2002 Raining Data Corporation This document refers to products that are either currently released or are yet to be released Please consult your Raining Data Representative for more information ...

Page 2: ...AIX are trademarks of IBM Corporation and are being used under license PICK is a registered trademark of Raining Data Corporation UNIX is a registered trademark of The Open Group in the US and other countries All other brand or product names are or may be trademarks or registered trademarks of their respective companies or organizations ...

Page 3: ... the System for mvEnterprise on AIX 41 2 1 Getting Started 41 2 2 Configure Tape Devices for mvEnterprise on AIX 43 2 2 1 Special Considerations for 4mm DAT Units 45 2 2 2 Special Considerations for Cartridge Tape Units 45 2 2 3 Further Configuration Information For All Tape Devices 47 2 2 4 Update the config tape file 47 2 3 Configure Disks for mvEnterprise on AIX 48 2 3 1 Create a Logical Volume...

Page 4: ...Page ii mvEnterprise Release 4 1 on AIX Installation Guide ...

Page 5: ...RTANT Contact Raining Data Customer Support at 949 261 1875 or your local office for any questions concerning user written assembler modes If you have any user written assembler modes and or third party packages they must be recompiled and reinstalled after the installation procedure is complete mvEnterprise Release 4 1 on AIX Installation Guide Page 3 ...

Page 6: ...s being defined cshrc Script executed upon entry to a C shell BOLD CAPS and body text Indicates important items requiring special visual emphasis CAUTION Means remember Indicates something you should keep in mind while you follow a set of instructions IMPORTANT Means significant Indicates additional information you should know before proceeding through instructions NOTE Means hint Indicates helpfu...

Page 7: ...about other manuals published by Raining Data contact Order Administration at the following address Raining Data Corporation 17500 Cartwright Irvine CA 92614 Attention Order Administration Fax 949 474 6940 Phone 949 442 4400 E mail Orders rainingdata com If you have any requests comments corrections or questions regarding the content of mvEnterprise documentation contact the Technical Publications...

Page 8: ...ocesses excluding Phantoms that are licensed and allowed to run at one time mvEnterprise ODA requires a separate master control code and contains the maximum number of mvEnterprise ODA server processes that are licensed and allowed to run at one time The installation program prompts for the codes and create the necessary file on a new installation The configuration control file contains one or two...

Page 9: ...rocess can then be dropped from any port on any machine to create a free process There is no preset allocation of ports to logical machines and no limit to the number of logical machines involved The only restriction is the total number of active mvEnterprise processes mvEnterprise Release 4 1 on AIX Installation Guide Page 7 ...

Page 10: ...from the GLOBAL LOGON PROC in the LIBRARY account 5 If performing a complete database save and restore execute the base save and any account save threads 6 Perform a SHUTDOWN from mvEnterprise to shut down all processes SHUTDOWN is the recommended procedure for bringing mvEnterprise down Proceed to Installation Instructions 7 For a new installation it is necessary to acquire an mvEnterprise config...

Page 11: ... for mvEnterprise Configure the System to use Ethertape NOTE It may be necessary to reboot the system for certain system configuration changes to take effect 9 The following directories are created during the install process VERSION usr config usr stat mvEnterprise Release 4 1 on AIX Installation Guide Page 9 ...

Page 12: ...mple cd mkdir production 4 Change directories to the mvEnterprise directory cd production 5 Load the UNIX tar section by entering the command tar xvpf tape_device_name where tape_device_name represents the tape drive from which mvEnterprise is being loaded For example dev rmt0 1 Using this command installs the following programs consumer Transaction Logger consumer program install mvEnterprise ins...

Page 13: ...es roll_log_pseudo Sample roll log cron script eternal_sleep mve_tel support program vtape_compress Virtual tape support script vtape_decompress Virtual tape support script 6 Execute the install program by typing install o m i For more information regarding the mvEnterprise install program and options refer to mvEnterprise Install Program If this is an upgrade the install program displays the curr...

Page 14: ... section Configuring Disks for Use With mvEnterprise On AIX for more detail Enter the name to be used for the mvEnterprise monitor program Enter the name for the PICK monitor program i e prodpick The first four characters of the name to be used for the program must be unique from any other mvEnterprise virtual machine These characters form the semaphore set identification for the machine How many ...

Page 15: ...must be changed to include the correct tape devices to be used under mvEnterprise At a minimum device 0 needs to be specified to continue the installation The config tape file contains 32 lines of data representing device 0 to 31 respectively e g dev rmt0 1 NOTE These devices must be non rewind devices mvEnterprise Release 4 1 on AIX Installation Guide Page 13 ...

Page 16: ... with the mvEnterprise ODA monitor program cp p pickoda prodpick 10 If this is a new installation or you are doing a complete file restore proceed with Steps 11 15 to complete the installation procedure If this is an upgrade and you are not doing a complete file restore perform a COLDSTART by typing the command coldstart Then proceed with Steps 14 15 11 If this is a new installation leave the mvEn...

Page 17: ...uded in future mvEnterprise release is affected If you have altered the release files for any reason you must maintain a backup copy with your changes Refer to Upgrade File Listing for a complete listing of all files altered during the upgrade procedure During the upgrade the upgrade program prompts for the option to upgrade all account master dictionaries If you respond with Y all account master ...

Page 18: ...Release 4 1 on AIX Installation Guide Upon completion of the SYSTEM UPGRADE procedure remove the mvEnterprise Release 4 1 tape and store the tape in a safe location 15 The upgrade to mvEnterprise Release 4 1 is now complete ...

Page 19: ...T TERMIO STATUS DICT LINES UTILITIES INSTRUCT DICT UTILITIES NSYM OSYM ODA ADMIN DICT ODA BP REL BOOT SYMBOLS SYM SCRIBE SCB BP TOSYM DICT SCB BP WP MD LIBRARY DICT ACC BLOCK CONVERT SYSPROG BOOT ABS ERRMSG CNTL FILE DICT ERRMSG MENU SP HELP FILE NEWAC DICT HELP FILE NEWAC SYSPROG DICT JOB PSYM LST TERM DEFS DICT PARS RSLTS DICT TERM DEFS PARS TAG DEFS UTILITIES SP DICT QUEUE DICT UTILITIES SP DIC...

Page 20: ...names When done type end Enter the name to be used for the mvEnterprise monitor program How many phantom processes started at coldstart Do you wish to add default users to users script y n These prompts are described below How many mvEnterprise terminals The number of physical mvEnterprise lines this mvEnterprise virtual machine uses This parameter specifies the maximum number of terminals and may...

Page 21: ... of them are built using the newly designated machine names from the response to this prompt If this is a new installation the installation program displays two additional prompts How many phantom processes started at coldstart If Phantom processes are not to be used very often or are only being used for batch processing the user should answer 0 zero to this prompt If a number of Phantoms are to b...

Page 22: ...es via the scripts phantoms and users common1 Common area shared by mvEnterprise processes config File containing information regarding the mvEnterprise environment such as number of ports number of phantoms default number of virtual pages and location of mvEnterprise data space config tape File containing tape device node names config ethernet File containing pseudo Ethernet tape device node name...

Page 23: ...c mvEnterprise disk flushing program It is renamed during install to a unique name such as prodpicksync or devpicksync pickoda mvEnterprise ODA monitor or kernel pick lpd Program to allow the sharing of the UNIX spooler by multiple virtual machines scripts Directory created during the install procedure It contains scripts used by various mvEnterprise processes start_flusher Script created during t...

Page 24: ...defined in dev The install default is the system console dev console o Specifies removing and recreating common1 from information in the file config If config does not exist install prompts for terminals Phantoms memory pages and data names to use Never use the o option if there are active users on the mvEnterprise machine i Use this option when creating a DB file on AIX Initializes a new database...

Page 25: ...Sets the virtual tape device as defined in config tape dp0 dp1 and so on e Add file systems to mvEnterprise overflow without performing a save and restore Used instead of the x for the first coldstart after adding file systems f Set file load flag This causes a full file restore g Display system locks group locks and stop g r Display host ID system locks group locks record locks and stop gu r Disp...

Page 26: ...s LOGON banner ol Log line off when carrier drop detected ot For mvEnterprise processes connected via telnet The ot option causes a logged on mvEnterprise process to be left in a re startable state when its telnet connection is lost The process can only be restarted using the monitor option I For mvEnterprise processes which are logged off the loss of the telnet connection does not require the mon...

Page 27: ... even parity o 7 bit odd parity The default flow and parity control is ryn or x on x off flow control and 8 bit no parity s n Set the baud rate for the terminal Defaults to 9600 t Set the UNIX terminal device address This option has a parameter immediately following giving the UNIX path name of the terminal to use as the port For example t dev pts01 If not supplied the default is your local termin...

Page 28: ... permitted to increase their VFS by the difference between the config VFS size and the new current VFS size For example if the VFS size specified in config is 36 the following command alters the current VFS by 12 prodpick V48 Current VFS 48 Map 1 Sequence 1 Adjusted lines 0 Processes whose VFS is greater than or equal to 36 the VFS specified in config are permitted to increase their VFS by 12 the ...

Page 29: ...prise Release 4 1 on AIX Installation Guide Page 27 x Set the coldstart flag Implied by options a or f z Same as x In addition flags coldstart to return all acquired workspace overflow to the file space table ...

Page 30: ...number of sections and m equals the sleep time in seconds The defaults for the program are 60 sections and a one second sleep so the data space is synchronized to disk approximately once per minute NOTE The workspace below SYSBASE is not normally synchronized synced since it contains no useful data in the event of a system crash After completing a number of data space flush cycles loops the progra...

Page 31: ...presented by the numeric parameter This yields a x b where a represents the number of workspace sections and b represents the number of primary drives The default is 10 the range is 5 to 50 tn Sleep time in milliseconds between workspace slices For example parameter t100 would sleep 100 milliseconds between workspace sections The default is 0 10 sec the range is 0 10 to 1 second ln Number of loops...

Page 32: ...ontains 10000 10 then 100 000 frames of workspace overflow are allocated below SYSBASE and only need to be flushed once every loops l times through the database The flush program is executed from the start_flusher script This script is executed upon a coldstart filerestore or warmstart The flush program shuts down automatically after a SHUTDOWN or WARMSTOP By default the UNIX syncd daemon is repla...

Page 33: ...ded without performing a SAVE and RESTORE of the database the information reflected in the config file is Before After Physical ports 100 100 Phantoms 20 20 VFS buffers 128 128 Disk device 0 dev dskwwww 0 dev dskwwww Disk device 0 dev dskxxxx 0 dev dskxxxx Disk device 1 dev dskyyyy Disk device 1 dev dskzzzz Example 1 Extending Disk Space 2 Ensure that all users are logged off and that Phantoms and...

Page 34: ...coldstart which includes the flag set for disk extension in step 5 prodpick l0 e 8 Once the coldstart is complete start the user processes Type users NOTE Once this process is complete additional disk devices cannot be added at the new level The level number must be incremented if extending disk space a second time When performing the next SAVE and RESTORE of the database all level numbers should ...

Page 35: ...t III follows 1 Invoke smit the System Management Interactive Tool by typing smit from an AIX command shell Note that you must have root user privileges to execute this program For more information on smit AIX provides online documentation for its commands using the standard UNIX man facility The hypertext files used by man are normally located on a CD ROM supplied with the system Refer to the AIX...

Page 36: ...chment Type the printer is physically connected to this computer 5 Select the Printer Type i e manufacturer Hewlett Packard 6 Select the Printer Type model hplj 3 Page 34 mvEnterprise Release 4 1 on AIX Installation Guide ...

Page 37: ...l connection 8 For this system the Parent Adapter is sa0 NOTE This setting may vary based on your system s available hardware 9 Type the names of the new print spooler queues to be added mvEnterprise Release 4 1 on AIX Installation Guide Page 35 ...

Page 38: ...pt and HP GL 2 For more information or if your printer differs from the one described please see your printer s documentation 10 Complete the form by filling in the Printer Connection Characteristics the PORT number for this computer the first serial port or s1 the data transmission rate given in bits per second or BAUD 9600 the PARITY type none the number of BITS per character 8 the Number of STO...

Page 39: ... 12 Press the Cancel key to return to the Print Spooling menu 13 Select Change Show Printer Characteristics 14 Press the List key to display a listing of available printer queues and select the correct queue from the list 15 Select Default Print Job Attributes mvEnterprise Release 4 1 on AIX Installation Guide Page 37 ...

Page 40: ...where prodpick lpd The line printer driver program prodpick lj3pcl 99 The name used for the pipe it is a concatenation of the UNIX spooler queue name and the mvEnterprise port lj3pcl The name of the UNIX spooler queue to be used by this pipe 10 The number of seconds the pipe is allowed to be idle before it is closed r Use this option only if the spooler queue specified above is on a remote system ...

Page 41: ...r of VFS pages for use by the mvEnterprise spooler process Run process in the background The pipe name is written to tmp prodpick lj3pcl 99 as a lock to prevent two pipes with the same name This lock is released when the pipe is shut down If this procedure is being run from a script it is necessary to sleep for 5 seconds between commands to allow the pipe adequate time to start 21 From within mvEn...

Page 42: ...vEnterprise printer number 0 The form queue number associated with this printer 0 The number of pages to eject between print jobs S99 Signifies that the printer is attached serially and is running on port 99 Page 40 mvEnterprise Release 4 1 on AIX Installation Guide ...

Page 43: ...y grow should be set at unlimited Check or set the maximum file size for a user with the smit the System Management Interface Tool command Select Security Users Select Users Select Change Show Characteristics of a User Type the user name then locate the Soft FILE size field in the form which is displayed If the value is 1 negative one then the file size is unlimited Otherwise change the value to 1...

Page 44: ...ds Apply any changes Press the Enter key which executes the currently displayed command If you are familiar with either the emacs or vi editor you may wish to add one of the above commands to root s profile file so that the desired command line editor is activated every time you login as root 3 Activate the AIX man Pages AIX provides online documentation for its commands using the standard UNIX ma...

Page 45: ...pe smit The System Management menu displays NOTE The example screens shown here are intended to be representative of those you would see on your system However due to factors such as differing hardware your system s screen displays may vary from these examples If you can t type in the entry try pressing the appropriate function key 2 Select Devices The Devices screen displays mvEnterprise Release ...

Page 46: ... screen displays 4 Select Change Show Characteristics of a Tape Drive A window appears on the screen prompting the selection of the tape drives currently installed in the system Page 44 mvEnterprise Release 4 1 on AIX Installation Guide ...

Page 47: ...T units that cannot handle compressed data you need to turn data compression off 2 2 2 Special Considerations for Quarter Inch Cartridge Tape Units Tape density and block size are of particular importance when using quarter inch tape units Density setting 34 selects QIC 2 5GB mode of operation COMPRESSION NO further selecting COMPRESSION YES in this mode selects QIC 5 0GB mode 21 selects QIC1000 m...

Page 48: ...Page 46 mvEnterprise Release 4 1 on AIX Installation Guide two specified densities assuming this is valid for both the tape drive and tape cartridge specification used ...

Page 49: ...ape Drive Attributes 2 2 4 Update the config tape file A minimum device 0 needs to be specified to install mvEnterprise The config tape file contains 32 lines of data representing devices 0 to 31 respectively For example to make rmt1 the default tape drive or device 0 the first line in config tape should be dev rmt1 1 where the suffix 1 signifies that the tape device rmt1 is a non rewind device On...

Page 50: ... and the other disks while installed cannot be used To identify them issue an lspv command For example If you want more detail about disks use the lsdev command The above example demonstrates the addition of one volume group and one logical volume The disk named hdisk0 is already part of rootvg The disks hdisk1 and hdisk2 cannot be used until they are added to new volume groups To create a new vol...

Page 51: ...l in the form which is displayed VOLUME GROUP name Type mvevg00 where mvevg is mvEnterprise volume group and 00 represents the first volume group the second volume group is numbered 01 and so on 6 Arrow to the PHYSICAL VOLUME names field Press the List key The PHYSICAL VOLUME names window displays mvEnterprise Release 4 1 on AIX Installation Guide Page 49 ...

Page 52: ...irm the choice 8 Press Enter to add the volume group 9 Press Enter once more to confirm the addition of the volume group The Command Status window displays a message that the command was executed successfully Page 50 mvEnterprise Release 4 1 on AIX Installation Guide ...

Page 53: ...it from an AIX command shell The System Management menu displays 2 Select System Storage Management Physical Logical Storage The System Storage Management menu displays 3 Select Logical Volume Manager The Logical Volume Manager menu displays 4 Select Logical Volumes The Logical Volume menu displays 5 Select Add a Logical Volume The Add a Logical Volume form displays At the VOLUME GROUP name field ...

Page 54: ...logical partition equals the size of the logical volume as seen in the following screen It also must be less than or equal to the maximum number of logical partitions see Step 11 8 Advance to the PHYSICAL VOLUME names field and press the List key 9 Indicate the name of the appropriate physical volume by pressing the Select key 10 Press the Enter key to confirm the selection 11 Advance to the Logic...

Page 55: ...firming that the command has been executed successfully Each partition occupies 4 MB of disk space unless AIX has been configured to use a non standard partition size The number of partitions multiplied by the partition size gives the total size of the logical volume The MAXIMUM NUMBER of LOGICAL PARTITIONS parameter dictates the maximum size to which this partition is allowed to grow NOTE The jou...

Page 56: ...e Systems The Add Change Show Delete File Systems menu displays 5 Select Journaled File Systems The Journaled File Systems menu displays 6 Select Add a Journaled File System on a Previously Defined Logical Volume The Add a Journaled File System on a Previously Defined Logical Volume menu displays 7 Select Add a Large File Enabled Journaled File System The Add a Large File Enabled Journaled File Sy...

Page 57: ...ains all the mount points for the mvEnterprise file systems and mvelv000 is the name given to the logical volume as exemplified in Step 5 11 Select Mount AUTOMATICALLY at system restart then type yes 12 Press the Enter key to create the file system The Command Status screen displays confirming the successful addition of the file system mvEnterprise Release 4 1 on AIX Installation Guide Page 55 ...

Page 58: ...ystem Storage Management Physical Logical Storage The System Storage Management menu displays 3 Select File Systems The File Systems menu displays 4 Select Mount a File System The Mount a File System form displays 5 Select FILE SYSTEM name then press the List key to display the existing file systems Select the appropriate name and press Enter 6 Select the DIRECTORY over which to mount field then p...

Page 59: ...se on the file systems which were set up above During the software installation the install procedure prompts Enter initial data base names When done type end In the above example type mvefs mvelv00 DB where DB is a user selected name It is recommended that the i option to initialize the database be used with the install program If multiple database files are to be created on the same file system ...

Page 60: ...y exist Do you wish to create this database y n Respond y How many frames in this data space 5000 minimum If you are unsure on how many frames can fit in the file system type 1 negative one This creates DB0 to fill the file system to a maximum size of approximately 128 GB The above prompts are repeated for each database file NOTE The maximum size of each DB is just under 128 GB ...

Page 61: ...2 Edit the system configuration file Type vi etc pse conf 3 Locate the appropriate headings remove the comment symbol from these lines if necessary and save the changes PSE communication protocols d xtiso unixdg dev xti unixdg unix domain datagrams d xtiso unixst dev xti unixst unix domain byte stream d xtiso udp dev xti udp UDP IP d xtiso tcp dev xti tcp TCP IP PSE modules m timod TLI module m ti...

Page 62: ...exist in the etc hosts file for Ethernet connections to be established In the example below pickA 192 0 0 1 refers to the local machine and pickB 192 0 0 2 is the name of a remote machine The etc hosts file on pickA 192 0 0 1 pickA pickhost 192 0 0 2 pickB The etc hosts file on pickB 192 0 0 2 pickB pickhost 192 0 0 1 pickA ...

Page 63: ...ns Notation 2 Create Database AIX 53 File System AIX 50 Logical Volume AIX 47 D Data Flushing Time 26 Database 53 Database Names Initial 16 Default Users 10 16 Virtual Memory Buffer 22 Virtual Pages 9 15 Directories Created 7 Disk Flushing 25 Documentation Alternate Reference 3 Ordering 3 E Ethertape 55 Extending Disk Space 28 F Flow Control 22 G Getting Started 38 I Installation Before you Instal...

Page 64: ... Management Interactive Tool 30 Special Considerations AIX 42 Stacked Data 20 start_flusher 27 Start_flusher 18 Support Scripts 15 17 syncd daemon 27 SYSBASE 25 System Environment 6 System Management Interactive Tool smit 30 T Tape Special Considerations 42 Tape Devices 40 AIX 43 tar 8 TCP 10 Telnet 21 U Upgrade File Listing 14 Upgrade program 12 V VFS 23 VFS Table 23 Virtual Memory Buffers 23 Mem...