The Database Xcessory 5.0 CD-ROM may contain several ICS products. If you purchased an ICS product (that is, you are not evaluating an ICS product), consult the accompanying cover letter to confirm the products that you have actually purchased.
License and Decryption Keys for Purchased Products
If you purchased an ICS product
If you purchased an ICS product, you require the following keys:
- Decryption key--to extract the software from the CD-ROM. The key is included with the CD-ROM.
- Activation key--to access the full feature set of the product. This key is not included with the CD-ROM. To obtain this key, contact ICS with information on your host systems. (Refer to for more information.)
Contents of the Distribution
The Database Xcessory 5.0 CD -ROM contains the following:
Documentationfor purchased products
The documentation set you receive depends upon which product(s) you purchased. If you purchased Database Xcessory, you receive the following documentation:
- Database Xcessory 5.0 CD-ROM Mounting Instructions
- Database Xcessory 5.0 Installation Notes
- Database Xcessory 5.0 Release Notes
- Database Xcessory 5.0 User's Guide and Reference
- Builder Xcessory User's Guide
- Builder Xcessory Reference Manual
- Customizing Builder Xcessory
- EnhancementPak Programmer's Reference Manual
- GraphPak Programmer's Reference Manual
- ViewKit Programmer's Guide
Documentationfor evaluation products
If you are evaluating an ICS product, some documentation is available on the CD-ROM, but you might receive only a subset of the documents listed in the previous table. If you want copies of the ICS documentation, contact your sales representative.
Alternatively, a growing set of our documentation is available on our Web site at http://motif.ics.com/support/docs/documentation
Preparation for Installation
Notes on the Install Script
The install script, setup , is located in the top-level directory of the CD distribution. Use this script to install any or all of the software packages on the CD-ROM.
Notation
Throughout this manual, a monospaced typeface is used to indicate text displayed on your screen. A bold monospaced typeface is used to indicate text you should enter in response to a prompt.
Prompt Format
The questions in the setup script have the following format:
Question {option1 / option2 / ...} "default option"
Press Enter at the prompt to select the default option, otherwise enter the desired displayed option. At other times, the setup script prompts you with the following menu format:
At the prompt, type in the number corresponding to the desired option.
Errors
On any non-fatal error, the installer provides the option to abort the install:
Install Error -- Unit "Database Xcessory Bin (SunOS 5)".
Abort install? {yes/no} "no"
If you choose to abort, the installer provides the option of removing anything already installed:
Remove partial install ("Database Xcessory 5.0" 0% done) {yes/no} "yes"
Installing into an NFS-mounted File System
During the normal installation process, the install script sets the file ownerships and permissions on all of the files in the software distribution. If you are installing the software onto an NFS-mounted directory, changing file ownership and permissions may not be allowed. If any file permission problems occur during the installation, a warning message is displayed.
WARNING: Error(s) installing member files...
See the session transcript, /usr/tmp/icsAAAa01296, for details.
Install Error -- Unit "Database Example Code". Abort install? {yes/no} "no"
You can continue or abort the installation at this point. You may abort the installation, export the destination file system with "root" write permission for the machine on which you are running the install script, and restart the installation procedure.
Installation
The installation script for the ICS products is called, setup . To run the setup script, follow these steps:
- Login as root.
- Mount the CD according the Database Xcessory 5.0 CD-ROM Mounting Instructions, located in the Database Xcessory CD case, for your platform. If you are unsure how to do this, consult your system administrator.
- cd to the mount directory.
- Run ./setup.
- If the installer cannot find the mount point, you are prompted to specify it:
- You are given a list of packages and asked which you want to install. Enter the number corresponding to the desired package.
ICS Installer (v 3.0) -- Main Menu
- Enter "?" for help anywhere -
Choose from one of the following items:
(1) DX 5.0 - Database Xcessory 5.0 (DX)
(2) BX PRO 5.0.8 - Builder Xcessory 5.0.8, ViewKit 1.3.1, EPak 3.0.3
(3) ViewKit 1.3.1
(4) EnhancementPak 3.0.3
(5) FLEXlm 3.0 - Flexible License Manager Server
(6) *** Exit ***
Select a Product to Install...
The following section outlines a complete Database Xcessory installation. Installation of all other packages is similar. If you are installing Database Xcessory, you may also need to install the FLEXlm license manager.
Choose from one (and only one) of the following items.
(1) Sparc
(2) HPPA
(4) SGI
(7) Exit
Select destination Architecture..."Sparc" 1
For example, assume that you choose the default, (1) Sparc
Choose from one (and only one) of the following items.
(1) Solaris 2.5 (2.x compatible)
(2) Other Version
(3) Exit
Select destination platform: OS and version... "Solaris 2.5.1" 1
Destination Platform: Solaris 2.5.1 (Sparc)
- Enter the directory into which you would like the software installed. If the directory does not exist, the install script will prompt you and optionally create it for you.
[Database Xcessory 5.0]
Enter destination directory: "/usr/dx50" /tmp/dx15
Directory "/tmp/dx50" does not exist.
Create named directory? {yes/no} "yes" yes
- Enter your decryption key1. This key is required to copy the software from the CD-ROM and is included with your software. If you are installing the Evaluation versions of any of the software, a decryption key is not necessary (hit enter to skip this step).
Enter valid software decryption key: 1234abcd1234abcd1234abcd1234abcd
- You have the option to automatically create symbolic links from /usr/include , /usr/lib , and /usr/man to the installed software.
Link libraries, includes and man pages in /usr directories {yes/no} no
You may be asked to choose your compiler version and/or your Motif version.
- Confirm that the correct set of software packages are to be installed. The install script will display the install tree. "Leaves" of the tree will have sizes associated with them.
<<< Product Install Profile >>>
- DX 5.0 - [98.10 Mbytes]
- BX 5.0.8 Data Files - [8.57 Mbytes]
- BX 5.0.8 Binaries for Solaris 2.4+ - [20.84 Mbytes]
- BX 5.0.8 CDE Integration - [0.03 Mbytes]
- DX Common - [0.63 Mbytes]
- DX Binary Components
- DX Binaries (Solaris 2.5.1, all compilers) - [47.74 Mbytes]
- DX Libraries (Sparc Solaris 2.5.1)
- EPak 3.0.3 Libraries for Solaris 2.4+ - [2.83 Mbytes]
- DBPak (Solaris 2.5+, ANSI C++) - [12.55 Mbytes]
- Libraries for Sun ANSI C++ 5.0 - [3.69 Mbytes]
- ViewKit Include & Data Files
- ViewKit 1.3.2 Include & Data Files - [0.57 Mbytes]
- ViewKit Options
- EPak 3.0.3 Include & Data Files - [0.68 Mbytes]
Install unit as profiled? {yes/no} "yes" yes
If you respond "no", the script will return you to the main menu.
- If there is not enough disk space to install the software, the install script will prompt you to specify a new location.
>>> Product Install: Database Xcessory 5.0 [Solaris 2.5.1]
Disk Use: 9.10 Mbytes free, 98.10 Mbytes required
WARNING: Not enough disk space, "/tmp/dx50"
Enter destination dir (`@' aborts install): /usr/local/dx50
Directory "/usr/local/dx50" does not exist.
Create named directory? {yes/no} "yes" yes
The installer displays a moving astrisk while extracting the software from the CD-ROM. It periodically displays the percentage complete.
[DX Binaries (Solaris 2.5.1)] Extracting media...
[DX Binaries (Solaris 2.5.1)] Data 100% Installed (24.12 out of 24.12 Mbytes)
Install 30% Complete (24.12 out of 98.10 Mbytes Total)
-------------------------------------------------------
Creating the Database Xcessory shell script: dx50
-------------------------------------------------------
-------------------------------------------------------
Creating the Builder Xcessory shell script: bx50
-------------------------------------------------------
-------------------------------------------------------
Creating the Code Generator shell script: cgx50
-------------------------------------------------------
-------------------------------------------------------
Creating the Object Packager shell script: bxop50
-------------------------------------------------------
SUCCESS: Product Installed [Database Xcessory 5.0]
This concludes the installation of Database Xcessory 5.0. The extraction process is repeated for each of the components of Database Xcessory.
A complete list of the installed files is written to the file displayed here.
SUCCESS: Product Installed [Database Xcessory 5.0]
List of installed files: /tmp/dx50/dxp50.dat
ICS Installer (v 3.0) -- Main Menu
- Enter "?" for help anywhere -
Choose from one of the following items:
(1) DX 5.0 - Database Xcessory 5.0 (DX)
(2) BX PRO 5.0.7 - Builder Xcessory 5.0.7, ViewKit 1.3.1, EPak 3.0.3
(3) ViewKit 1.3.1
(4) EnhancementPak 3.0.3
(5) FLEXlm 3.0 - Flexible License Manager Server
(6) *** Exit ***
Select a Product to Install... 6
At this point, you can install another software package, or exit.
If you encounter any errors during the installation process, consult the log file. The location of this file is reported as errors occur, and again at the end of the installation process.
1. This decryption key is not the same as a DX license key. The decryption key is supplied with your software. A license key, only required for Database Xcessory, is obtained by emailing or calling ICS with information on your host system. In some cases, an evaluation copy might include a temporary key. See the section, and for more information.