Rocket UniVerse

Installation Guide
Version 11.2.3

April 2014
UNV-1123-INST-1
Notices

Edition
Publication date: April 2014
Book number: UNV-113-INST-1
Product version: Rocket UniVerse V11.2.3

Copyright
© Rocket Software, Inc. or its affiliates 1985-2014. All Rights Reserved.

Trademarks
Rocket is a registered trademark of Rocket Software, Inc. For a list of Rocket registered trademarks
go to: www.rocketsoftware.com/about/legal. All other products or services mentioned in this
document may be covered by the trademarks, service marks, or product names of their respective
owners.

Examples
This information might contain examples of data and reports. The examples include the names of
individuals, companies, brands, and products. All of these names are fictitious and any similarity to
the names and addresses used by an actual business enterprise is entirely coincidental.

License agreement
This software and the associated documentation are proprietary and confidential to Rocket
Software, Inc., are furnished under license, and may be used and copied only in accordance with
the terms of such license.

Note: This product may contain encryption technology. Many countries prohibit or restrict the
use, import, or export of encryption technologies, and current use, import, and export
regulations should be followed when exporting this product.

Contact information
Website: www.rocketsoftware.com
Rocket Software, Inc. Headquarters
77 4th Avenue, Suite 100
Waltham, MA 02451-1468
USA
Tel: +1 781 577 4321
Fax: +1 617 630 7100

2
Contacting Technical Support

If you have current support and maintenance agreements with Rocket Software, you can access
the Rocket Customer Portal to report and track a problem, to submit an enhancement request or
question, or to find answers in the Rocket Knowledgebase. The Rocket Customer Portal is the
primary method of obtaining support.

To log in to the Rocket Customer Portal, go to:

www.rocketsoftware.com/support

If you do not already have a Rocket Customer Portal account, you can request one by clicking
Need an account? on the Rocket Customer Portal login page.

Alternatively, you can contact Rocket Global Technical Support by email or by telephone:

Email: <product support email>

Telephone:

North America +1.781.577.4323

United Kingdom/France +44 (0) 800 773 771 or +44 (0) 20 8867 3691

Europe/Africa +44 (0) 20 8867 3692

Australia +1 800 707 703 or +61 (0) 29412 5450

New Zealand +0800 505 515

3
 Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta
Table of
Contents

Table of Contents

Chapter 1 Chapter 1: Introduction

Determining the installation type . . . . . . . . . . . . . 1-3
Preinstallation tasks on UniVerse for UNIX. . . . . . . . . . 1-4
Login ID . . . . . . . . . . . . . . . . . . . . 1-4
Installation type . . . . . . . . . . . . . . . . . 1-4
Operating system requirements. . . . . . . . . . . . . . 1-6
Product configuration . . . . . . . . . . . . . . . 1-6
Overview Of UniVerse installation on UNIX . . . . . . . . . 1-7
The uv.load script . . . . . . . . . . . . . . . . . 1-7
The uv_upgrade command . . . . . . . . . . . . . 1-10

Chapter 2 Chapter 2: Quick installation procedure

Preinstallation tasks . . . . . . . . . . . . . . . . 2-2
Step-by-step instructions . . . . . . . . . . . . . . 2-2

Chapter 3 Chapter 3: Installing UniVerse as root

Initial installation of UniVerse . . . . . . . . . . . . . . 3-3
Installing UniVerse . . . . . . . . . . . . . . . . 3-3
Upgrading an existing UniVerse system as root . . . . . . . . 3-9
Preinstallation tasks . . . . . . . . . . . . . . . . 3-9
Installing UniVerse . . . . . . . . . . . . . . . . 3-9
Examining the load and installation scripts. . . . . . . . . . 3-16
uv.load options . . . . . . . . . . . . . . . . . . 3-16
System Administration menus . . . . . . . . . . . . . . 3-17

Chapter 4 Chapter 4: Installing UniVerse as uvadm

Initial installation of UniVerse . . . . . . . . . . . . . . 4-3
Upgrading an existing UniVerse system as uvadm . . . . . . . 4-9
Preinstallation tasks . . . . . . . . . . . . . . . . 4-9
Examining the load and installation scripts. . . . . . . . . . 4-15

C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLTOC.fm
(bookTOC.template)
 C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLTOC.fm
(bookTOC.template)

Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta

uv.load options . . . . . . . . . . . . . . . . . 4-15

System Administration menus. . . . . . . . . . . . . . 4-16

Chapter 5 Chapter 5: Installing UniVerse on Windows platforms

Starting the UniVerse master setup . . . . . . . . . . . . 5-3
Installing UniVerse. . . . . . . . . . . . . . . . . . 5-4
Installing UniVerse for the first time . . . . . . . . . . 5-4
Upgrading to or reinstalling UniVerse release 11.2 . . . . . 5-5
Starting a UniVerse session over telnet . . . . . . . . . 5-6
Authorizing UniVerse. . . . . . . . . . . . . . . . . 5-7
Authorizing a new UniVerse license . . . . . . . . . . . . 5-8
Obtain authorization code . . . . . . . . . . . . . 5-9

Chapter 6 Chapter 6: UniVerse accounts

Creating a new UniVerse account . . . . . . . . . . . . . 6-3
Viewing or modifying account details . . . . . . . . . . . 6-7
Deleting an account . . . . . . . . . . . . . . . . . 6-8
Customizing UniVerse accounts . . . . . . . . . . . . . 6-10
UniVerse account control files . . . . . . . . . . . . 6-10
Essential UniVerse files. . . . . . . . . . . . . . . 6-13
Controlling access to UniVerse on UNIX systems. . . . . . 6-15
Controlling access to UniVerse on Windows platforms . . . . 6-16
Customizing a UniVerse account . . . . . . . . . . . 6-16

Chapter 7 Chapter 7: Installing NLS

5 UniVerse Installation Guide

 1Introduction
0

Chapter

Chapter 1: Introduction
1
Determining the installation type . . . . . . . . . . . . 1-3
Preinstallation tasks on UniVerse for UNIX . . . . . . . . . 1-4
Login ID . . . . . . . . . . . . . . . . . . . . . 1-4
Installation type . . . . . . . . . . . . . . . . . . 1-4
Operating system requirements . . . . . . . . . . . . . 1-6
Product configuration . . . . . . . . . . . . . . . . 1-6
Overview Of UniVerse installation on UNIX. . . . . . . . . 1-7
The uv.load script . . . . . . . . . . . . . . . . . . 1-7
The uv_upgrade command. . . . . . . . . . . . . . . 1-10

C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH01TOC.fm
March 21, 2014 9:47 am Introduction
C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Introduction
This manual describes how to install Rocket UniVerse 11.2. These instructions
consist of the following chapters:

 Chapter 1,“Chapter 1: Introduction,” describes preinstallation tasks,

provides an overview of the installation process, lists operating
system and disk space requirements for various platforms, and
describes the uv.load script.
 Chapter 2, “Chapter 2: Quick installation procedure,” provides step-
by-step instructions for a quick installation.
 Chapter 3, “Chapter 3: Installing UniVerse as root,” provides step-
by-step instructions for initially installing or upgrading UniVerse as
the root user.
 Chapter 4, “Chapter 4: Installing UniVerse as uvadm,” provides step-
by-step instructions for initially installing or upgrading UniVerse as
the uvadm user.
 Chapter 5, “Chapter 5: Installing UniVerse on Windows platforms,”
provides step-by step instructions for installing UniVerse on
Windows platforms.
 Chapter 6, “Chapter 6: UniVerse accounts,” discusses UniVerse
accounts, including creating a new account, creating and viewing
account details, deleting an account, customizing an account, and
essential UniVerse files.
 Chapter 7, “Chapter 7: Installing NLS,” describes the installation
procedure for UniAdmin, UniVerse ODBC Client, UniDK,
UniOLEDB, Dynamic Connect, and UniDebugger.

1-2
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH01.fm
3/21/14

Determining the installation type

The Quick Installation Procedure should only be used by users experienced
with the procedure for configuring UNIX and installing UniVerse.

The Complete Installation Procedure describes how to install UniVerse for

the first time, and how to complete an upgrade installation.

1-3 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Preinstallation tasks on UniVerse for UNIX

Before beginning a UniVerse installation, make sure you know the following
information:

 How to log on as root or uvadm

 The type of installation you are performing
 How to download the installation media
 The location of the UniVerse directories
 The type of shell with which you are working
 The operating system requirements for your platform
 If you are installing UniVerse on a Linux platform and are using
UniVerse 10.x or earlier, you must create a symbolic link for the
uncompress using the following command:
ln -s gunzip uncompress
 It is recommended that the umask value be set to a minimum value
of 0022. To check the current value, type 'umask' at your Unix/Linux
OS prompt.

Login ID
To install UniVerse, you must log on to your system as either root or uvadm.

If you log on as root, all UniVerse home account files and directories are
owned and administered by root.

If you log on as uvadm, or as a uvadm group user, all UniVerse home account
files and directories are owned and administered by uvadm. If you log on as
uvadm to install UniVerse, you must have write permissions on the root
directory (/) and the directories where you install the UniVerse home
directory and the UniVerse/UniData shared directory.

Installation type
The following types of installation procedures are available with UniVerse
11.2:

1-4
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH01.fm
3/21/14

 Initial Installation – You are installing UniVerse for the first time on
your system.
 Upgrade Installation – You are installing UniVerse 11.2 over an
earlier version of UniVerse. An upgrade installation preserves site-
specific files in the UV account, such as the &DEVICE& file, and
recatalogs only the cataloged routines delivered with UniVerse.
User-cataloged routines are left intact in the system catalog.

1-5 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Operating system requirements

U2 ports UniVerse for UNIX products to many operating systems, such as
AIX, HP, Solaris, LINUX, and Windows platforms.

For operating system information, please see the U2 Product Availability

Matrix at:

https://u2tc.rocketsoftware.com/matrix.asp

or contact [email protected].

UniVerse requires that certain kernel parameters have adequate settings in

order for UniVerse to accommodate the full number of licensed users. The
following table list some recommended kernel parameters

Kernel Parameter Recommended Minimum

SHMMAX 1073741824

SHMSEG 1024

SEMMSL 8

SEMMNI 256
Minimum Kernel Parameters

Note: If requirements for your operating system are not listed in the above table, the
default values after installation should be sufficient.

Product configuration
A UniVerse order confirmation is emailed to you when you order UniVerse.
This email lists customer information, hardware information, and the
products and number of users you are authorized to install. Verify that the
information on the email is correct. You will need this information when
authorizing UniVerse.

