Raining Data Corporation mvEnterprise 4.1.0 on AIX Installation Manual

Manual is about: Hewlett-Packard INSTALLATION GUIDE Printer Printer

Summary of mvEnterprise 4.1.0 on AIX

  • Page 1

    Raining data corporation installation guide april 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

    Mventerprise, mventerprise/oda are trademarks of raining data corporation. Multivalue is a trademark of spectrum international, inc. Powerpc, 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 trade...

  • Page 3: Table of Contents

    Table of contents 1. Installation instructions ..................................................................................... 3 1.1 installation overview.................................................................................................................................3 1.2 notat...

  • Page 4

    Page ii mventerprise release 4.1 on aix installation guide.

  • Page 5

    1. Installation instructions 1.1 installation overview this section provides step-by-step instructions for installing mventerprise release 4.1 on aix. Important: contact raining data customer support at 949-261- 1875 or your local office for any questions concerning user-written assembler modes. If ...

  • Page 6

    1.2 notation conventions this document observes the following written conventions: notation explanation example alternate font alternate font designates commands, and serves to identify various forms of syntax, or designates menus, screens, fields and any associated items. Attempting to initiate a 1...

  • Page 7

    1.3 additional documentation current information on mventerprise is available on the raining data web site at www.Rainingdata.Com. The following documentation supports mventerprise release 4.1: · mventerprise user reference manual (part number 84-00014a00). · assembly language manual (part number 05...

  • Page 8

    1.4 mventerprise pick license management the mventerprise implementation requires raining data licensing agreement with raining data. The total number of ports allowed on an mventerprise virtual machine is governed by this licensing agreement. Questions concerning the impact this licensing agreement...

  • Page 9

    All licensed ports are in use this message is also logged in the pick_log file which is located in the /usr/stat directory. A process 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 lo...

  • Page 10

    1.5 before you install 1. Read through all sections of this installation guide and the release notes carefully before proceeding. If you have any questions or problems, call raining data customer support in irvine at 949-261- 1875 or call your local office. If this is a new installation, proceed to ...

  • Page 11

    · getting started. This sets up process resource limits. · configure tape devices for mventerprise. · configure disks 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 di...

  • Page 12

    1.6 installation instructions 1. To log on, type: root this installation procedure must be performed while logged on as root. Once installed, mventerprise may be initiated from any unix login. Note: make sure root and all unix logins that have access to mventerprise have the soft file size set to un...

  • Page 13

    Pick.Lpd line printer driver program. Pick.Lpi line printer driver with job close abilities. Pickctrl install utility program. Preadchr mventerprise/unix transfer utility program. Pwritechr mventerprise/unix transfer utility program. Seqpick system errors transfer program. Sweeper transaction logger...

  • Page 14

    Page 12 mventerprise release 4.1 on aix installation guide prompt response enter the mventerprise main configuration control code enter the mventerprise configuration control code. Enter the mventerprise oda configuration control code enter the optional mventerprise/oda configuration control code. H...

  • Page 15

    Note: in an environment where all users are connected via tcp/ip, at the prompt: do you wish to add default users to the users script? Type n. 7. Theconfig.Tape file must be changed to include the correct tape devices to be used under mventerprise. At a minimum, device 0 needs to be specified to con...

  • Page 16

    Page 14 mventerprise release 4.1 on aix installation guide 8. Install the mventerprise release 4.1. Abs by typing the command: ./absrestore this restores the mventerprise 4.1 abs from the release tape. Successful completion of an absrestore displays the message: abs tape loaded with xxx frames used....

  • Page 17

    Mventerprise release 4.1 on aix installation guide page 15 enter number of phantoms for restore, for none press enter. When the file restore is complete, remove the base file-save or release tape. 13. Restore any accounts which reside on account-save tapes, then remove the account-save tapes. If thi...

  • Page 18

    Page 16 mventerprise 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

    Mventerprise release 4.1 on aix installation guide page 17 1.7 upgrade file listing the following is a listing of all files that are altered during an upgrade. Account file account file asm dict assembler library dict terminals cs-util termio.Status dict cs-util dict termio.Status dict lines utiliti...

  • Page 20

    Page 18 mventerprise release 4.1 on aix installation guide 1.8 mventerprise install program the installation program is located in tar format as the first file on a release tape. The purpose of install is to create the mventerprise environment shared by all mventerprise processes and build support s...

  • Page 21

    Mventerprise release 4.1 on aix installation guide page 19 number of memory pages it may map at any one time. The number may be overridden with the mventerprise monitor -v option. Enter initial data base names: when done, type 'end'. The location(s) of disk to be utilized by mventerprise. The databa...

  • Page 22

    Page 20 mventerprise release 4.1 on aix installation guide 1.8.1 support scripts the support scripts and files built by the mventerprise install program are listed below: . Cshrc script executed upon entry to a c shell. .Login script executed upon login to the directory. Abs binary file containing a...

  • Page 23

    Mventerprise release 4.1 on aix installation guide page 21 killpick script to kill mventerprise processes. This can be very dangerous. An mventerprise machine should only be stopped with the tcl command shutdown, and this script should only be used if you are directed to do so by raining data custom...

  • Page 24

    Page 22 mventerprise release 4.1 on aix installation guide 1.9 installation options options for install are listed below: -m{mail_addr} specifies an address to mail critical mventerprise error and warning messages, where mail_addr is defined in the form system-name\!Path-name. Using the -m option wi...

  • Page 25

    Mventerprise release 4.1 on aix installation guide page 23 1.10 mventerprise monitor program the following mventerprise monitor program options are available. These options are invoked by a dash, the lower case letter indicated, and in some cases, a parameter following the option. -a restore abs fro...

  • Page 26

    Page 24 mventerprise release 4.1 on aix installation guide mventerprise/basic data statement, this data is stored as though the user actually typed it in. It appears on the screen, one character at a time, until the input stack is exhausted. Note that the input buffer is limited to 300 bytes. In add...

  • Page 27

    Mventerprise release 4.1 on aix installation guide page 25 as an alternative, flow control can be obtained by entering a numeric option to reflect the desired flow control. This option is formed by adding together the appropriate numbers from the table below to provide a more flexible control of flo...

  • Page 28

    Page 26 mventerprise release 4.1 on aix installation guide -v{n} display or alter the default size of the virtual memory buffer table (vfs) allocated for each line. The optional parameter n is a number between 20 and 256. Used without the numeric parameter, the size of virtual memory buffer table is...

  • Page 29

    Mventerprise 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

    Page 28 mventerprise release 4.1 on aix installation guide 1.11 mventerprise disk flushing program this program is available on the aix systems, and would normally replace the native system syncd or fsflush daemons (background processes). The program is mventerprise machine specific and performs as ...

  • Page 31

    Mventerprise release 4.1 on aix installation guide page 29 the following parameters are available for the disk flushing program ( n refers to a numeric parameter in the range specified by the option description): -v verbose - issues constant status messages. -f specifies a path and file to log messa...

  • Page 32

    Page 30 mventerprise release 4.1 on aix installation guide spooler, transaction logger and workspace overflow blocks. Line three, which specifies the workspace block size, is now allowed an additional parameter. This parameter indicates the number of blocks to be allocated at file restore time. Thes...

  • Page 33

    Mventerprise release 4.1 on aix installation guide page 31 1.12 extending disk space the extend option is provided to avoid performing a save and restore of the database to extend disk space. Follow the steps below to extend the available disk space for the mventerprise database. 1. Create the new l...

  • Page 34

    Page 32 mventerprise release 4.1 on aix installation guide 6. Start the mventerprise phantom processes. Type: ./phantoms 7. Coldstart the mventerprise virtual machine. Type: ./prodpick -l0 where prodpick is the name of the monitor program. The instruction above begins the coldstart which includes th...

  • Page 35

    1.13 mventerprise line printer driver program the program pick.Lpd, which is located on the release tape with the mventerprise monitor and install programs, is useful for sites which operate multiple mventerprise machines. The driver allows a machine access to the unix spooler; therefore, two machin...

  • Page 36

    4. Select local attachment 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

    7. Select a printer interface of rs232 (serial 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

    · type the name into the field, using the cursor movement keys to move between fields. Do not press enter until you have completed all the requested data entry fields. For some fields, you may press function key four for a list of valid options from which you may choose. You may also press function ...

  • Page 39

    11. Press the enter key to execute the request. You should see a command status screen similar to the one depicted below. 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 qu...

  • Page 40

    16. Ensure that the lines per page and columns per page values are sufficient to accommodate the widest and deepest print jobs, which are sent to this printer. Use the arrow keys to move to these fields. 17. Press the enter key to execute the command. 18. Change to the directory into which mventerpr...

  • Page 41

    20. From an aix command shell, type this command: ./prodpick -l99 -oh -t/dev/prodpick.Lj3pcl.99 -v20 & where: prodpick mventerprise program. -l99 run printer on mventerprise port nintynine. -oh suppress logon banner at startup of printer process. -t/dev/prodpick.Lj3pcl.99 use this pipe for output. -...

  • Page 42

    Where: startptr the name of the command to start a printer 0 the mventerprise 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 rel...

  • Page 43

    2. Configure the system for mventerprise on aix 2.1 getting started 1. Ensure that user process resource limits are set correctly for all users who are accessing mventerprise (including root, if necessary). · the maximum size (in blocks) to which a file within aix may grow should be set at unlimited...

  • Page 44

    2. Turn on the aix command stacker. · to activate the emacs-style stacker, type: set -o emacs · use ctrl+pand ctrl+n keystrokes to scroll backwards and forwards through existing commands. · apply any changes. · press the enter key, which executes the currently displayed command. · to activate the vi...

  • Page 45

    2.2 configure tape devices for mventerprise on aix mventerprise relies on aix to provide driver support for tape devices. These should be configured using smit. An example to add a 4mm dat drive is given below. 1. At an aix command shell, type smit. The system management menu displays. Note: the exa...

  • Page 46

    3. Select tape drive . The tape drive 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

    5. Select these options as indicated the following screen: · block size (0=variable length). Type 0. · use device buffers during writes. Type yes. · use data compression . See the “special considerations for 4mm dat units” section following for information on selecting the compression option. 2.2.1 ...

  • 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

    Mventerprise release 4.1 on aix installation guide page 47 2.2.3 further configuration information for all tape devices further information on all operational tape drive parameters for all tape device types may be found in the manual supplied with your system titled ‘aix dpx/20 system management gui...

  • Page 50

    2.3 configure disks for mventerprise on aix aix requires that you add new disks to one of the existing volume groups, or create a new volume group and add the disks to that group before those disks can be used. It is recommended that you create a separate volume group for each disk in the mventerpri...

  • Page 51

    2. Select system storage management (physical & logical storage). 3. Select logical volume manager . 4. Select volume groups . 5. Select add a volume group , and then fill in the form, which is displayed. · volume group name. Type mvevg00 where mvevg is mventerprise volume group and 00 represents th...

  • Page 52

    7. Select a disk name, and press the select key. Press enter to confirm 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 mventerpr...

  • Page 53

    2.3.1 create a logical volume to store mventerprise data as a first time user, you also need to create logical volumes within each volume group to contain the aix file systems where you store your mventerprise data. The following screens demonstrate the creation of a logical volume named mvelv000 wi...

  • Page 54

    6. Type the logical volume name . (suggested; mvelv000, where mvelv is the mventerprise logical volume, 00 refers to the volume group, and 0 represents the first logical volume in that volume group.) the name, which was, entered displays. 7. Type the number of logical partitions . This number, multi...

  • Page 55

    12. Type the maximum number of logical partitions . The maximum number of logical partitions must be greater than or equal to the number of logical partitions entered in step 6. 14. Select stripe size? And ensure that it is set to not striped . To change this, press the list key and select not strip...

  • Page 56

    2.3.2 create a file system to store mventerprise data as a first time user, you also need to create a file system for the logical volumes to contain the aix files where you are storing your mventerprise data. 1. Type smit from an aix command shell. The system management menu displays. 2. Select syst...

  • Page 57

    10. At the mount point field, type the name of the directory on which the resulting file system is mounted. (suggested; /mvefs/mvelv000, where mvefs is the subdirectory off the root directory which contains all the mount points for the mventerprise file systems, and mvelv000 is the name given to the...

  • Page 58

    2.3.3 mounting the file system the newly created file system must be mounted before it can be used. The mounting process associates a file system with a directory, so that changing to the directory (via the aix cd command) allows access to the file system after it has been mounted. 1. Type smit from...

  • Page 59

    7. Select type of file system, then press the list key to display the existing file system types. Select the appropriate type and press enter. 8. Press the enter key to mount the file system. The command status screen displays, confirming the successful mounting of the file system. 2.3.4 create a da...

  • Page 60

    Page 58 mventerprise release 4.1 on aix installation guide after all database names have been entered, the install program displays the prompt: pick data space ‘db0’ does not currently exist. Do you wish to create this database (y/n)? Respond y how many frames in this data space[5000 minimum]? If yo...

  • Page 61

    Mventerprise release 4.1 on aix installation guide page 59 2.4 configure the system to use ethertape 2.4.1 update the system to use ethertape for new installations, a system configuration file must be changed in order to use ethertape. 1. Ensure that you are logged in as root. 2. Edit the system con...

  • Page 62

    Page 60 mventerprise release 4.1 on aix installation guide 2.4.2 update the /etc/hosts file an alias for the pick host must 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 o...

  • Page 63

    Mventerprise release 4.1 on aix installation guide page 61 index / /etc/hosts, 56 a abs, 11, 20 aix 4mm dat units, 42 commands lsdev, 44 lspv, 44 configure disks, 44 ethertape, 55 system, 38 tape devices, 40 create file system, 50 logical volume, 47 getting started, 38 update hosts file, 56 system t...

  • Page 64

    M man facility, unix, 30, 39 md-upgrade utility, 12 monitor program, 10 program, 20 n non-rewind device, 10, 43 notation conventions, 2 o oda configuration control code, 9 p phantom jobs, 9, 15 phantom processes, 10, 16 pick configuration control code, 9 pick terminals, 9, 15 pick_log, 5 pickhost, 5...