HP Raining DataCorp. mvEnterprise User Manual

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.

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 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.

Table of Contents

1. Installation Instructions ..................................................................................... 3

1.1 Installation Overview.................................................................................................................................3

1.2 Notation Conventions ................................................................................................................................4

1.3 Additional Documentation.........................................................................................................................5

1.4 mvEnterprise PICK License Management.................................................................................................6

1.5 Before You Install......................................................................................................................................8

1.6 Installation Instructions............................................................................................................................10

1.7 Upgrade File Listing ................................................................................................................................ 17

1.8 mvEnterprise Install Program ..................................................................................................................18

1.8.1 Support Scripts.................................................................................................................................20

1.9 Installation Options..................................................................................................................................22

1.10 mvEnterprise Monitor Program ...............................................................................................................23

1.11 mvEnterprise Disk Flushing Program......................................................................................................28

1.12 Extending Disk Space .............................................................................................................................. 31

1.13 mvEnterprise Line Printer Driver Program.............................................................................................. 33

2. Configure 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 to Store mvEnterprise Data ..................................................................... 51

2.3.2 Create a File System to Store mvEnterprise Data ............................................................................54

2.3.3 Create a Database to Store mvEnterprise Data ................................................................................57

2.4 Configure the System to use Ethertape ....................................................................................................59

2.4.1 Update the System to use Ethertape.................................................................................................59

2.4.2 Update the /etc/hosts File................................................................................................................. 60

mvEnterprise Release 4.1 on AIX Installation Guide Page i

Page ii mvEnterprise Release 4.1 on AIX Installation Guide

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 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

1.2 Notation Conventions

This document observes the following written conventions:

Notation Explanation

Alternate font Alternate font designates commands,

and serves to identify various forms
of syntax, or designates menus,
screens, fields and any associated
items.

Alternate font
bold

Italic font Designates book titles.

Italic Helvetica
bold

BOLD CAPS:

and body text

Designates input text. May be upper
or lower case, depending on typed
input requirements.

Designates terms being emphasized.

Indicates terms being defined.

Indicates important items requiring
special, visual emphasis.

Example

Attempting to initiate a 17th process
would display the message:

All licensed ports are in use

The UNIX file path is

/usr/config/config.pick

After selecting the tape device, type:

T-REW

Refer to the mvEnterprise User Reference

Manual.

If this is a new installation, proceed to

Step 7.

.

cshrc: Script executed upon entry to a

C shell.

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 helpful
information or a short cut that could
save time or trouble.

WARNING: Means halt. Indi-cates
important information to read before
proceeding.

Page 4 mvEnterprise Release 4.1 on AIX Installation Guide

CAUTION: Altering the default number of
the virtual memory buffers for a line
increases the true memory requirements of
the system.

IMPORTANT: A kill -5 HAS THE SAME
EFFECT ON mvEnterprise AS A kill -9.

NOTE: These devices must be non-rewind
devices.

WARNING: A kill -9 should not be used
to remove a mvEnterprise process unless
recommended by Raining Data Customer
Support.

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 05627-001).

To order any of the above titles, or to inquire 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: [phone]

Phone: [phone]

E-mail [e-mail]

If you have any requests, comments, corrections or questions regarding
the content of mvEnterprise documentation, contact the Technical
Publications Department at Raining Data through the above address or at

[e-mail].

mvEnterprise Release 4.1 on AIX Installation Guide Page 5

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 has on
mvEnterprise installations can be directed to Raining Data Customer
Support in Irvine at 949-261-1875 or call your local office.

In order to control the number of terminals running mvEnterprise, a
security system has been added. This ensures that a hardware machine is
properly configured and that the appropriate license is in place with
Raining Data.