1-6
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH01.fm
3/21/14

Overview Of UniVerse installation on UNIX

UniVerse is installed on an existing UNIX system in directories you specify
during the installation process. These directories are:

 uv – The UniVerse home directory

 unishared – The UniVerse/UniData shared directory

The examples in this manual use the default directories of /usr/uv and
/usr/unishared. During the installation process, you can substitute the paths
you choose for these directories.

Warning: Do not use symbolic links when specifying your uvhome and unishared
directories. If you use symbolic links, the UniVerse license authorization routines
fail.

The uv.load script

Execute the UniVerse installation while you are logged on as root, uvadm, or
a uvadm group user. Use the cpio or tar command to load a short installation
script called uv.load, and then execute the uv.load script to load the files from
the installation media.

To ensure a valid installation, the uv.load script performs the following

actions:

 Stops any active UniVerse spooler

 Removes the shared memory segments used by UniVerse

The spooler must be stopped before you install UniVerse because the
restoration cannot overwrite an active file. uv.load then loads the files from
the installation media into the directories you specify. Depending on the type
of installation you are performing, the script then performs the following
actions:

 If you log on as root and are installing UniVerse for the first time,
uv.load automatically executes the uv.install script.
 If you log on as uvadm and are installing UniVerse for the first time,
you exit the uv.load script, then manually execute the uv.install script.

1-7 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

 If you log on as uvadm, or as a uvadm group user, and are upgrading

an existing UniVerse system, you must use uv_upgrade to run uv.load,
which then automatically executes the uv.install script.

UniVerse checks the files loaded from the installation media to make sure
they have a checksum that matches the checksum on the installation media.
If the checksums do not match, UniVerse indicates that the files were not
loaded correctly from the installation media, and instructs you to reload the
groups that were in error.

Note: If you have not been able to reload the groups that are in error, contact your
maintenance vendor for assistance.

The uv.load script performs the following actions:

 Creates the UniVerse directory structure and grants proper

permissions. The following table describes the default UniVerse
directory structure.

Path Description

/usr/uv The UniVerse home directory.

/usr/uv/bin Contains the executables that make up the

UniVerse product.

/usr/uv/sample Contains various prototype files.

/usr/uv/NEWACC Contains the templates for the supported flavors of

the VOC file.

/usr/uv/terminfo Contains the UniVerse terminal characteristics

database.

/usr/uv/catdir The system catalog.

/usr/unishared Contains subdirectories and files shared by

UniVerse and UniData systems.
UniVerse Directory Structure

In addition, the installation procedure loads several UniVerse type 1

files or multiple data files, which are implemented as UNIX
directories in the UniVerse home directory (for example, BP, BP.O,
APP.PROGS, and APP.PROGS.O.)

1-8
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH01.fm
3/21/14

 Initializes the shared memory tables used by UniVerse, and modifies

the UNIX initialization script to execute the uv.rc file, which
performs UniVerse initialization.
 Installs the UniVerse spooler and executes the spooler daemon. See
Administering UniVerse for a more information about the UniVerse
spooler.
 Compiles the UniVerse terminal definitions. You should always
install the new definitions unless you have modified the supplied
definitions and want to preserve your changes.
Installing the UniVerse terminal definitions updates only the
UniVerse-specific characteristics kept in /usr/uv/terminfo. If you want
to update the non-UniVerse-specific characteristics in
/usr/lib/terminfo, you must manually invoke the uvtic command with
the -a option.
Warning: If this is an initial installation, the UniVerse terminal definitions
are always installed. You should make sure the UNIX terminal definitions
exist. If the UNIX version does not exist, use the -a option with the uvtic
command to create it.
 Creates the SQL catalog if it does not already exist.
 Initializes the UniVerse catalog space (for initial installation only)
and catalogs a number of subroutines. For more information about
catalog space, see Administering UniVerse.
 Copies the sample shell initialization file, .profile, from the UniVerse
sample directory to the UniVerse home directory. The .profile file
contains paths for system commands, default protection for created
files, and characteristics of the login terminal.

You must activate the UniVerse license or upgrade by entering the

authorization code supplied by your vendor. To activate the license, you
must log on as root, uvadm, or a uvadm group user, enter the UV account, then
enter the authorization information in the License Activation screen.

After you authorize UniVerse, you can then add other accounts to be used in
a UniVerse or UNIX environment, or perform administration of peripherals,
such as spooler devices. To perform these tasks, use the UniAdmin or
XAdmin client application or the System Administration menus. For
detailed information, refer to Administering UniVerse.

1-9 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Note: When you log on to the UV account, you are in the System Administration
menu system. If you exit the menus, you can reenter them by using the LOGIN
command. To exit the System Administration menus, press ESC.

The uv_upgrade command

Execute the uv_upgrade command while you are logged in as uvadm, or as a
member of the uvadm group, to upgrade UniVerse installations. The uv_up-
grade command is used to ensure that uvadm users have the appropriate
administrative privileges necessary to upgrade existing UniVerse
installations.

The ./uv_upgrade ./uv.load command invokes the uv.load script, which loads
the files from the installation image. Users who are logged on as uvadm or as
a member of the uvadm group must use the uv_upgrade command to upgrade
existing UniVerse installations.

Note: If UniVerse 11.1, or later, is installed, root, uvadm, or uvadm group users can
run uv_upgrade. If UniVerse 10.3 or earlier is installed, only the root or uvadm user
can run uv_upgrade.

1-10
 1Quick Installation Procedure
0

Chapter

Chapter 2: Quick installation

procedure 2
Preinstallation tasks . . . . . . . . . . . . . . . . . 2-2
Step-by-step instructions . . . . . . . . . . . . . . . 2-2

C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH02TOC.fm
March 21, 2014 9:47 am Quick Installation Procedure
C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Quick installation procedure

The Quick Installation Procedure should be used only by users experienced
with the procedure for configuring UNIX and installing UniVerse.

Note: Before you begin the installation, make sure you rebuild your kernel with
adequate values for your environment. See Preinstallation tasks on UniVerse for UNIX
in Chapter 1, “Chapter 1: Introduction,” and Administering UniVerse for infor-
mation about kernel parameter settings.

Preinstallation tasks
Before you begin the installation process, prepare the UniVerse home
directory with adequate disk space.

The preferred home directory is /usr/uv. You cannot specify the home
directory for UniVerse with a symbolic link. If you do, the license
authorization routines fail.

If you are installing UniVerse on a Linux platform, you must create a

symbolic link for the uncompress using the following command:
ln -s gunzip uncompress
Note: Some of the files on the installation media are in a compressed
format and have a .Z suffix. If you are installing over an existing
release of UniVerse, more space (approximately 50%) than
mentioned above is required to install the files before uncompressing
them. If this causes disk space problems, remove the UniVerse files
in the UniVerse home directory that will be replaced by the new
release.

Step-by-step instructions
Complete the following steps to install UniVerse:

1. Log on as root, and change directories to any directory to which you

have write permissions, as shown in the following example:
# cd /tmp

2-2
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH02.fm
3/21/14

2. If this is an upgrade installation, make sure any optional products

(such as NLS) already installed on your system are deinstalled before
proceeding with the following steps.

3. Download the installation image.

You can install UniVerse on the following platforms:
 AIX IBM RISC System/6000
 HP-UX Itanium/Integrity Server
 Sun SOLARIS Ultra-Sparc
 Sun SOLORIS x86
 Redhat LINUX
 SuSE LINUX
4. Use the following uv.load command to install from the installation
image:
cpio -ivcBdum uv.load < /cdrom/STARTUP

2-3 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

5. Load UniVerse by executing the uv.load command, as shown in the

following example. Make sure no one is using UniVerse during the
installation procedure.
# ./uv.load

uv.load displays the current installation settings, as shown in the

following example:
UniVerse Installation Procedure
==============================
The current installation is being done as 'root'. All

uniVerse home account files and directories will be owned

and administered by 'root'. UniVerse may also be
installed, owned and administered by the non-root user
'uvadm'. Choose one of the following below:

1) Make 'root' the default owner and administrator of uniVerse.

The current installation continues uninterrupted.

2) Make 'uvadm' the default owner and administrator of uniVerse.

The current installation will be terminated, and the user
'uvadm' must be created. You must then login as 'uvadm'
and restart this installation.

3) Stop the installation.

Your choice (Default action is 1):

If the values are set correctly, press ENTER to start installing

UniVerse.
The uv.load command loads the UniVerse release files and runs
uv.install, which installs UniVerse. The installation procedure
requires input several times. Normally, you respond to the prompts
by pressing ENTER to select the default action.
6. If you are installing UniVerse over an earlier UniVerse release, you
may see the following message:
Unable to get disk shared memory segment: Invalid argument
If this happens, shut down and restart UniVerse, then proceed to the
next step.

2-4
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH02.fm
3/21/14

7. After all groups are installed, the Upgrade UniVerse License screen
appears. Proceed to the next step.
If you are installing UniVerse for the first time as uvadm, the
following message appears:
This initial installation of UniVerse must now be completed by logging in
as 'root' and executing the script '/usr/uv/uv.install'.

UniVerse will remain in an inoperable state until this script has been
executed.

Log on as root, change directories to the UniVerse home directory,

and execute the uv.install script:
# ./uv.install
After the uv.install script completes successfully, the Upgrade
UniVerse License screen appears.
8. Enter the license activation information as requested by the prompts.
You must enter the following information:
 Serial number
 Maximum number of local users
 Expiration date, or press ENTER for the default
 Package list
 Number of Device Licenses for which you are authorized
Press ENTER. The licensing process displays a configuration code.
9. Remember the Configuration Code the licensing process displays.
The configuration code is of the following format:
CCTM5-ZZ3UZ-QFZ7Z-ZZZW6-Z3ZZ4-XBKLC-UZTI9
The licensing process prompts for Local Authorization Code.
10. To obtain your authorization code, go to:
US: https://u2tc.rocketsoftware.com/authprod.asp
International: https://u2tcint.rocketsoftware.com/authprod.asp
Click Authorize Products. Follow the instructions on the website to
obtain your authorization code. The serial number on the website
should include a -UV extension.
11. Once you have your authorization code, go back to the Upgrade
UniVerse License window and enter the authorization code in the
Local Authorization Code field.

2-5 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

12. When the authorization completes successfully, the following

message appears:
UniVerse licensing is complete. Please shut down and
restart UniVerse. Use the UniVerse system administration
menu to create additional UniVerse accounts.
Complete the following steps to shut down and restart UniVerse:
 Change to the UniVerse home directory:
