Installation

Chapter 2 - Installation

2.1. Overview
2.2. Unix Installation
2.3. Windows Installation
2.4. Unix Compilation
2.5. Installation Programs

2.1. Overview

This chapter provides the information necessary to get started using UCM. Information about the installation and basic configuration is presented in a cookbook manner. For detailed configuration information, please refer to chapter 9, Configuration.

Note!

All Unitec products require the license manager ULM to run properly.
The setup(I) program for the Unix UCM software will install all components in the proper locations.

2.2. Unix Installation

As a first step, an empty directory has to be created on the hard disk of the target system to install all the UCM files. Throughout the following sections we use the directory /usr/ucm as the base for the installation. If you prefer to choose another directory, you should substitute the default name with the your selection.

login as root
mkdir /usr/ucm

Next, the data on the distribution media must be stored in the /usr/ucm directory on your hard disk. Normally Unix UCM is shipped on 3˝" MS-DOS DD or HD diskettes. Special formats are available upon request:

3˝" DD or HD diskette, Unix tar(1) format
5Ľ" MS-DOS format, 720KB or 1.2MB
5Ľ" 96 Tpi, 720KB or 1.2MB, Unix tar(1) format
QIC 24 tape cartridge, Unix tar(1) format

MS-DOS Format

MS-DOS diskettes contain one file ucm.tar or ucm.tzr. This file has to be transferred to the Unix file system. Several methods are possible. If you are using PC/TCP, Pathworks or PC-NFS the standard DOS copy command can be used to copy the software to any mounted Unix device. If you are using ftp, you must use binary transfer mode. Some Unix implementations provide a command to read DOS diskettes (e.g. SCO doscp -r).

Important!

Some copy utilities distinguish between text and binary files. The UCM files have to be transferred in binary mode in order to prevent any cr/lf conversions. As an example, the SCO doscp command must be used with the r-option and ftp must be set to binary mode.

Once you have copied the UCM software to your /usr/ucm directory, login as root and change to it (cd(1) command). If the suffix of the filename is .tzr, use the following shell commands:

mv ucm.tzr ucm.tar.Z
uncompress ucm.tar

To extract all files use:

tar xvf ucm.tar

If the tar(1) command reports a Directory checksum error, try:

dd if=ucm.tar conv=swab | tar xvf –

You are now ready to run the setup program:

./setup

Unix Format

If your distribution media is in Unix format, use the tar(1) command to extract the UCM files:

tar xvf /dev/x

where /dev/x is the device name of the drive required (e.g. /dev/tape, /dev/ct0, /dev/fd, /dev/fd0135ds18). If you are unsure about the device name, pleas consult your Unix manual. Some systems define a default device for the tar(1) command, so just tar xv may do the job.

If the tar(1) command reports a Directory checksum error, try:

dd if=/dev/x conv=swab | tar xvf –

If just one file named ucm.tar.Z is extracted use:

uncompress ucm.tar
tar xvf ucm.tar

and then

./setup

Setup

After calling the UCM setup(I) utility, just follow the on screen instructions. For a detailed description of this program, please refer to the program documentation later in this chapter.

Note!

Since this library product does not require special file distribution actions, it is shipped with the Unitec License Manager setup program. You will therefor be prompted for ULM (and not UCM) environment parameters.

The contents of the various directories after successful installation is listed below:

Name	Contents
/etc	Configuration file ulm.default, ulm(I) program.
/usr/lib/ulm	Default ULM base directory as defined by ulm_base_dir. Will hold the ULM database ulm.dat, a copy of setup(I) for potential uninstallation and internal information.
support	Subdirectory of ulm_base_dir: read.me and other support files.
cwd	UCM files, sample programs and functions.

After the download of the software, you may find additional information on UCM in a READ.ME file.

If you plan extended use of the UCM library, you may want to copy some general purpose files to standard Unix locations:

cp ucm.h /usr/include
cp libucm.a /usr/lib

This concludes the basic installation and configuration. Many parameters may be set to change the behavior of the UCM software. The description of the configuration files can be found in the remainder of this manual.

Note!

In order to run programs using UCM services, you will have to configure your TCP/IP network. Please consult the appropriate sections in Chapter 9, Configuration.

2.3. Windows Installation

Start MS-Windows and insert the UCM Setup diskette into drive A:
In the Program Manager choose File - Run
Enter a:\setup and hit <Return>

Configuration information can be found in Chapter 9, Configuration.

2.4. Unix Compilation

To compile the configurable library modules or the sample programs, a makefile is provided. The most parameters are set, to run correctly under generic Unix. In any case, the makefile needs some small modifications. The table below lists the configurable make(1) macros.

Macro	Description	Default Setting
cflags	Compiler flags. Please refer to the cc(1) manual page.	-O
ldflags	Loader flags. Please refer to the cc(1) and ld(1) manual pages.	-n
libtype	Library type: portar portable archive ranlib ranlib(1) type library	portar

After the makefile preparations, just run make(1).

cd /usr/ucm
make

2.5. Installation Programs

This section contains descriptions of the UCM installation programs in alphabetical order. The page headers for the descriptions contain the name and a brief description of the utility.

The Synopsis section contains the command line syntax, showing all possible options and arguments.

The Description section explains the purpose of the utility and any command line arguments.

The Options section explains each of the possible command line options.

Where applicable, program configuration details are listed in the Configuration section.

Program	Title
setup	Product Installation.
ulm	Unitec License Manager.

	Back to top