Before installing mvEnterprise, it is necessary to acquire a master
mvEnterprise configuration control code from Raining Data Customer
Support. This record is unique to each machine and contains the
maximum number of mvEnterprise processes (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 lines composed of 13 characters that make up a control code. The
first line contains the mvEnterprise master control code. The second line
contains the (optional) mvEnterprise/ODA master control code, if
applicable. The UNIX file path is:

/usr/config/config.pick

After mvEnterprise is installed, the system is able to run the specified
number of real processes on any ports and on any logical mvEnterprise
machine.

For example, if a machine is licensed for 256 ports and has 240
processes running on a production machine, 16 ports would be left to run
on a development machine. Attempting to initiate a 17th process would
display the message:

Page 6 mvEnterprise Release 4.1 on AIX Installation Guide

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 logical machines
involved. The only restriction is the total number of active mvEnterprise
processes.

mvEnterprise Release 4.1 on AIX Installation Guide Page 7

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 Step 7.

If this is an upgrade to an existing installation, proceed to Step 2.

2. Ensure that all users are logged off and that phantoms and printers
are inactive.

3. If you are performing a complete database save and restore, examine
your file sizing and perform any necessary reallocations at this time.
Inappropriately allocated files reduce performance and reduce
database integrity under fault conditions.

4. Remove any EXEC command 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
configuration control code from Raining Data Customer Support at
the number listed above. This code is unique to your machine and
contains the maximum number of mvEnterprise processes
(excluding Phantoms) for which you are licensed and authorized to
run at one time. Without this code, the installation cannot be
completed.

8. Configure the System environment for mvEnterprise. Refer to
Section 2 “Configuring The System for mvEnterprise on AIX”. This
consists of a number of steps:

Page 8 mvEnterprise Release 4.1 on AIX Installation Guide

· 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 directories are created during the install process:

/VERSION

/usr/config

/usr/stat

mvEnterprise Release 4.1 on AIX Installation Guide Page 9

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 unlimited. Please refer
to Section 2.1

2. Insert the mvEnterprise Release 4.1 release tape in the appropriate
tape drive.

3. If this is a new installation, build the base mvEnterprise directory.
For example:

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 installation program.

logger Transaction Logger raw device

configuration.

perror Convert UNIX error numbers to text.

pick mvEnterprise monitor program.

picksync mvEnterprise disk flushing program.

pickoda mvEnterprise ODA monitor program.

Page 10 mvEnterprise Release 4.1 on AIX Installation Guide

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 sweeper program.

mve_tel mvEnterprise Telnet Server program.

mve_tel7024.
ports_sample.

mve_tel7024.
script_sample.

install.pdf Installation guide.

rlsnote.pdf Release notes.

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.

mvEnterprise Telnet Server sample ports
file.

mvEnterprise Telnet Server sample startup
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 current

mvEnterprise configuration and then prompts for the name to be
used for the mvEnterprise monitor program. An example of such
a name is prodpick.

Proceed to Step 8.

· If this is a new installation, the install program prompts for the

mvEnterprise configuration control code and parameters as
follows:

mvEnterprise Release 4.1 on AIX Installation Guide Page 11

Prompt Response

Enter the mvEnterprise main
configuration control code

Enter the mvEnterprise ODA
configuration control code

How many mvEnterprise terminals? Enter the number of Pick terminals required for

How many Phantom jobs? Enter the number of Phantom jobs required for

How many default virtual pages? Enter the number of default virtual pages. The

Enter list of initial Level 0 database
file full pathnames:
When done, type end.

Enter the mvEnterprise configuration control
code.

Enter the optional mvEnterprise/ODA
configuration control code.

your system.

your system. A general rule is one Phantom line
for every eight physical lines.

number of default pages has a direct effect on
performance. If this is not a new system, the
existing values in the config script, including the
number of virtual pages, should not be altered
without first consulting Raining Data Customer
Support. As a default, enter 128.

Enter each data base name. When all data base
names have been entered, type end. Each data
base name is entered and terminated with a
carriage return. Refer to the section “Configuring
Disks for Use With mvEnterprise On AIX” for
more detail.

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)?

How many Spooler contiguous
overflow frames [0—10000]?

How many Trans Logger
contiguous overflow frames [0—
10000]?

How many Workspace contiguous
overflow frames [0—10000]?

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.

Enter the number of Phantom processes to start
at coldstart.

Type no if there is no requirement for
asynchronous terminal support. Type yes to
build a generic boot script. The users script, built
by install, is a generic boot script for
mvEnterprise. If you request to add default users
to the users script, it must be customized after its
creation to the requirements of the installation.

Enter the number of Spooler contiguous overflow
frames.

Enter the number of Trans Logger contiguous
overflow frames.

Enter the number of Workspace contiguous
overflow frames.

How many Workspace overflow
group allocations [0—25]?

Page 12 mvEnterprise Release 4.1 on AIX Installation Guide

Enter the number of Workspace overflow group
allocations.

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. The config.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 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

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.

9. If you wish to use the pickoda monitor program, proceed with the
following steps:

a) Save a copy of the current mvEnterprise monitor program (i.e.,

prodpick) to a new name. Type:

mv prodpick prodpick.reg

b) Replace the existing mvEnterprise monitor program 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 mvEnterprise Release 4.1 tape
inserted.

If this is not a new installation, remove the mvEnterprise Release 4.1
release tape and insert the base file-save tape in drive 0.

12. Perform a file restore by typing the command:

./filerestore

The following prompts display:

Do you really wish to file restore prodpick (y/n)?

Type Y.

Load Data Tape and press "C"

Type C.

Page 14 mvEnterprise Release 4.1 on AIX Installation Guide

Enter number of phantoms for restore, <CR> 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 this is a new installation, the installation is complete.

14. If this is not a new installation, perform the incremental system
upgrade procedure that follows. This procedure updates the release
system accounts and files.

NOTE: Do not allow users on the system until the upgrade procedure is

complete.

CAUTION: Data located in SYSPROG, LIBRARY, ASM,

SCRIBE, ODA.ADMIN and any account included 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 dictionaries are updated using the MD-UPGRADE
utility. MD-UPGRADE upgrades existing commands in each master
dictionary and add additional, new commands based on the
SEQ.UPGRADE.NEWAC item in the LST file. If you respond with
N, you must manually upgrade all account master dictionaries.

· Insert the mvEnterprise Release 4.1. release tape in drive 0.

· Logon to the SYSPROG account.

· To attach to Drive 0, at TCL type:

T-ATT 0

· To initiate the upgrade program, at TCL type:

SYSTEM-UPGRADE

mvEnterprise Release 4.1 on AIX Installation Guide Page 15

· 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 16 mvEnterprise Release 4.1 on AIX Installation Guide

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 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

DICT RUM

DICT STAT-FILE SYSTEM LIBRARY (MD)

DICT SYSERR ASM (MD)

TERMINALS

mvEnterprise Release 4.1 on AIX Installation Guide Page 17

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
scripts found in the mvEnterprise UNIX directory such as absrestore and
coldstart.

The install program prompts for these mvEnterprise configuration
parameters:

How many

mvEnterprise terminals?

How many Phantom jobs?

How many default virtual pages?

Enter initial data base 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 be slightly larger than the current requirements.

How many Phantom jobs?

The number of Phantom lines this mvEnterprise virtual machine
uses. A general rule is one Phantom line for every eight physical
lines.

How many default virtual pages?

This prompt is for default virtual pages, and should be set to 128.
Each mvEnterprise process started uses this number as the maximum

Page 18 mvEnterprise Release 4.1 on AIX Installation Guide