# cd /usr/uv
 Enter the following command to shut down UniVerse:
# bin/uv -admin -stop
 Enter the following command to restart UniVerse:
# bin/uv -admin -start
13. If you are using any UniVerse optional products, install them now
using the Install package menu in the UniVerse System
Administration menu system.
14. Use the menus to configure the spooler and to do any account
administration.

2-6
 2Installing UniVerse as root
0

Chapter

Chapter 3: Installing UniVerse as

root 3
Initial installation of UniVerse. . . . . . . . . . . . . . 3-3
Installing UniVerse . . . . . . . . . . . . . . . . . 3-3
Upgrading an existing UniVerse system as root. . . . . . . . 3-9
Preinstallation tasks . . . . . . . . . . . . . . . . . 3-9
Installing UniVerse . . . . . . . . . . . . . . . . . 3-9
Examining the load and installation scripts . . . . . . . . . 3-16
uv.load options . . . . . . . . . . . . . . . . . . . 3-16
System Administration menus . . . . . . . . . . . . . 3-17

C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH03TOC.fm
March 21, 2014 9:47 am Installing UniVerse as root
C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Installing UniVerse as root

You can execute the UniVerse installation by logging on as root, as uvadm, or
as a uvadm group user. This chapter describes the steps you must complete to
install UniVerse as root, either as an initial installation or an upgrade
installation.

3-2
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH03.fm
3/21/14

Initial installation of UniVerse

Complete the following steps to install UniVerse for the first time on your
system.

Note: Some of the files on the installation image are in a compressed format and have
a .Z suffix. If you are installing over an existing release of UniVerse, approximately
50% more space is required to install the files before uncompressing them. If this
causes disk space problems, remove UniVerse files in the UniVerse home directory
that will be replaced by the new release.

Installing UniVerse
1. Log on as root, and change directories to any directory to which you
have write permissions, as shown in the following example:
# cd /tmp
2. Make sure there are no users logged on to the system before you
begin the installation.
Download the installation image.
You can install UniVerse on the following platforms:
 AIX IBM RISC System/6000
 HP-UX Itanium/Integrity Server
 Sun SOLARIS Ultra-Sparc
 Sun SOLORIS x86
 Redhat LINUX
 SuSE LINUX
3. Use the following uv.load command to install from the installation
image:
cpio ivcBdum uv.load < /cdrom/STARTUP

3-3 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

4. Execute the uv.load script while the installation media is still in the
device, as shown in the following example:
# /uv.load
The following screen appears:
UniVerse Installation Procedure
==============================
The current installation is being done as 'root'. All
uniVerse home account files and directories will be owned
and administered by 'root'. UniVerse may also be
installed, owned and administered by the non-root user
'uvadm'. Choose one of the following below:

1) Make 'root' the default owner and administrator of uniVerse.

The current installation continues uninterrupted.

2) Make 'uvadm' the default owner and administrator of uniVerse.

The current installation will be terminated, and the user
'uvadm' must be created. You must then login as 'uvadm'
and restart this installation.

3) Stop the installation.

Your choice (Default action is 1):

5. Select 1 to install UniVerse and make root the owner and

administrator of UniVerse. The uv.load script displays the current
installation settings, as shown in the following example:
The current settings of the available options are:

UniVerse installer : uvadm

UniVerse administrator : uvadm uid=214 gid=200

1) UniVerse home directory: /usr/uv

(currently: Not Installed.)
2) UniVerse-UniData shared directory: /usr/unishared
(currently: Not Installed.)
3) Compile terminfo definitions: true
4) Install media path /cdrom
5) Long File Names OFF

Enter a field number to change, q to abort installation, or press <Return>

to begin installation of UniVerse:

3-4
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH03.fm
3/21/14

6. Enter the number of the value you want to change.

1 – The UniVerse home directory path.
2 – The shared directory path.
3 – Whether or not to compile terminfo definitions. You cannot
change this value.
4 – The installation media path. Beginning at UniVerse 11.2.3, this
defaults to the directory where the uv.load script is extracted, if it
contains the UniVerse media files. Otherwise, it defaults to /cdrom.
Prior to 11.2.3, the default location was /cdrom.
5 – The default file creation characteristics. You can toggle between
OFF, and ON NEWACC. The default is LONGNAMES OFF. The ON
NEWACC setting enables LONGNAMES in all data accounts after
the account has been updated to the current version. For detailed
information about LONGNAMES, see Administering UniVerse.
When the display values are correct, press ENTER to begin the
installation process. Press q to exit the installation process.
7. If an SQL catalog does not exist and the uvsql user name does not
exist in the /etc/passwd file, the following message will appear:
The user 'uvsql' does not exist. This user is the default owner of the SQL
catalog. Would you like to:

1). Continue with the installation, making 'root' the default owner of the
SQL catalog.

2). Suspend the installation so that you can create the 'uvsql' user.

3). Stop the installation.

Your choice (Default action is 1):

Select one of the following options:

1 – Make root the owner of the SQL catalog.
2 – Shell out of the installation process to create the uvsql user in the
/etc/passwd file. When you finish creating the user, you return to the
installation process.
3 – Exit the installation process.

3-5 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

8. After all groups are installed, the Upgrade UniVerse License screen
appears. Enter the license activation information as requested by the
prompts. The information you must enter is:
 Serial number – include the numeric portion only
 Maximum number of local users
 Expiration date, or press ENTER for the default
 Package list – use the following formats:
‘PACKAGE_NAME:USER_COUNT,PACKAGE_NAME:USER_
COUNT
Connection Pooling – CONNPL:###
UVNET – UVNET:9999 (always use 9999)
EDA – EDA:1 (To enable EDA)
AUDIT:1 (To enable AUDIT)
SUBKEY:1 (To enable SUBKEY)
 Number of device licenses for which you are authorized – set to
10 in Workgroup and Enterprise editions. Set to 0 on Server
edition, unless the add-on is used.
Press ENTER. The licensing process displays a configuration code.
9. Remember the Configuration Code the licensing process displays.
The configuration code is of the following format:
CCTM5-ZZ3UZ-QFZ7Z-ZZZW6-Z3ZZ4-XBKLC-UZTI9
The licensing process prompts for Local Authorization Code.
10. To obtain your authorization code, go to:
US: https://u2tc.rocketsoftware.com/authprod.asp
International: https://u2tcint.rocketsoftware.com/authprod.asp
Click Authorize Products. Follow the instructions on the website to
obtain your authorization code. The serial number on the website
should include a -UV extension.
11. Once you have your authorization code, go back to the Upgrade
UniVerse License window and enter the authorization code in the
Local Authorization Code field.

3-6
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH03.fm
3/21/14

12. When the authorization completes successfully, the following

message appears:
UniVerse licensing is complete. Please shut down and restart UniVerse.
Use the UniVerse system administration menu
to create additional UniVerse accounts.

Shut down and restart UniVerse:

 Change to the UniVerse home directory:
# cd /usr/uv
 Enter the following command to shut down UniVerse:
# bin/uv -admin -stop
 Enter the following command to restart UniVerse:
# bin/uv -admin -start
13. Log on to the UV account. The System Administration menu
appears. This menu system allows you to perform tasks such as
adding users or setting up your spooler. See Administering UniVerse
for complete instructions. To exit the menus, press ESC until you get
to the UniVerse prompt:
>
To reenter the System Administration menu system, use the
following command:
>LOGIN
14. To exit the UniVerse environment, enter Q at the UniVerse prompt. A
standard shell prompt appears, as shown in the following example.
>Q
#
Note: The UniVerse LOGTO command does not check the release level of
the VOC file when used to enter a UniVerse account. The check is done only
when directly invoking UniVerse in a user account. If your application uses
LOGTO, you must verify that all user accounts are updated to the current
release level before running the application.

3-7 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

15. When you install UniVerse on your system for the first time, you
must add the UniRPC daemon's port to the /etc/services file.
Add the following line to the /etc/services file:
uvrpc 31438/tcp # uvrpc port
Note: You can check to see if the entry already exists in the /etc/services file
by executing the following command:
'cat /etc/services |grep 31438'
Once the port information is added to the /etc/services file, you can
start the RPC Service from the UniVerse System Administration
Menu in the UniVerse account.
To do this, select Package > RPC Administration > Start the rpc
daemon. A dialog box opens and asks for file name information. You
can either add a new file name or accept the default. Add the correct
file name information and then click Enter. A window opens and
asks if you want to start the daemon. Click Yes.
The UniRPC daemon will now start automatically when
UniVerse restarts.

3-8
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH03.fm
3/21/14

Upgrading an existing UniVerse system as root

Complete the following steps to upgrade an existing UniVerse system from
the system console.

Preinstallation tasks
If you are currently running a release of UniVerse, you must complete the
following tasks before beginning the upgrade installation.

 Make sure no users are using UniVerse.

 Save any of the following files in the UV account directory that you
may have modified:
 .profile
 sample/uv.rc
 sample/.profile
 sample/terminfo.src
 Any changes to programs in BP or APP.PROGS
Note: An installation upgrade preserves the existing uvconfig file. On Windows
platforms, the original uvconfig file is copied to uvconfig.bak and a new uvconfig file
overwrites the existing one. UniVerse copies the existing VOC file to VOC.OLD.
 Uninstall any optional UniVerse products (for example, NLS) that
are installed on an earlier release of UniVerse.

Installing UniVerse
Make the entries shown in bold type, and press ENTER after each entry.

Note: Before you start the installation, make sure your kernel parameters are
adequate to meet your UniVerse environment requirements.
1. Log on as root, and change directories to any directory to which you
have write permissions, as shown in the following example:
# cd /tmp

3-9 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

2. Make sure there are no users logged on to the system before you
begin the installation.
Insert the release media into the appropriate device. If you are
unfamiliar with the loading procedure, refer to your hardware
instruction manual.
You can install UniVerse on the following platforms:
 AIX IBM RISC System/6000
 HP-UX Itanium/Integrity Server
 Sun SOLARIS Ultra-Sparc
 Sun SOLARIS x86
 Redhat LINUX
 SuSE LINUX
3. Use the following command to install from the installation image:
cpio -ivcBdum uv.load < /cdrom/STARTUP
4. Execute the uv.load script:
# /uv.load
A screen similar to the following appears:
UniVerse Upgrade Procedure
==============================
The current upgrade is being done as 'root'. The
existing installed uniVerse (at /usr/uv)
is being administered by the user 'root'.
Choose one of the following below:

1) Keep 'root' as the owner and administrator of uniVerse.

The current installation continues uninterrupted.

2) Make 'uvadm' the new owner and administrator of uniVerse.

The current installation continues uninterrupted.

3) Stop the installation.

Your choice (Default action is 1):

3-10
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH03.fm
3/21/14

5. Choose 1 to install UniVerse and keep the root user as the owner and
administrator of UniVerse. Proceed to step 6.
Choose 2 to install UniVerse and make the uvadm user the new
owner and administrator of UniVerse. If the uvadm user does not yet
exist, the following message appears:
The user 'uvadm' does not exist. Would you like to:

1). Suspend the installation so that you can create the 'uvadm' user.

2). Stop the installation.

Your choice (Default action is 1):

Choose 1 to shell out of the upgrade procedure and create a new user
uvadm in the /etc/passwd file. When you exit from doing this, you
return to the upgrade procedure.

3-11 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

6. uv.load displays the current installation settings:

The current settings of the available options are:

UniVerse installer : uvadm

UniVerse administrator : uvadm uid=214 gid=200

1) UniVerse home directory: /usr/uv

(currently: Not Installed.)
2) UniVerse-UniData shared directory: /usr/unishared
(currently: Not Installed.)
3) Compile terminfo definitions: true
4) Install Media Path /cdrom
5) Long File Names OFF

Enter a field number to change, q to abort installation, or press <Return>

to begin installation of UniVerse:

Enter the number of the value you want to change. If you choose 1,
you are prompted for the UniVerse home directory. If you choose 2,
you are prompted for the shared directory name. If you choose 4,
you are prompted for a new installation path. You cannot change 5.
If UniVerse is running at the start of the upgrade and LONGNAMES
was previously enabled, the value for prompt 5 shows the present
value. Otherwise, it is set to OFF.
Note: You can manually change the LONGNAMES setting later by
issuing the command LONGNAMES ON NEWACC in the UV account.
You can also enter q at this point to quit the installation procedure.
If the values displayed are acceptable, press ENTER to start
installing UniVerse.
If you choose 3, a list similar to the following is displayed:
Compiling the uniVerse terminfo definitions will overlay the descriptions
for terminals listed below:

4410 at386 pt200 viewpoint

AT386 att3b1 qt102 viewpoint60
M= att4410 regent20 vp
Mu av regent25 vp60
a210 dialup regent40 vp60:regent40
a210:adm5 dumb regent60 vt100
a210:hz1410 fenix s4 vt100-am
a210:hz1500 gt sun vwpt
a210:qt102 hft sun-cmd vwpt60
a210:regent25 hz1410 sun-w wy200
a210:tvi910 hz1500 tvi910 wy200-w
a210:tvi910+ ibm5151 tvi910+ wy50
a210:tvi920 icl6404 tvi920 wy50:hz1500

3-12
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH03.fm
3/21/14

a210:tvi925 network tvi925 wy50:tvi910

a210:vp pc7300 tvi955 wy50:tvi920
adm5 performer unixpc wy50:tvi925
at pt unknown wy50:vp

Enter YES to compile and install terminfo.src:

Enter Y to compile and install terminfo.src. Enter N to change option 3

from true to false.
7. If you do not already have an SQL catalog and there is no user name
uvsql in the /etc/passwd file, you see the following message:
The user 'uvsql' does not exist. This user is the default owner of the SQL
catalog. Would you like to:

1). Continue with the installation, making 'root' the default owner of the
SQL catalog.

2). Suspend the installation so that you can create the 'uvsql' user.

3). Stop the installation.

Your choice (Default action is 1):

Choose 1 to make root the owner of the SQL catalog. Choose 2 to

shell out of the installation procedure and create the uvsql user in the
/etc/passwd file. When you exit from doing this, you return to the
installation procedure.
8. You may see the following message:
Unable to get disk shared memory segment: Invalid argument
If this happens, shut down and restart UniVerse. Then proceed to
step 14.
9. A prompt opens and asks if you want to update the uvdr.config and
uvodbc.config files. If you use U2 Data Replication or BCI (Basic Call
Interface), select No; otherwise, answer Yes to overwrite these files.

3-13 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

10. After the installation process installs all groups, the Upgrade
UniVerse License screen appears. Enter the license activation
information as requested by the prompts. The information you must
enter is:
 Serial number - include the numeric portion only
 Maximum number of local users
 Expiration date, or press ENTER for the default
 Package list - use the following formats:
'PACKAGE_NAME:USER_COUNT,PACKAGE_NAME:USER_
COUNT'.
Connection Pooling - CONNPL:###
UVNET - UVNET:9999 (always user 9999)
EDA - EDA:1 (To enable EDA)
AUDIT:1 (To enable AUDIT)
SUBKEY:1 (To enable SUBKEY)
 Number of Device Licenses for which you are authorized - set to
10 on Workgroup and Enterprise editions. Set to 0 on Server
Edition, unless the add-on is used.
Press ENTER. The licensing process displays a configuration code.
11. Remember the Configuration Code the licensing process displays.
The configuration code is of the following format:
CCTM5-ZZ3UZ-QFZ7Z-ZZZW6-Z3ZZ4-XBKLC-UZTI9
The licensing process prompts for Local Authorization Code.
12. To obtain your authorization code, go to:
US: https://u2tc.rocketsoftware.com/authprod.asp
International: https://u2tcint.rocketsoftware.com/authprod.asp
Click Authorize Products. Follow the instructions on the website to
obtain your authorization code. The serial number on the website
should include a –UV extension.
13. Once you have your authorization code, go back to the Upgrade
UniVerse License window and enter the authorization code in the
Local Authorization Code field.

3-14
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH03.fm
3/21/14

14. When the authorization completes successfully, the following

message appears:
UniVerse licensing is complete. Please shut down and restart UniVerse.
Use the UniVerse system administration menu
to create additional UniVerse accounts.

Shut down and restart UniVerse using the following steps:

Change to the UniVerse home directory, as shown in the following
example:
# cd /usr/uv
Enter the following command to shut down UniVerse:
# bin/uv -admin -stop
Enter the following command to restart UniVerse:
# bin/uv -admin -start
15. Log on to the UV account. The UniVerse System Administration
menu appears. This menu system lets you perform tasks such as
adding users or setting up your spooler. See Administering UniVerse
for complete instructions. To exit the menus, press ESC until you get
to the UniVerse prompt:
>

To reenter the System Administration menu system, use the

command:

>LOGIN

16. To exit the UniVerse environment, enter Q at the UniVerse prompt. A

standard shell prompt appears, as shown in the following example.
>Q
#
17. Each user account VOC file must be updated to the current UniVerse
release level. Do this by invoking UniVerse in each user account.
When you do this, the following prompt appears:
Your VOC is out of date. Update to current release (Y/N)?
Entering Y at the prompt updates the VOC to the current release level.

Note: The UniVerse LOGTO command does not check the release level of
the VOC file when used to enter a UniVerse account. The check is done only
when directly invoking UniVerse in a user account. If your application uses
LOGTO, you must verify that all user accounts are updated to the current
release level before running the application.

3-15 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Examining the load and installation scripts

You can examine the UniVerse load or installation script using the vi editor.
These scripts are in the UniVerse home directory, by default /usr/uv, under the
names uv.load and uv.install. You must have root privileges to view these files.

uv.load options
You can use the options to the uv.load command to change the installation
process. The syntax of the uv.load command is:

uv.load {–buildno} {–defaults} {–longnames} {–nochecksum}

{–nocpio} {–version} {uvhome}
The following table describes each parameter of the syntax:

Option Description

–buildno Returns the build number of the uv.load script.

This option is available at UniVerse 11.2.3 or later.

–defaults Specifies that all defaults are to be used—no prompting by the

script. This allows for automatic installation.

–longnames Forces LONGNAMES to ON NEWACC.

–nochecksum Specifies to skip the checksum step. This should be done only
after consulting with U2 support. If files are really damaged, the
installed UniVerse will not execute correctly, with possible
damage to files.

–nocpio Specifies to skip the physical read of the installation media. This
option can be used to restart the installation after files have been
loaded.

–version Returns the version of the uv.load script. This option is available
at UniVerse 11.2.3 or later.

uvhome Specifies the UniVerse home directory if it is different

from either the installed UniVerse or /usr/uv.
uv.load Options

3-16
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH03.fm
3/21/14

System Administration menus

The System Administration menus and data entry screens look and work the
same way as Motif menus. For a complete description of these menus, see
Appendix A of Administering UniVerse.

3-17 UniVerse Installation Guide

 0

Chapter

Chapter 4: Installing UniVerse as

uvadm 4
Initial installation of UniVerse. . . . . . . . . . . . . . 4-3
Upgrading an existing UniVerse system as uvadm . . . . . . 4-9
Preinstallation tasks . . . . . . . . . . . . . . . . . 4-9
Examining the load and installation scripts . . . . . . . . . 4-15
uv.load options . . . . . . . . . . . . . . . . . . . 4-15
System Administration menus . . . . . . . . . . . . . 4-16

C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH04TOC.fm
March 21, 2014 9:47 am
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH04.fm
3/21/14

Installing UniVerse as uvadm

You can execute the UniVerse installation by logging in as root, uvadm or as a
uvadm group user. This chapter describes the steps you must complete to
install UniVerse as uvadm, either as an initial installation or an upgrade
installation.

4-2 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Initial installation of UniVerse

Complete the following steps to install UniVerse for the first time on your
system.

Note: Before you start the installation, make sure your kernel parameters are
adequate to meet your UniVerse environment requirements. Also make sure you have
write permissions on the root directory (/) and on the directories where you plan to
install the UniVerse home directory and the UniVerse/UniData shared directory.
1. Log in as uvadm, and change directories to any directory to which
you have write permissions, as shown in the following example:
$cd /tmp
2. Make sure there are no users logged in to the system before you
begin the installation.
Download the installation image.
You can install UniVerse on the following platforms:
 AIX IBM RISC System/6000
 HP-UX Itanium/Integrity Server
 Sun SOLARIS Ultra-Sparc
 Sun SOLARIS x86
 Redhat LINUX
 SuSE LINUX
3. Use the following uv.load command to install from the installation
image:
cpio -ivcBdum uv.load < /cdrom/STARTUP

4-3
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH04.fm
3/21/14

4. Execute the uv.load script while the installation media is still in the
device, as shown in the following example:
$ ./uv.load
The following screen appears:
UniVerse Installation Options
==============================
The current settings of the available options are:

UniVerse installer : uvadm

UniVerse administrator : uvadm uid=1000 gid=100

1) UniVerse home directory: /usr/uv

(currently: Not Installed.)
2) UniVerse-UniData shared directory: /usr/unishared
(currently: Not Installed.)
3) Compile terminfo definitions: true
4) Install Media Path /cdrom
5) Long File Names OFF

Enter a field number to change, q to abort installation, or press <Return>

to begin installation of UniVerse:

5. Enter the number of the value you want to change. If you choose 1,
you are prompted for the UniVerse home directory. If you choose 2,
you are prompted for the shared directory name. You cannot change
option 3. If you choose 4, you are prompted for a new installation
media path. If you choose 5, its value is toggled.
Option 5 sets the default file creation characteristics (see
LONGNAMES in Administering UniVerse). You can toggle between
OFF and ON NEWACC. The default is LONGNAMES OFF. The ON
NEWACC setting enables LONGNAMES in all data accounts after
the account has been updated to the current version. For detailed
information about LONGNAMES, see Administering UniVerse.
You can also enter q at this point to quit the installation procedure.
If the values displayed are acceptable, press ENTER to start installing
UniVerse.

4-4 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

6. If an SQL catalog does not exist and the uvsql user name does not
exist in the /etc/passwd file, the following message will appear:
The user 'uvsql' does not exist. This user is the default owner of the SQL
catalog. Would you like to:

1). Continue with the installation, making 'uvadm' the default owner of the
SQL catalog.

2). Suspend the installation so that you can create the 'uvsql' user.

3). Stop the installation.

Your choice (Default action is 1):

Choose 1 to make uvadm the owner of the SQL catalog. Choose 2 to

shell out of the installation procedure and create the uvsql user in the
/etc/passwd file. When you exit from doing this, you return to the
installation procedure.
7. After the installation process installs the selected groups, the
following message appears:
This initial installation of UniVerse must now be completed by logging in
as 'root' and executing the script '/usr/uv/uv.install'.

UniVerse will remain in an inoperable state until this script has been
executed.

Perform the following steps:

 Log in as root:
$ su
$ password:
 Change directory to the UniVerse home directory:
# cd /usr/uv
 Execute the uv.install script:
# ./uv.install

4-5
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH04.fm
3/21/14

8. After the uv.install completes successfully, the Upgrade UniVerse

License screen appears. Enter the license activation information as
requested by the prompts. The information you must enter is:
 Serial number - include the numeric portion only
 Maximum number of local users
 Expiration date, or press ENTER for the default
 Package list - use the following formats:
'PACKAGE_NAME:USER_COUNT,PACKAGE_NAME:USER_
COUNT'.
Connection Pooling - CONNPL:###
UVNET - UVNET:9999 (always user 9999)
EDA - EDA:1 (To Enable)
AUDIT:1 (To enable AUDIT)
SUBKEY:1 (To enable SUBKEY)
 Number of Device Licenses for which you are authorized - set to
10 on Workgroup and Enterprise editions. Set to 0 on Server
Edition, unless the add-on is used.
Press ENTER. The licensing process displays a configuration code.
9. Remember the Configuration Code the licensing process displays.
The configuration code is of the following format:
CCTM5-ZZ3UZ-QFZ7Z-ZZZW6-Z3ZZ4-XBKLC-UZTI9
The licensing process prompts for Local Authorization Code.
10. To obtain your authorization code, go to:
US: https://u2tc.rocketsoftware.com/authprod.asp
International: https://u2tcint.rocketsoftware.com/authprod.asp
Click Authorize Products. Follow the instructions on the website to
obtain your authorization code.
11. Once you have your authorization code, go back to the Upgrade
UniVerse License window and enter the authorization code in the
Local Authorization Code field.

4-6 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

12. When the authorization completes successfully, the following

message appears:
UniVerse licensing is complete. Please shutdown and
restart UniVerse. Use the UniVerse system administration
menu to create additional UniVerse accounts.
Shut down and restart UniVerse:
 Enter the following command to shut down UniVerse:
$ bin/uv -admin -stop
 Enter the following command to restart UniVerse:
$ bin/uv -admin -start
13. Log in to the UV account. The System Administration menu
appears. This menu system allows you to perform tasks such as
adding users or setting up your spooler. See Administering UniVerse
for complete instructions. To exit the menus, press ESC until you get
to the UniVerse prompt:
>
To reenter the System Administration menu system, use the
command:
>LOGIN
14. To exit the UniVerse environment, enter Q at the UniVerse prompt. A
standard shell prompt appears, as shown in the following example.
>Q
$

4-7
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH04.fm
3/21/14

15. When you install UniVerse on your system for the first time, you
must add the UniRPC daemon's port to the /etc/services file.
Add the following line to the /etc/services file:
uvrpc 31438/tcp # uvrpc port
Note: You can check to see if the the entry already exists in the /etc/services
file by executing the following command:
'cat /etc/services |grep 31438'
Once the port information is added to the /etc/services file, you can
start the RPC Service from the UniVerse System Administration
Menu in the UniVerse account.
To do this, select Package > RPC Administration > Start the rpc
daemon. A dialog box opens and asks for filename information. You
can either add a new filename or accept the default. Add the correct
filename information and then click Enter. A pop-up window opens
and asks if you want to start the daemon. Click Yes.
The UniRPC daemon will now start automatically when UniVerse
restarts.

4-8 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Upgrading an existing UniVerse system as uvadm

Complete the following steps to upgrade an existing UniVerse system from
the system console. Make the entries shown in bold type, and press ENTER
after each entry.

Preinstallation tasks
If you are currently running a release of UniVerse, you must complete the
following tasks before beginning the upgrade installation.

 Make sure no users are using UniVerse.

 Save any of the following files in the UV account directory that you
may have modified:
 .profile
 sample/uv.rc
 sample/.profile
 sample/terminfo.src
 Any changes to programs in BP or APP.PROGS
Note: An installation upgrade preserves the existing uvconfig file. On Windows
platforms, the original uvconfig file is copied to uvconfig.bak and a new uvconfig file
overwrites the existing one. UniVerse copies the existing VOC file to VOC.OLD.

Uninstall any optional UniVerse products (for example, NLS) that are
installed on an earlier release of UniVerse.

Note: Before you start the installation, make sure your kernel parameters are
adequate to meet your UniVerse environment requirements. Also make sure you have
write permissions on the root directory (/) and on the directories where you plan to
install the UniVerse home directory and the UniVerse/UniData shared directory.
1. If the existing UniVerse system is owned by uvadm, enter the
following command at the login prompt:
$ login: uvadm
uvadm’s password:

4-9
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH04.fm
3/21/14

2. Change directories to any directory to which you have write

permissions, as shown in the following example:
$ cd /tmp
3. Make sure there are no users logged on to the system before you
begin the installation.
Insert the release media into the appropriate device. If you are
unfamiliar with the loading procedure, refer to your hardware
instruction manual.
You can install UniVerse on the following platforms:
 AIX IBM RISC System/6000
 HP-UX Itanium/Integrity Server
 Sun SOLARIS Ultra-Sparc
 Sun SOLARIS x86
 Redhat LINUX
 SuSE LINUX
4. Use the following command to install from the installation image:
 cpio -ivcBdum uv.load uv_upgrade < /cdrom/
5. Execute the ./uv_upgrade command to invoke the uv.load script, with
the release media still in the device:
$ ./uv_upgrade or ./uv_upgrade ./uvload
6. A screen similar to the following appears:
UniVerse Upgrade Procedure
==============================
The current upgrade is being done as 'uvadm'. The
existing installed uniVerse (at /usr/uv)
is being administered by the user 'uvadm'.
Choose one of the following below:

1) Keep 'uvadm' as the owner and administrator of uniVerse.

The current installation continues uninterrupted.

2) Make 'root' the new owner and administrator of uniVerse.

The current installation continues uninterrupted.

3) Stop the installation.

Your choice (Default action is 1)::

Choose 1to install UniVerse and make uvadm the owner and
administrator of UniVerse.

4-10 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

7. uv.load displays the current installation settings:

The current settings of the available options are:

UniVerse installer : root

UniVerse administrator : uvadm uid=1000 gid=100

1) UniVerse home directory: /usr/uv

2) UniVerse-UniData shared directory: /usr/unishared
3) Compile terminfo definitions: true
4) Install Media Path /cdrom
5) Long File Names OFF

Enter a field number to change, q to abort installation, or press <Return>

to begin installation of UniVerse:

The UniVerse installer will appear either as root or uvadm,

depending on how you logged in at step 1.
Enter the number of the value you want to change. If you choose 1,
you are prompted for the UniVerse home directory. If you choose 2,
you are prompted for the shared directory name. If you choose 4,
you are prompted for a new installation media path. You cannot
change 5. If UniVerse is running at the start of the upgrade and
LONGNAMES was previously enabled, then the value for prompt 5
shows the present value. Otherwise, it is set to OFF.
You can also enter q at this point to quit the installation procedure.
If the values displayed are acceptable, press ENTER to start
installing UniVerse.
If you choose 3, a list similar to the following is displayed:
Compiling the uniVerse terminfo definitions will overlay the descriptions
for terminals listed below:

4410 at386 pt200 viewpoint

AT386 att3b1 qt102 viewpoint60
M= att4410 regent20 vp
Mu av regent25 vp60
a210 dialup regent40 vp60:regent40
a210:adm5 dumb regent60 vt100
a210:hz1410 fenix s4 vt100-am
a210:hz1500 gt sun vwpt
a210:qt102 hft sun-cmd vwpt60
a210:regent25 hz1410 sun-w wy200
a210:tvi910 hz1500 tvi910 wy200-w
a210:tvi910+ ibm5151 tvi910+ wy50
a210:tvi920 icl6404 tvi920 wy50:hz1500

4-11
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH04.fm
3/21/14

a210:tvi925 network tvi925 wy50:tvi910

a210:vp pc7300 tvi955 wy50:tvi920
adm5 performer unixpc wy50:tvi925
at pt unknown wy50:vp

Enter YES to compile and install terminfo.src:

Enter Y to compile and install terminfo.src. Enter N to change option 3

from true to false.
8. If you do not already have an SQL catalog and there is no user name
uvsql in the /etc/passwd file, you see the following message:
The user 'uvsql' does not exist. This user is the default owner of the SQL
catalog. Would you like to:

1). Continue with the installation, making 'uvadm' the default owner of the
SQL catalog.

2). Suspend the installation so that you can create the 'uvsql' user.

3). Stop the installation.

Your choice (Default action is 1):

Choose 1 to make uvadm the owner of the SQL catalog. Choose 2 to

shell out of the installation procedure and create the uvsql user in the
/etc/passwd file. When you exit from doing this, you return to the
installation procedure.
9. You may see the following message:
Unable to get disk shared memory segment: Invalid argument
If this happens, shut down and restart UniVerse. Then proceed to
step 15.
10. A prompt opens and asks if you want to update the uvdr.config and
uvodbc.config files. If you use U2 Data Replication or BCI (Basic Call
Interface), select No. Otherwise, answer Yes to overwrite these files.

4-12 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

11. After the installation process installs all of the groups, the Upgrade
UniVerse License screen appears. Enter the license activation
information as requested by the prompts. The information you must
enter is:
 Serial number - include the numeric portion only
 Maximum number of local users
 Expiration date, or press ENTER for the default
 Package list - use the following formats:
'PACKAGE_NAME:USER_COUNT,PACKAGE_NAME:USER_
COUNT'.
Connection Pooling - CONNPL:###
UVNET - UVNET:9999 (always user 9999)
EDA - EDA:1 (To Enable)
AUDIT:1 (To enable AUDIT)
SUBKEY:1 (To enable SUBKEY)
 Number of Device Licenses for which you are authorized - set to
10 on Workgroup and Enterprise editions. Set to 0 on Server
Edition, unless the add-on is used.
Press ENTER. The licensing process displays a configuration code.
12. Remember the Configuration Code the licensing process displays.
The configuration code is of the following format:
CCTM5-ZZ3UZ-QFZ7Z-ZZZW6-Z3ZZ4-XBKLC-UZTI9
The licensing process prompts for Local Authorization Code.
13. To obtain your authorization code, go to:
US: https://u2tc.rocketsoftware.com/authprod.asp
International: https://u2tcint.rocketsoftware.com/authprod.asp
Click Authorize Products. Follow the instructions on the website to
obtain your authorization code. The serial number on the website
should include a –UV extension.
14. Once you have your authorization code, go back to the Upgrade
UniVerse License window and enter the authorization code in the
Local Authorization Code field.

4-13
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH04.fm
3/21/14

15. When the authorization completes successfully, the following

message appears:
UniVerse licensing is complete. Please shutdown and
restart UniVerse. Use the UniVerse system administration
menu to create additional UniVerse accounts.
Shut down and restart UniVerse using the following steps:
Change to the UniVerse home directory, as shown in the following
example:
$ cd /usr/uv
Enter the following command to shut down UniVerse:
$ bin/uv -admin -stop
Enter the following command to restart UniVerse:
$ bin/uv -admin -start
16. Log on to the UV account. The UniVerse System Administration
menu appears. This menu system lets you perform tasks such as
adding users or setting up your spooler. See Administering UniVerse
for complete instructions. To exit the menus, press ESC until you get
to the UniVerse prompt:
>
To reenter the System Administration menu system, use the
command:

>LOGIN
17. To exit the UniVerse environment, enter Q at the UniVerse prompt. A
standard shell prompt appears, as shown in the following example.
>Q
$
18. Each user account VOC file must be updated to the current UniVerse
release level. Do this by invoking UniVerse in each user account.
When you do this, the following prompt appears:
Your VOC is out of date. Update to current release (Y/N)?
Entering Y at the prompt updates the VOC to the current release
level.
Note: The UniVerse LOGTO command does not check the release level of
the VOC file when used to enter a UniVerse account. The check is done only
when directly invoking UniVerse in a user account. If your application uses
LOGTO, you must verify that all user accounts are updated to the current
release level before running the application.

4-14 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Examining the load and installation scripts

You can examine the UniVerse load or installation script using the vi editor.
These scripts are in the UniVerse home directory, by default /usr/uv, under the
names uv.load and uv.install. You must have root privileges to view these files.

uv.load options
You can use the options to the uv.load command to change the installation
process. The syntax of the uv.load command is:

uv.load {–defaults} {–longnames} {–nochecksum} {–nocpio}

{uvhome}
The following table describes each parameter of the syntax:

Option Description

–defaults Specifies that all defaults are to be used—no prompting by the

script. This allows for automatic installation.

–longnames Forces LONGNAMES to ON NEWACC.

–nochecksum Specifies to skip the checksum step. This should be done only
after consulting with U2 support. If files are really damaged, the
installed UniVerse will not execute correctly, with possible
damage to files.

–nocpio Specifies to skip the physical read of the installation media. This
option can be used to restart the installation after files have been
loaded.

uvhome Specifies the UniVerse home directory if it is different

from either the installed UniVerse or /usr/uv.
uv.load Options

4-15
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH04.fm
3/21/14

System Administration menus

The System Administration menus and data entry screens look and work the
same way as Motif menus. For a complete description of these menus, see
Appendix A of Administering UniVerse.

4-16 UniVerse Installation Guide

 1Installing UniVerse on Windows NT or Windows 2000
0

Chapter

Chapter 5: Installing UniVerse on

Windows platforms 5
Starting the UniVerse master setup . . . . . . . . . . . . 5-3
Installing UniVerse . . . . . . . . . . . . . . . . . 5-4
Installing UniVerse for the first time . . . . . . . . . . . 5-4
Upgrading to or reinstalling UniVerse release 11.2 . . . . . . . 5-5
Starting a UniVerse session over telnet . . . . . . . . . . . 5-6
Authorizing UniVerse . . . . . . . . . . . . . . . . 5-7
Authorizing a new UniVerse license . . . . . . . . . . . 5-8
Obtain authorization code . . . . . . . . . . . . . . . 5-9

C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH05TOC.fm
March 21, 2014 9:47 am Installing UniVerse on Windows NT or Windows 2000
C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Installing UniVerse on Windows platforms

The UniVerse Release 11.2 for Windows Platforms installation image contains a
program that manages the installation. You start this installation program,
then choose the software you want to install from the UniVerse Master Setup
screen.

5-2
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH05.fm
3/21/14

Starting the UniVerse master setup

All programs are installed from the UniVerse Master Setup screen. To reach
that screen, perform the following steps:

1. Log on as Administrator.
2. Load the installation image. The UniVerse Master Setup screen
should appear automatically.

5-3 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Installing UniVerse
This section describes how to install UniVerse Release 11.2 on an NTFS
partition on a server running Windows. The installation procedure varies
according to whether you are installing, reinstalling, or upgrading.

 If you are installing Release 11.2 for the first time, see “Installing
UniVerse for the first time.”
 If you are reinstalling Release 11.2 or upgrading from an earlier
release, skip to “Upgrading to or reinstalling UniVerse release 11.2.”

Installing UniVerse for the first time

Beginning at UniVerse 10.3, you do not need to authorize UniVerse during
the installation process. You have 10 days after installation to authorize
UniVerse.

Complete the following steps to install UniVerse 11.2:

1. From the UniVerse Master Setup screen, choose UniVerse RDBMS

to start the UniVerse installation. The Welcome screen appears.
2. Follow the instructions on the screen until the installation is
complete.
3. Start all UniVerse services as follows:
 Choose Start, then Programs, then Rocket U2, then UniVerse,
and then UniVerse Control to display the UniVerse Control
Panel.
 If UniVerse is not started, click Start All Services.
Note: The UniRPC service allows connections to servers from applications
written using UniDK, or from UniVerse Admin. The UniVerse Telnet
service allows users to make a telnet connection to UniVerse.

5-4
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH05.fm
3/21/14

4. Start a UniVerse session on the server. Execute one of the following

tasks:
 Choose Start, then programs, then Rocket U2, then UniVerse,
and then UniVerse Shell.
 Start a telnet session from a client (see “Starting a UniVerse
session over telnet” on page 6).
Note: If your application uses UniVerse menus or screen formatting, run
your application in a telnet window, because the UniVerse Shell window
does not support terminal handling.
5. Review your file security. The UniVerse installation directory
inherits its security permissions from the parent directory and from
the attributes of the installer. Adjust the permissions to meet your
needs. UniVerse administrators need full access to the UV account
directory. Other users require full access to the catdir directory and its
contents, and read-only access to all other files in the UV account
directory. All users must have full access to the UniVerse temporary
directory.
6. Use Notepad to edit the uvconfig file in the UV account directory to
specify a value for the UVTEMP configurable parameter. This value
defines the directory where UniVerse writes temporary files.
(Windows platforms do not have a fixed location for temporary
files.)
If you do not specify a value for UVTEMP, UniVerse first checks for
temporary files in the directory specified in the TEMP environment
variable, and then it searches the local directory.
7. Define the default UniVerse printer as follows. Choose Start, then
Settings, then Printers, and then Add Printer. Specify the printer
name as UVDEFAULT and define a suitable printer as the UniVerse
default. The printer must be available to all UniVerse users on the
system. It need not be a physical printer; it can be a file or a print
queue.

Upgrading to or reinstalling UniVerse release 11.2

Complete the following steps to upgrade or reinstall UniVerse Release 11.2.

1. Log on to Windows as Administrator.

5-5 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

2. Make sure that no users are connected to the UniVerse server. Use the
UniVerse command LISTU to list all users connected to the UniVerse
server.
3. Stop all UniVerse services. Choose Start, then Programs, then Rocket
U2, then UniVerse, and then UniVerse Control to display the
UniVerse Control Panel. Click Stop All Services.
4. Proceed with the installation as described in “Installing UniVerse for
the first time” on page 4.
Note: The installation process does not preserve any settings, including the
LONGNAMES setting. If you run UniVerse with LONGNAMES ON, the
new installation sets it back to the default LONGNAMES OFF.

Starting a UniVerse session over telnet

Complete the following steps to start a UniVerse session over telnet:

1. From the server, make sure the UniVerse Telnet services is running
on the server.
2. From the client, run the telnet application, for example, UV/Term.
3. From the client, enter the appropriate telnet command, such as open
or connect, and specify your UniVerse server’s network name as it
appears in the hosts or lmhosts file. The following example illustrates
connecting to the server univ.
open univ
4. Once connected, enter a valid user ID and password for your server.
5. If you are prompted, enter the location of the UniVerse account that
you want to access, as shown in the following example:
D:\U2\UV

5-6
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH05.fm
3/21/14

Authorizing UniVerse
Complete the following steps to authorize UniVerse through UniAdmin or
XAdmin:

Select one of the following methods to access the UniVerse License dialog
box:

 From the XAdmin window, double-click License.

 From the XAdmin menu, click Admin, then click License.

The UniVerse License dialog box appears, as shown in the following

example:

5-7 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Authorizing a new UniVerse license

Verify that the number of users and expiration date displayed in the
UniVerse Licensing dialog box matches the configuration on the Product
Configuration sheet shipped with UniVerse. Complete the following steps if
you need to update any information:

1. Enter your UniVerse serial number in the Serial # box.

2. Enter the number of users for which you are licensed in the UniVerse
User Limit box.
3. Enter the number of UVNet users for which you are licensed in the
UVNET User Limit box. If you are not licensed for any UVNet users,
enter 0.
4. Enter the number of Connection Pooling licenses in the Connection
Pooling box. If you are not licensed for any connection pools, enter 0.
5. Enter the number of device licenses for which you are authorized in
the Device License box.
6. Select the EDA check box if you are running External Database
Access.
7. Select the AUDIT check box if you are running Audit Logging.
8. Select the SUBKEY check box if you are using device subkeys with
device licensing.
9. If the expiration date of you license is incorrect, enter the correct date
in the Expiration Date box.

When the license information is correct, click Next.

Note: If you are using UV/NET, you must authorize both the UniVerse database and
UV/NET.

5-8
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH05.fm
3/21/14

A dialog box similar to the following example appears:

Obtain authorization code

Click Copy next to the configuration code, To obtain your authorization code,
go to:

United States: https://u2tc.rocketsoftware.com/authprod.asp

International:https://u2tcint.rocketsoftware.com/authprod.asp

Follow the instructions on the website to obtain your authorization code.

Once you have your authorization code, enter it in the Authorization Code
box, or click Paste if you want to copy it from the website and paste it in the
box.

If you want to authorize UniVerse at a later time select the Authorize later
check box.

If you want to write the authorization code to a file, select the Write config-
uration information to a file check box.

You must authorize UniVerse within 10 days of installation.

5-9 UniVerse Installation Guide

1UniVerse Accounts
0

Chapter

Chapter 6: UniVerse
accounts 6
Creating a new UniVerse account . . . . . . . . . . . . 6 -3
Viewing or modifying account details . . . . . . . . . . . 6 -7
Deleting an account . . . . . . . . . . . . . . . . . 6 -8
Customizing UniVerse accounts . . . . . . . . . . . . . 6 -10
UniVerse account control files . . . . . . . . . . . . 6 -10
Essential UniVerse files. . . . . . . . . . . . . . . 6 -13
Controlling access to UniVerse on UNIX systems. . . . . . 6 -15
Controlling access to UniVerse on Windows platforms . . . . 6 -16
Customizing a UniVerse account . . . . . . . . . . . 6 -16
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH06.fm
3/21/14

UniVerse accounts
You always enter UniVerse through a UniVerse account. A UniVerse account
includes a directory containing the files required to run UniVerse in that
directory. An established UniVerse account can also contain database files
and program files.

The VOC file in each UniVerse account defines the account environment,
including all the files and commands that are available to users who are
logged in to the account.

For example, a UniVerse account might be defined for a department rather

than for an individual. Each user of the SALES account might be given his or
her own login name at the operating system level, but be assigned the same
home directory and share the same UniVerse account.

On UNIX systems, you can assign or change the user ownership and group
ownership of files in an account, and you can set or change the file access
permissions. These ownerships and permissions apply to all of the files and
subdirectories contained in a UniVerse account directory.

UniVerse file permissions are managed by UNIX or Windows file

permissions. For information about setting file permissions, refer to the
documentation that comes with your operating system.

6-2 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Creating a new UniVerse account

Choose the Accounts option from U2 Extensible Administration Tool
(XAdmin) to create a new UniVerse account. The Account window appears
with a list of all UniVerse accounts currently defined in the UV.ACCOUNT
file (see “The UV.ACCOUNT file” on page 11 for information about this file).
The tasks you can perform from this window include:

 Creating a new account

 Viewing or modifying account details
 Deleting an account

How you create an account depends on whether you are administering a

UNIX server or a Windows server.

6-3
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH06.fm
3/21/14

Note: You can also create UniVerse accounts by entering uv at an operating system
prompt. If an account is created this way, the UV.ACCOUNT file is not updated and
the account cannot be administered using the Accounts option.

When you add a new account, UniVerse performs the following tasks:

 Assigns an account compatibility flavor

 Updates The UV.ACCOUNT File
 On UNIX systems, edits the .profile file in the account directory
 Edits the LOGIN entry in the UniVerse account

Complete the following steps to create a new UniVerse account:

6-4 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

1. From the Account Admin window, click New. The Add a New U2
Account dialog box appears, as shown in the following example:

2. Enter the name of the account in the Account Name field.

6-5
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH06.fm
3/21/14

3. Select one of the following flavors from the Account Flavor list:
 IDEAL. Choose this flavor if you are new to UniVerse. It contains
the best features of all the flavors.
 INFORMATION. Choose this flavor for compatibility with
Prime INFORMATION.
 PIOPEN. Choose this flavor for compatibility with PI/open.
 PICK. Choose this flavor for compatibility with Pick or
Advanced Pick.
 REALITY. Choose this flavor for compatibility with Microdata
REALITY.
 IN2. Choose this flavor for compatibility with IN2.
4. Enter a destination for the new account in the Account Path field.
You can enter the full path of the directory, or use the Browse button
to search the system for an appropriate directory. If you enter the
name of a directory that does not exist, it is created when you click
OK. For example:
/usr/users/newuser
The parent directory (/usr/users) must exist.
Note: You can choose a directory path of an existing UniVerse account. In
this case, the new account is added to the UV.ACCOUNT file, but no
changes are made to the existing account files.
5. Click OK. UniVerse creates the account in the chosen directory, and
updates the UV.ACCOUNT file and the Account Admin window.
Note: You can choose a directory path of an existing UniVerse account. In
this case, UniVerse adds the new account to the UV.ACCOUNT file, but no
changes are made to the existing account files in the directory.

6-6 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Viewing or modifying account details

To view the details of an account, click the account you want to view or
update.The UniVerse Account Details dialog box appears, as shown in the
following example: You can modify the account settings, except for the

Account Flavor setting and account path. Changes are saved when you click
OK.

6-7
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH06.fm
3/21/14

Deleting an account
Choose the Accounts option from XAdmin to delete a UniVerse account.

To delete a UniVerse account:

1. Select the account you want to delete from the UniVerse Accounts list
in the Account window.
2. Click Delete. The Delete Account dialog box appears with the name
and location of the chosen account, as shown in the following
example:

6-8 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

3. Choose how to delete the account by selecting one of the following

options:
 Retain Directory. UniVerse removes the account from the
UV.ACCOUNT file.
 Delete Directory. UniVerse removes the account from the
UV.ACCOUNT file and deletes the directory, along with all of its
contents. If other accounts in the UV.ACCOUNT file use the files
in this directory, you will also be prompted whether you want to
delete these accounts.
Note: Options available in the dialog box change dynamically according to
your choice to retain or delete a directory.
4. Click OK. A message box appears.
5. Click Yes to remove the account as specified. The Accounts window
is updated.

6-9
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH06.fm
3/21/14

Customizing UniVerse accounts

You can customize UniVerse accounts. For example, you can prevent certain
users from creating or modifying accounts from their own UniVerse
accounts.

You can also set up alternative account flavors and their associated VOC files.
To customize your system in this way, you must modify the NEWACC Files
and The UV.FLAVOR file.

Using XAdmin, you can specify the account flavor to use, which in turn
affects the VOC file and the user’s access to UniVerse. There are six standard
flavors: IDEAL, INFORMATION, PICK, REALITY, PIOPEN, and IN2. These
are listed when you create accounts using the Accounts option from
XAdmin.

On Windows platforms, you can specify the account directory or UniVerse

account to which each user initially logs in from a telnet session. Use the
Network Services option from UniAdmin or XAdmin to do this. For more
information about the Network Services option, see Maintaining the hosts
File in Administering UniVerse.

UniVerse account control files

XAdmin uses the account control files to check the validity of responses to
some of the data entry screens. UniVerse only updates these files when you
create or modify an account using XAdmin, so it is important to create
accounts using XAdmin.

Although the account control files are used primarily by XAdmin, you can
use LIST and SORT to create reports. You can update them with ReVise or the
UniVerse Editor.

6-10 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

The UV.ACCOUNT file

The UV.ACCOUNT file is in the UV account. It contains a list of UniVerse
accounts and their paths. UniVerse automatically updates this file when you
create or delete an account using XAdmin. Each UniVerse account has a
record in the UV.ACCOUNT file. The record ID is the account name. Each
record also contains the following fields, but only the PATH field is updated
by UniVerse.

Field Name Description

@ID Account name

PASSWORD Account’s password (/etc/passwd)

MAX

MIN

AGE

UID User ID number (/etc/passwd)

GID Group ID number (/etc/passwd)

NAME Account owner’s name (/etc/passwd)

OFFICE

EXT

PHONE

PATH Account directory’s path (/etc/passwd)

SHELL UNIX shell (/etc/passwd)

PERMISSIONS
UV.ACCOUNT Record Fields

6-11
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH06.fm
3/21/14

The UV.FLAVOR file

The UV.FLAVOR file is in the UV account. The UV.FLAVOR file dictionary
contains X-descriptors that define each flavor. The UV.FLAVOR data file
contains records that specify restrictions on creating or updating accounts.
This file lets you choose the account flavor for an individual or for a group of
users.

Each record in UV.FLAVOR can have one of the following types of

record IDs:

Record ID Description Example

USER.name name is the login name of a user. USER.alice

GROUP.name name is the name of a user group. GROUP.users

OTHER A specially defined account. OTHER

UV.FLAVOR Record IDs

Each record has two fields. The second field specifies one of the six different
flavors: IDEAL (UniVerse), INFORMATION, PICK, REALITY, PIOPEN, or
IN2. The first field specifies one of the following codes:

Code Description

C UniVerse prompts you to choose an account flavor when creating or

updating an account.

F UniVerse automatically assigns the account flavor designated in

field 2.

N The user cannot create or update an account.

UV.FLAVOR: Field One

The following example is of a sample UV.FLAVOR file:

Access
UV.FLAVOR........... Code.. Flavor.........

GROUP.users F PICK
OTHER C
GROUP.demo F NEWACC

To prevent users from creating or modifying an account, create an entry for

them in the UV.FLAVOR file and set the access code to N.

6-12 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

To use a custom flavor, create an entry in the UV.FLAVOR file for users who
will use the flavor, and set the access code to F. Enter the custom flavor name
in field 2 of the UV.FLAVOR file.

The UV.LOGINS file on Windows platform

The UV.LOGINS file is in the UV account only on Windows Platforms. It
contains a list of users and the UniVerse accounts they log on to when they
first connect to UniVerse through a telnet session. Use the Network Services
option of the UniVerse Admin Control Panel to maintain this file. For
information about the Network Services file, see Maintaining the hosts File in
Chapter 19 of Administering UniVerse.

Note: There is no UV.LOGINS file on UNIX systems.

Essential UniVerse files

For users to work in the UniVerse environment, their current working
directories must contain a number of UniVerse files, including the VOC file
and its associated file dictionary. In addition, each UniVerse account is set up
in a specified flavor of compatibility, such as IDEAL (UniVerse), PICK, or
INFORMATION.

The system administrator does not set up the VOC file and its associated file
dictionary. They are created when the user logs on to the new UniVerse
account for the first time.

If the directory has not been set up as a UniVerse account, the system notifies
the user that the account has not yet been set up. The user must answer the
system prompts to create or update the VOC file.

The VOC file

The VOC file is created according to the restrictions specified in the
UV.FLAVOR file. The master files used as templates for creating VOC files are
in the file NEWACC.

If your VOC is being updated rather than created, replaced records are
moved to the file &TEMP& to prevent them from being destroyed. The
names of any records that are moved to &TEMP& are listed on your screen.

6-13
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH06.fm
3/21/14

Note: The VOC file defines the UniVerse account. The contents of the VOC file
limits access to commands and files in a UniVerse account. Users cannot access any
files or commands not defined in the VOC file of the account in which they are
working.

The UV.LOGIN and LOGIN entries

If the UniVerse command processor is specified as the account’s command
interpreter, UniVerse executes the UV.LOGIN entry in the VOC file of the UV
account when the user logs on to the system. The UV.LOGIN entry can be a
paragraph, a proc, a UniVerse BASIC program, or a menu. It is typically a
paragraph containing commands that establish system-wide defaults. After
executing UV.LOGIN, UniVerse executes the LOGIN entry in the VOC file of
the user’s account.

The standard VOC file on UNIX systems contains a LOGIN entry that is
analogous to the UNIX .profile file. The default LOGIN entry in the sample
directory of the UV account is a paragraph similar to the following example:
LOGIN
001 PA
002 PTERM ERASE ON KILL ON WERASE ON RPRNT ON FLUSH ON LNEXT ON SUSP ON_
003 INTR ON QUIT ON STOP ON START ON EOF ON BRK OFF_
004 ECHO ON ECHO CTRL ON TABS ON CRMODE ON TYPE FAST LFDELAY 0 FFDELAY 2
005 UMASK 077

This LOGIN entry uses PTERM to set terminal characteristics, and it uses the
UniVerse UMASK command to set the default file permission mask. These
commands have the same function as the UNIX commands stty and umask.

Many of the functions performed by the LOGIN entry are identical to those
performed in the UNIX .profile file. For example, the stty command in .profile
determines which keys perform erase, kill, interrupt and quit operation on
your terminal:
stty erase '^H' kill '^U' intr '^?' quit '^_' -tabs ff0 cr0 nl0

On Windows platforms, the default LOGIN entry in the sample directory is a

paragraph similar to the following example:
LOGIN
001 PA
002 PTERM ERASE ON KILL ON WERASE ON RPRNT ON INTR ON_
003 ECHO ON ECHO CTRL
004 CLR

6-14 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

Controlling access to UniVerse on UNIX systems

You can make UniVerse your default working environment by entering
/usr/uv/bin/uv as your default shell in the /etc/passwd file. When you log in and
out, you log directly in to and out of UniVerse.

If, on the other hand, the /etc/passwd file specifies a UNIX shell (for example,
/bin/sh), you log in to a UNIX shell. You can then invoke the UniVerse
environment with the uv command. Even if the /etc/passwd file specifies a
UNIX shell, your .profile or .login file can log you directly in to the UniVerse
environment. To do that, add the following line to your .profile:
exec uv

The exec command replaces the current shell with the shell you specify, in this
case uv. On exiting UniVerse, you also exit the system.

Login Shell
Initialization
Specified in You log in… You log out…
Files
/etc/passwd

/usr/uv/bin/uv LOGIN Directly to To a UNIX login

UniVerse. shell.

/bin/sh .profile To a UNIX To a UNIX login

Bourne shell. shell.

/bin/sh .profile containing To UniVerse. The To a UNIX login

exec uv UNIX login is shell.
transparent to
the user.

/bin/csh .cshrc To a UNIX C To a UNIX login

.login shell. shell.

/bin/csh .cshrc To UniVerse. The To a UNIX C

.login containing UNIX login is shell.
uv command transparent to
the user.
Login Shell and Environment on Exiting UniVerse

Note: If you interrupt execution of the .profile or .login file (for example, by pressing
the Break key) before the uv command is executed, you are left in a UNIX shell.

6-15
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH06.fm
3/21/14

Controlling access to UniVerse on Windows platforms

The UV.LOGINS file is used on Windows platforms to define how users
connect to UniVerse via telnet sessions. Use the Network Services option of
XAdmin to specify how users should connect to UniVerse. For more
information about the Network Services option, see Maintaining the hosts
File in Chapter 19 of Administering UniVerse.

Customizing a UniVerse account

A valid UniVerse account always includes a VOC file and its associated file
dictionary. The VOC file defines all the commands and keywords that can be
used, and all the files that can be accessed from that account. UniVerse uses
master files in the UV account directory to create the VOC files in all new
accounts.

Choosing a UniVerse flavor

Any UniVerse account can be one of several standard flavors: IDEAL
(UniVerse), IN2, INFORMATION, PICK, PIOPEN, or REALITY.

 The PIOPEN flavor is used for compatibility with PI/open.

 The INFORMATION flavor is used to maintain an environment
compatible with Prime INFORMATION products.
 The IN2, PICK, and REALITY flavors are used for compatibility with
the different versions of the Pick system. These flavors can be chosen
by users who are more comfortable with a Pick system and want
UniVerse to behave in the same way.
 The IDEAL flavor contains the best of both the Pick and Prime
worlds.

New users are encouraged to choose the IDEAL UniVerse flavor.

6-16 UniVerse Installation Guide

C:\Users\awaite\Documents\U2Doc\
UniVerse\11.2\Source\install\NEWINS

NEWACC files
The NEWACC file in the UV account contains the different VOC file
templates for each flavor of UniVerse. UniVerse stores these templates as
multiple data files of the NEWACC file. Each data file is a fully configured
VOC template whose name corresponds to the flavor. To list the contents of
the data file containing the template for IDEAL flavor VOC files, enter either
of the following commands from the UV account:
>LIST NEWACC
>LIST NEWACC,NEWACC

To list the contents of the NEWACC template for INFORMATION flavor

VOC files, enter:
>LIST NEWACC,INFORMATION

The VOC file can reference a particular VOC template as a single data file by
using its full path in field 2 of the File Definition record. See the File
Definition record for NEWACC in the VOC file in any UniVerse account other
than the UV account. For example, this VOC entry points to the NEWACC
template for PICK flavor VOC files:
NEWACC
001 F File
002 /usr/uv/NEWACC/PICK
003 /usr/uv/D_NEWACC

Customizing NEWACC files

You can modify the standard NEWACC files to ensure that the VOC files of
new accounts contain only the records you want. For example, you can
remove records for commands that you do not want users to access, or you
can add records for files that are needed for an application.

You can also create up to 27 additional customized NEWACC files (see

UniVerse System Description for information about adding data files to a
UniVerse file). Each NEWACC file is a template for a new flavor of UniVerse.
For each new flavor, you must add an X-descriptor to the dictionary of the
UV.FLAVOR file. The record ID of the X-descriptor is the name of the new
NEWACC file, and field 2 contains the description of the new flavor. This
description appears in the list of UniVerse flavors when you create new
accounts. The following steps describe the easiest way to create a customized
flavor:

6-17
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH06.fm
3/21/14

1. Change to the UV account directory and invoke UniVerse:

# cd /usr/uv
# bin/uv
2. Make a copy of one of the standard NEWACC files. Do this by
creating a new data file in NEWACC and copying the contents of the
standard NEWACC file to the new data file:
>CREATE.FILE DATA NEWACC,MY.FLAVOR 3 23 4
Creating file "/usr/uv/NEWACC/MY.FLAVOR" as Type 3, Modulo
23, Separation 4.
>COPY FROM NEWACC,INFORMATION TO NEWACC,MY.FLAVOR ALL
355 records copied.
3. Use the UniVerse Editor or ReVise to add, delete, or change standard
VOC entries in your new flavor.
4. Use the UniVerse Editor to add an X-descriptor to the DICT of
UV.FLAVOR:
>ED DICT UV.FLAVOR
Record name = MY.FLAVOR
New record.

----: I
0001=X
0002=My own custom UniVerse flavor
0003=
Bottom at line 2
----: FI
"MY.FLAVOR" filed in File "DICT UV.FLAVOR"

6-18 UniVerse Installation Guide

 1Installing UniVerse Clients
0

Chapter

Chapter 7: Installing NLS

7

C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH07TOC.fm
March 21, 2014 9:47 am Installing UniVerse Clients
C:\Users\awaite\Documents\U2Doc\UniVerse\11.2\Source\install\NEWINSTALLCH07.fm
3/21/14

Installing NLS
Complete the following steps to install the NLS package.

1. As a UniVerse Administrator, log on to the UniVerse account

directory and invoke UniVerse.
2. From the UniVerse System Administration menu, select Package.
The Package menu appears.
3. From the Package menu, enter I to select the Install package menu.
4. The Install package menu appears. At the "Name of package to
install?" prompt, enter NLS.
5. At the "Device to load package " prompt, select CDROM, to see of
list of devices, enter "*".
6. At the Are you sure you want to install this package prompt, press
ENTER to accept the default Yes, or choose No if you do not want to
install the package.
7. At the Installation of package NLS Complete prompt, press ENTER
8. Press Esc to return to the UniVerse prompt.
9. Log out of UniVerse.
10. Go to the UniVerse home directory (`cat /.uvhome`) at the
UNIX/Linux level.
11. Without users logged in, run ‘bin/uvregen’
12. Shut down and restart UniVerse.

7-2 UniVerse Installation Guide