BX PRO 5.0
Installation Notes
Copyright © 1998 Integrated Computer Solutions, Inc.
The BX PRO 5.0 Installation NotesTM is copyrighted by Integrated Computer Solutions, Inc., with all rights reserved. No part of this book may be reproduced, transcribed, stored in a retrieval system, or transmitted in any form or by any means electronic, mechanical, photocopying, recording, or otherwise, without the prior written consent of Integrated Computer Solutions, Inc.
Integrated Computer Solutions, Inc.
201 Broadway, Cambridge, MA 02139
E-mail: info@ics.com
WWW: http://www.ics.com
Builder Xcessory, BX, BX/Ada, BX PRO, BX/Win Software Development Kit, BX/Win SDK, Database Xcessory, DX, DatabasePak, DBPak, EPak PRO, EnhancementPak, EPak, ViewKit, VKit, and ICS Motif are trademarks of Integrated Computer Solutions, Inc.
All other trademarks are properties of their respective owners.
Builder Xcessory, Database Xcessory, DBPak, EPak PRO, EnhancementPak, EditTable, ChartObject, View3D, ViewKit, BX/Win SDK and BX PRO LICENSE AGREEMENT
READ THIS AGREEMENT BEFORE USING THE SOFTWARE (THE "PROGRAM"), THE PROGRAM MEDIA (THE "MEDIA") OR THE ACCOMPANYING DOCUMENTATION (THE "DOCUMENTATION"). THIS AGREEMENT REPRESENTS THE ENTIRE AGREEMENT CONCERNING THE PROGRAM AND DOCUMENTATION BETWEEN YOU (THE "CUSTOMER") AND INTEGRATED COMPUTER SOLUTIONS, INC. ("ICS"). IT SUPERSEDES ANY PRIOR PROPOSAL, REPRESENTATION, OR UNDERSTANDING BETWEEN YOU AND ICS. BY BREAKING THE SEAL ON THE MEDIA, YOU AGREE TO THE TERMS OF THIS AGREEMENT. IF YOU ARE NOT WILLING TO BE BOUND BY THE TERMS OF THIS AGREEMENT, DO NOT USE OR INSTALL THE PROGRAM, AND PROMPTLY RETURN THE CONTENTS, WITH THE MEDIA SEAL UNBROKEN, FOR A REFUND. 1. License: All title and copyrights in and to the Program and the Documentation are owned by ICS or its suppliers. The Program is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. This Program is licensed, not sold. ICS grants to the Customer a nonexclusive, nontransferable (except as provided herein) license to use the Program and the Documentation. One BX PRO license provides the Customer one Builder Xcessory license, one EnhancementPak license and one ViewKit license. One Database Xcessory license provides the Customer one BX PRO license and one DBPak license. One BX/Win SDK license provides one NuTCRACKER X/SDK license and five NuTCRACKER runtime licenses. For DBPak, EnhancementPak, EditTable, ChartObject, View 3D or ViewKit, the license may only be used for the development of applications, in which the Program is an integral part and may not be separately accessed. The Documentation may not be copied or distributed without ICS' approval. 2. Customer Rights: Customer may (a) install the Program on a single computer owned or controlled by Customer (the "Server"); (b) with Builder Xcessory or Database Xcessory, permit the use of the Program by the number of simultaneous authorized users linked to the Server as specified in the Customer's order; (c), with BX/Win SDK, DBPak, EnhancementPak, EditTable, ChartObject, View 3D or ViewKit, permit the use of the Program by a number of unique users as specified in the Customer's order; and (d) make a reasonable number of back-up copies of the Program to protect against malfunction of or damage to the computer system or media on which the Program is used or stored. Additional simultaneous users may be added by notifying ICS and paying the then- current fees. Customer shall not otherwise use, copy or modify the Program, or use or create any adaptation or transcription of the Program, or merge the Program with any other program, except as authorized by ICS in writing. Customer may not lease the Program to any party. Customer may not transfer the Program or license it to another party. Customer shall not attempt to reverse engineer, disassemble or decompile the Program. Customer may obtain the authorization code necessary to permit the Program to run on a computer other than the Server, and may transfer the Program to such other computer, only if the Customer deletes all copies of the Program from the Server and pays ICS its then-current administrative charge for such transfer. 3. Limited Warranty: (a) ICS warrants that for ninety (90) days from the date of delivery to Customer, each copy of the Program, when installed and used in accordance with the Documentation, will conform in all material respects to the description of the Program's operations in the Documentation. (b) Customer's exclusive remedy and ICS' and its distributors' sole liability under this warranty shall be for ICS to attempt, through reasonable efforts, to correct any material failure of the Program to perform as warranted, if such failure is reported to ICS within the warranty period and Customer, at ICS' request, provides ICS with sufficient information (which may include access to Customer's computer system for use of Customer's copies of the Program by ICS personnel) to repair the defect in question or replace the Program with a functioning copy; provided, that if ICS is unable to correct any such failure or replace the Program within a reasonable time, ICS may, at its sole option, refund to Customer the license fee paid for the Program, in which event the license shall terminate. (c) ICS need not treat minor discrepancies in the Documentation as errors in the Program, and may instead furnish corrections to the Documentation. (d) Neither ICS nor its distributors warrant that operation of the Program will be uninterrupted or error-free, or that all errors will be corrected. (e) This limited warranty is void if failure of the Program has resulted from accident, abuse or misapplication. (f) THE FOREGOING WARRANTY IS IN LIEU OF, AND ICS AND ITS DISTRIBUTORS DISCLAIM, ALL OTHER WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR ANY PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT WILL ICS OR ITS DISTRIBUTORS BE LIABLE FOR ANY SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, INCLUDING WITHOUT LIMITATION LOST PROFITS OR LOST DATA, ARISING OUT OF THE USE OR INABILITY TO USE THE PROGRAM OR DOCUMENTATION, EVEN IF ICS HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. ICS' AGGREGATE LIABILITY ARISING OUT OF THIS AGREEMENT, REGARDLESS OF THE FORM OF ACTION OR CLAIM, SHALL BE LIMITED TO THE AMOUNTS PAID BY CUSTOMER TO ICS FOR THE PROGRAM HEREUNDER. (g) Some states do not allow the exclusion of implied warranties or limitations on how long an implied warranty may last, so the above limitations and exclusions may not apply to you. This warranty gives you specific legal rights, and you may also have other rights which vary from state to state. 4. Term and Termination: The term of this Agreement shall be indefinite; however, this Agreement may be terminated by ICS in the event of a default under this Agreement by Customer. Customer may terminate this Agreement at any time by destruction of the Program, the Documentation, and all copies of both of them. Upon termination, Customer shall immediately cease use of, and return immediately to ICS, all existing copies of the Program and Documentation, and cease all use thereof. All provisions hereof regarding liability and limits thereon shall survive the termination of this Agreement. 5. U.S. Government Restricted Rights Legend: (a) For units of the DoD: Restricted Rights Legend Use, duplication or disclosure by the Government is subject to restrictions as set forth in subparagraph (c) (1) (ii) of the Rights in Technical Data and Computer Software clause at DFAR 252.227-7013. (b) For civilian agencies: Restricted Rights Legend Use, reproduction or disclosure is subject to the restrictions set forth in subparagraphs (a) through (d) of the Commercial Computer Software-Restricted Rights clause at CFR 52.227-19 and the limitations set forth in ICS' standard commercial agreement for this software, as applicable. Contractor/manufacturer is INTEGRATED COMPUTER SOLUTIONS, INC., 201 Broadway, Cambridge, MA 02139. 6. Governing Law: This license shall be governed by and construed in accordance with the laws of the Commonwealth of Massachusetts as a contract made and performed therein.
BX PRO, Builder Xcessory, BX, BX/Win SDK, Database Xcessory, DatabasePak, DBPak, EPak PRO, EnhancementPak, EPak, and ViewKit are trademarks of Integrated Computer Solutions, Inc. EditTable, ChartObject and View3D are trademarks of Interactive Network Technologies, Inc. Motif is a registered trademark of The Open Group. X Window System is a trademark of The Open Group. NuTCRACKER is a trademark of DataFocus. IRIS ViewKit is a trademark of Silicon Graphics Incorporated.
Installing ICS Software
Overview
ICS products
The BX PRO 5.0 CD-ROM contains 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 which products you have purchased.
Evaluating software
The evaluation distribution is identical to the full distribution. However, all applications built against the evaluation distribution of BX PRO display a dialog notifying the user that the application is using evaluation versions of the BX PRO widgets.
You can upgrade to the full distribution by purchasing a license from ICS. Any application built against the evaluation widgets can be rebuilt against the full distribution--no code changes are necessary.
Decryption and Activation Keys for Purchased Products
If you purchased an ICS product
Depending on the ICS product you purchase, you might require the following keys:
-
Decryption key
Required for ICS products that include libraries and used to extract the software from the CD-ROM. The decryption key is included with your distribution.
Note: A decryption key is not required for Builder Xcessory.
-
License Activation key
Allows 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 "Obtaining Your License Activation Key" for more information.)
Activation Keys for Evaluation Products
If you are evaluating an ICS product
If you are evaluating an ICS product, you must install the evaluation version of our product. Depending on the ICS product that you purchase, you might need a temporary license activation key.
Note: If you are evaluating BX PRO or Builder Xcessory, you must obtain a temporary license activation key to save Builder Xcessory UIL files.
Obtaining a license activation key
Check your evaluation cover letter for a temporary license activation key. If your cover letter does not include a license activation key, contact ICS as follows:
· E-mail: keys@ics.com
- WWW: http://www.ics.com/support/getkey/
- FAX: 617.621.9555
- Telephone: 617.621.0060
Contents of the Distribution
The BX PRO 5.0 CD -ROM contains the following software:
Software
· BX PRO 5.0 (full feature and evaluation versions)
- Builder Xcessory 5.0 (full feature and evaluation versions)
- ViewKit ObjectPak 1.3.1 (full feature and evaluation versions)
- EPak PRO 3.0.1 (full feature and evaluation versions)
- EnhancementPak 3.0.1 (full feature and evaluation versions)
- ChartObject 3.0.1
- EditTable 3.0.1
- INT Widgets 3.0.1 (ChartObject 3.0.1 and EditTable 3.0.1)
- View3D 2.0
- FLEXlm License Manager 3.0
- setup (ICS software installation program)
- remove, rmlinks (ICS software removal scripts)
Documentation for ICS Products
The documentation set you receive depends upon which product(s) you purchased. ICS product documentation is available also from the ICS website, as described in "HTML Documentation on the ICS Website" .
The following table lists the documentation included with your purchase:
INT Widgets and View3D
The following table lists the documentation included with your purchase of the INT Widgets, ChartObject, EditTable, and View3D, which are available separately:
| Document | Product | |||
|---|---|---|---|---|
| ChartObject | EditTable | View3D | INT WIdgets | |
| ChartObject Programming Guide | ||||
| EditTable Programming Guide | ||||
| EPak PRO 3.0 Release Notes | ||||
| BX PRO 5.0 Installation Notes | ||||
Documentation for ICS Evaluation Products
If you are evaluating an ICS product, some documentation is available on the CD-ROM, but you may receive only a subset of the documents listed in the previous table. To obtain copies of the ICS documentation, contact your sales representative. Also, ICS product documentation is available from the ICS website, as described in "HTML Documentation on the ICS Website".
HTML Documentation on the ICS Website
ICS website
The most recent HTML versions of ICS product documentation are available from the ICS website at: http://www.motif.ics.com
Using Online Help
HTML online help
With BX PRO 5.0 and Builder Xcessory 5.0 uses HTML files for online help. To use the online help you must have a Netscape web browser installed.
Installing Netscape Navigator
If you do not already have a browser installed, you can install Netscape Navigator 4.0 include in the netscape or NETSCAPE directory of the BX PRO 5.0 CD-ROM.
Note: The .tgz files are GNU zipped tar files of the Navigator distribution from Netscape.
ICS Product System Requirements
This section disrobes the system requirements for all ICS products.
BXPRO and Builder Xcessory
BX PRO 5.0 and Builder Xcessory 5.0 require the following system configuration:
- At least 16 MB of RAM (we recommend 32 MB of RAM)
- X11R5 or later
- Motif Version 1.2 or later
-
High resolution graphics display: 1024 x 768 is required;
1280 x 1024 is recommended
EPak PRO, EPak, EditTable, ChartObject, and View3D
EPak PRO 3.0.1 (including EnhancementPak 3.0.1, EditTable 3.0.1, and ChartObject 3.0.1), the INT widgets (ChartObject 3.0.1 and EditTable 3.0.1) and View3D 2.0 require the following system configuration:
ViewKit
ViewKit 1.3.1 requires the following system configuration:
Disk space requirements
The installer automatically calculates your exact disk space requirements based on the software you choose to install. The following table lists the amount of disk space required for each product according to your platform:
Notes on the Installer
The installer is run by using a script called setup, located in the top-level directory on the CD-ROM. Run this script to install any of the software in the BX PRO distribution.
Notation
Throughout this document, a monospaced typeface indicates text displayed on your screen. A bold monospaced typeface indicates text you enter in response to a prompt.
Prompt Format
Most questions asked by the installer have the following format:
- Question {option1 / option2 / ...} "default option"
Press Enter at the prompt to choose the default option; otherwise enter the desired option as displayed.
At other times, the installer 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 installation:
If you choose to abort, the installer provides the option of removing anything already installed:
Installing into an NFS-mounted File System
During the normal installation process, the installer sets the file ownerships and permissions on all 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 such as the following is displayed:
Example error message
It is generally safe to continue the installation from this point.
Alternatively, you can abort the installation, export the destination file system with "root" write permission for the machine on which you are running the installer, and restart the installation procedure.
Installation Procedure
Running the setup script
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 BX PRO 5.0 CD-ROM Mounting Instructions, included with the BX PRO 5.0 CD. If you are unsure how to do this, consult your system administrator.
- Change directories to the mount directory.
- Run ./setup.
-
If the script cannot find the mount point, you are prompted to specify a mount point:
- Enter the CD-ROM mount point:
-
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 2.0) -- Main Menu
- - Enter "?" for help anywhere -
- Choose from one of the following items:
- (1) BX PRO 5.0 - Builder Xcessory 5.0, ViewKit 1.3.1,
- EPak 3.0.1
- (2) BX PRO 5.0 Evaluation
- (3) EPak PRO 3.0.1 - EPak 3.0.1, EditTable 3.0.1,
- ChartObject 3.0.1
- (4) EPak PRO 3.0.1 Evaluation
- (5) Builder Xcessory 5.0
- (6) ViewKit ObjectPak 1.3.1
- (7) ViewKit ObjectPak 1.3.1 Evaluation
- (8) Enhancement Pak 3.0.1
- (9) Enhancement Pak 3.0.1 Evaluation
- (10) INT Widgets 3.0.1
- (11) EditTable 3.0.1
- (12) ChartObject 3.0.1
- (13) View3D 2.0
- (14) View3D 2.0 Evaluation
- (15) FLEXlm 3.0 - Flexible License Manager Server
-
(16) *** Exit ***
- Select a Product to Install... 1
-
ICS Installer (v 2.0) -- Main Menu
The following section outlines a complete BX PRO1 installation. Installation of all other packages is similar.
Note: The installation sequence may vary depending on the options you choose.
License manager
If you are installing BX PRO or Builder Xcessory, you may also need to install the FLEXlm license manager. FLEXlm version 3.0 is provided on the BX PRO 5.0 CD-ROM. If you have previously installed version 3.0 or later of the license manager server, or if your system provides version 3.0 or later, you do not need to install FLEXlm.
Library products
ICS library products (for example, EnhancementPak and ViewKit), do not require the license manager.
- Specify the architecture and operating system of the platform on which you want to install:
- Enter the directory into which you would like the software installed. If the directory does not exist, the installer prompts you and optionally creates it for you.
- Enter your decryption key2. 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).
- You have the option to automatically create symbolic links from /usr/include, /usr/lib, and /usr/man to the installed software.
-
You now have various options, which differ from platform to platform. In this case, you have the option to select which application defaults files to install:
-
[BX 5.0 Binaries for Solaris 2.4+]
- Choose from one of the following items:
- (1) CDE Styles/Widget Integration
- Choosing CDE Styles/Widget Integration installs application defaults files for Builder Xcessory which use the CDE Color and Font palettes. Additionally, this option installs support the CDE widgets found in libDtWidget.
- (2) Default BX
- Choosing the Default BX option uses the default Builder Xcessory application defaults file. No changes are made to make use of platform-specific color and font palettes.
-
- Choose the default integration: 1
-
[BX 5.0 Binaries for Solaris 2.4+]
-
You have the option to install the EPak PRO debug libraries:
- Install optional part "EPak Debug Libraries" (8.91 Mbytes) {yes/no} "yes" yes
ViewKit only
-
Because of differences in supported C++ compilers, you may need to install the correct version of the ViewKit ObjectPak libraries.
-
[BX PRO 5.0 ViewKit Libraries for Solaris 2.4+]
- Choose from one of the following items:
- (1) C Front C++ Compiler
- Choosing C Front C++ Compiler will install ViewKit libraries compatible with SunSoft C++ Version 2.0. This is SunSoft's cfront-based compiler.
- (2) Native C++ Compiler
- Choosing Native C++ Compiler will install ViewKit libraries compatible with SunSoft C++ Version 3.0 or higher. This is SunSoft's native C++ compiler.
- (3) GNU C++ Compiler
- Choosing GNU C++ Compiler will install ViewKit libraries compatible with version 2.7.2 of the GNU C++ Compiler (g++).
-
- Choose your C++ Compiler: 2
-
[BX PRO 5.0 ViewKit Libraries for Solaris 2.4+]
-
You have the option to install the ViewKit debug libraries:
- Install optional part "ViewKit Debug Libraries" (15.97 Mbytes) {yes/no} "yes" yes
- You now have the option to configure your Imake environment for ViewKit ObjectPak. Your site.def file must be located in the customary location, /usr/lib/X11/config or /usr/openwin/config, for this to succeed.
-
You have the option to install the ViewKit example code:
- Install optional part "ViewKit 1.3 Example Code" (0.55 Mbytes) {yes/no} "yes" yes
-
You have the option to install the ViewKit manual pages:
- Install optional part "ViewKit 1.3 Manual Pages" (0.71 Mbytes) {yes/no} "yes" yes
-
You have the option to install the EPak example code:
- Install optional part "EPak 3.0.1 Example Code" (1.11 Mbytes) {yes/no} "yes" yes
-
Confirm that the correct software packages are to be installed. The installer displays the install tree. "Leaves" of the tree have sizes associated with them.
-
<<< Product Install Profile >>>
- - BX PRO 5.0 - [63.15 Mbytes]
- - BX 5.0 Data Files - [7.71 Mbytes]
- - ViewKit 1.3 Include & Data Files - [0.63 Mbytes]
- - EPak 3.0.1 Include & Data Files - [0.53 Mbytes]
- - BX 5.0 Binaries for Solaris 2.4+ - [21.06 Mbytes]
- - BX 5.0 CDE Integration - [0.03 Mbytes]
- - BX PRO 5.0 EPak Libraries for Solaris 2.4+ - [11.42 Mbytes]
- - EPak Debug Libraries - [8.91 Mbytes]
- - BX PRO 5.0 ViewKit Libraries for Solaris 2.4+
- - ViewKit Libraries for Sun Native C++ - [19.42 Mbytes]
- - ViewKit Debug Libraries - [15.97 Mbytes]
- - ViewKit Options
- - ViewKit 1.3 Example Code - [0.55 Mbytes]
- - ViewKit 1.3 Manual Pages
- - Nroff Manual Pages - [0.71 Mbytes]
- - EPak 3.0.1 Example Code - [1.11 Mbytes]
-
<<< Product Install Profile >>>
-
If there is not enough disk space to install the software, the installer prompts you to specify a new location.
-
>>> Product Install: BX PRO 5.0 [Solaris 5.5.1]
- Disk Use: 34.27 Mbytes free, 63.15 Mbytes required
- WARNING: Not enough disk space, "/usr/bxpro"
- [BX PRO 5.0] Enter destination dir ('@' aborts install): /nfs/sparc/bxpro
- Directory "/nfs/sparc/bxpro" does not exist.
- Create named directory? {yes/no} "yes" yes
- Disk Use: 2048.00 Mbytes free, 63.15 Mbytes required
-
[BX 5.0 Data Files] Extracting media...
- [BX 5.0 Data Files] Data 100% Installed (7.71 out of 7.71 Mbytes)
- Install 12% Complete (7.71 out of 63.15 Mbytes Total)
- [ViewKit 1.3 Include & Data Files] Extracting media...
- [ViewKit 1.3 Include & Data Files] Data 100% Installed (0.63 out of 0.63 Mbytes)
- Install 13% Complete (8.34 out of 63.15 Mbytes Total)
- [EPak 3.0.1 Include & Data Files] Extracting media...
- [EPak 3.0.1 Include & Data Files] Data 100% Installed (0.53 out of 0.53 Mbytes)
- Install 14% Complete (8.87 out of 63.15 Mbytes Total)
- [BX 5.0 Binaries for Solaris 2.4+] Extracting media...
- [BX 5.0 Binaries for Solaris 2.4+] Data 100% Installed (21.03 out of 21.03 Mbytes)
- Install 47% Complete (29.90 out of 63.15 Mbytes Total)
- [BX 5.0 CDE Integration] Extracting media...
- [BX 5.0 CDE Integration] Data 100% Installed (0.03 out of 0.03 Mbytes)
- Install 47% Complete (29.93 out of 63.15 Mbytes Total)
- [BX PRO 5.0 EPak Libraries for Solaris 2.4+] Extracting media...
- [BX PRO 5.0 EPak Libraries for Solaris 2.4+] Data 100% Installed (2.52 out of 2.52 Mbytes)
- Install 51% Complete (32.44 out of 63.15 Mbytes Total)
- [EPak Debug Libraries] Extracting media...
- [EPak Debug Libraries] Data 100% Installed (8.91 out of 8.91 Mbytes)
- Install 65% Complete (41.35 out of 63.15 Mbytes Total)
- [ViewKit Libraries for Sun Native C++] Extracting media...
- [ViewKit Libraries for Sun Native C++] Data 100% Installed (3.46 out of 3.46 Mbytes)
- Install 70% Complete (44.81 out of 63.15 Mbytes Total)
- [ViewKit Debug Libraries] Extracting media...
- [ViewKit Debug Libraries] Data 100% Installed (15.97 out of 15.97 Mbytes) Install 96% Complete (60.77 out of 63.15 Mbytes Total)
- [ViewKit 1.3 Example Code] Extracting media...
- [ViewKit 1.3 Example Code] Data 100% Installed (0.55 out of 0.55 Mbytes) Install 97% Complete (61.32 out of 63.15 Mbytes Total)
- [Nroff Manual Pages] Extracting media...
- [Nroff Manual Pages] Data 100% Installed (0.71 out of 0.71 Mbytes)
- Install 98% Complete (62.04 out of 63.15 Mbytes Total)
- [EPak 3.0.1 Example Code] Extracting media...
- [EPak 3.0.1 Example Code] Data 100% Installed (1.11 out of 1.11 Mbytes) Install 100% Complete (63.15 out of 63.15 Mbytes Total)
- ------------------------------------------------------
- Creating the Builder Xcessory startup shell script: bx50
- ------------------------------------------------------
- DONE
- ------------------------------------------------------
- Creating the Code Generator startup shell script: cgx50
- ------------------------------------------------------
- DONE
- ------------------------------------------------------
- Creating the BX Object Packager startup shell script: bxop50
-
------------------------------------------------------
- DONE
-
>>> Product Install: BX PRO 5.0 [Solaris 5.5.1]
EPak PRO or EPak
If you are installing EPak PRO or EnhancementPak, at this point you have the option of viewing the Release Notes.
A complete list of the installed files is written to the file displayed here.
-
SUCCESS: Product Installed [BX PRO 5.0]
- List of installed files: /usr/bxpro/bxpro50.dat
- ICS Installer (v 2.0) -- Main Menu
- - Enter "?" for help anywhere -
- Choose from one of the following items:
- (1) BX PRO 5.0 - Builder Xcessory 5.0, ViewKit 1.3.1,
- EPak 3.0.1
- (2) BX PRO 5.0 Evaluation
- (3) EPak PRO 3.0.1 - EPak 3.0.1, EditTable 3.0.1,
- ChartObject 3.0.1
- (4) EPak PRO 3.0.1 Evaluation
- (5) Builder Xcessory 5.0
- (6) ViewKit ObjectPak 1.3.1
- (7) ViewKit ObjectPak 1.3.1 Evaluation
- (8) Enhancement Pak 3.0.1
- (9) Enhancement Pak 3.0.1 Evaluation
- (10) INT Widgets 3.0.1
- (11) EditTable 3.0.1
- (12) ChartObject 3.0.1
- (13) View3D 2.0
- (14) View3D 2.0 Evaluation
- (15) FLEXlm 3.0 - Flexible License Manager Server
-
(16) *** Exit ***
- Select a Product to Install... 16
At this point, you can install another software package, or exit. If FLEXlm is not installed, you must install it now to run Builder Xcessory. Refer to "License Manager" for more information about installing the license manager.
Error log file
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.
Session transcript logged in temp file: /usr/tmp/icsAAAa01292
1
BX PRO includes Builder Xcessory, EnhancementPak, and ViewKit ObjectPak.
2
This decryption key differs from the BX license key because the decryption key is used only to load the software from the CD-ROM and is supplied with your software. A license key, required only for BX PRO and Builder Xcessory, is obtained by contacting ICS and providing information on your host system. Refer to "Obtaining Your License Activation Key" and "Troubleshooting FLEXlm" for more information.
License Key
If you installed BX PRO or Builder Xcessory, you require the FLEXlm license manager. Refer to "License Manager" for more information.
Starting Builder Xcessory
To start Builder Xcessory, enter one of the following commands at the command line (where {BX} is the directory in which you installed BX PRO or Builder Xcessory):
- % {BX}/bin/bx50
Add {BX}/bin to your path, and use
- % bx50
We recommend using the bx50 script to run Builder Xcessory. Builder Xcessory files (including the application defaults files) are not installed outside the Builder Xcessory {BX} directory . The bx50 script sets various environment variables, so that Builder Xcessory can run normally.
Using the bx Binary Directly
If you plan to use the bx binary directly, you must complete the following steps:
-
Add {BX}/admin/Defaults/%N.ad to your
XUSERFILESEARCHPATH environment variable. -
Set your shared library search path environment variable (LD_LIBRARY_PATH, SHLIB_PATH, and so on) to include
{BX}/xcessory/lib. - Add {BX}/bin to your PATH environment variable.
- Run Builder Xcessory with the following command: % bx -system_directory {BX}
License Manager
Overview
The BX PRO 5.0 distribution contains FLEXlm 3.0, a license manager from GLOBEtrotter Software. To use Builder Xcessory 5.0, you must have FLEXlm version 3.0 or later installed on your system. If FLEXlm 3.0 or later is not installed on your system, you must replace the FLEXlm license daemon (lmgrd) on your system with the one included in the Builder Xcessory 5.0 distribution.
If you are not sure which version of the FLEXlm license daemon lmgrd is installed on your system, contact your system administrator.
Setting up the license manager
Setting up the license manager for use with Builder Xcessory consists of the following steps:
- Installing the FLEXlm software
- Obtaining your License Activation Key
- Installing your License Activation Key
- Running the License Manager Daemon
Builder Xcessory uses GLOBEtrotter Software's Flexible License Manager. After you have installed Builder Xcessory and the license manager, contact Integrated Computer Solutions, Inc. immediately to receive your activation key. This key, based on information about your server configuration, will be your password to the Builder Xcessory license server. Without it, you can still run Builder Xcessory in demo mode, but cannot save a session's work by writing out UIL files.
Note: You must run version 3.0 or higher of lmgrd to grant licenses Builder Xcessory. If you are running version 3.0 or higher of FLEXlm, you do not need to reinstall the license manager.
Pre-3.5 Builder Xcessory users
If you have a license for versions of Builder Xcessory prior to 3.5, you must install the newer FLEXlm version. You will be warned before any file is overwritten.
Installing a new version of FLEXlm
If you choose to install the newer version of FLEXlm, confirm that the current lmgrd is not running. Use lmdown to shut down the license manager.
How The License Manager Works
License daemon and license.dat file
A license daemon (lmgrd) runs on one or more systems somewhere on your network. These systems are called license servers. The license daemon accesses a license data file named license.dat, which contains information on your licenses and your license servers. Each system on which Builder Xcessory executes must have the license.dat file available to it, either by way of an NFS-mount or by having a local copy of the file.
When you run Builder Xcessory, it looks in the license.dat file for the license server(s) and it requests a license from lmgrd on the listed server(s). If a license is available, the program runs normally. If no license is available, Builder Xcessory runs in demo mode.
The license.dat file is created when you install FLEXlm. Typically, the license.dat file is placed in the /usr/local/flexlm/licenses directory, often a directory accessible by all systems on the network.
How Many License Servers Do I Need?
You may want to run multiple licenses servers. Running multiple servers allows you to continue to work, even if one of your license servers is down.
Single server
To obtain a license in a multiple-server environment, a majority of the servers must be running.You can use a single license server or you can have as many as five servers.
Multiple servers
If your machine is not always at your site, has occasional problems, or is not accessible to everyone on the network, you may want to use multiple servers. In most cases, however, a single server is preferred.
Note: A two-server configuration is not recommended. If one server is down, a majority of servers is not running, and you will not be able to obtain a license.
Installing the FLEXlm Software
- Log in as root.
- Mount the BX PRO 5.0 CD-ROM as appropriate 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:
- Enter the CD-ROM mount point:
-
You are given a list of packages and asked which you want to install. Enter the number corresponding to the desired package, in this case, 15.
-
ICS Installer (v 2.0) -- Main Menu
- - Enter "?" for help anywhere -
- Choose from one of the following items:
- (1) BX PRO 5.0 - Builder Xcessory 5.0, ViewKit 1.3.1,
- EPak 3.0.1
- (2) BX PRO 5.0 Evaluation
- (3) EPak PRO 3.0.1 - EPak 3.0.1, EditTable 3.0.1,
- ChartObject 3.0.1
- (4) EPak PRO 3.0.1 Evaluation
- (5) Builder Xcessory 5.0
- (6) ViewKit ObjectPak 1.3.1
- (7) ViewKit ObjectPak 1.3.1 Evaluation
- (8) Enhancement Pak 3.0.1
- (9) Enhancement Pak 3.0.1 Evaluation
- (10) INT Widgets 3.0.1
- (11) EditTable 3.0.1
- (12) ChartObject 3.0.1
- (13) View3D 2.0
- (14) View3D 2.0 Evaluation
- (15) FLEXlm 3.0 - Flexible License Manager Server
-
(16) *** Exit ***
- Select a Product to Install... 15
-
ICS Installer (v 2.0) -- Main Menu
-
Specify the architecture and OS of the platform on which you want to install:
- Choose from one of the following items:
- (1) Sparc
- (2) HP
- (3) IBM
- (4) SGI
- (5) Alpha
-
(6) Exit
- Select destination Architecture... "Sparc" 1
- Choose from one of the following items:
- (1) SunOS 4.1 (4.x compatible)
- (2) Solaris 5.4 (5.x compatible)
- (3) Other
-
(4) Exit
- Select destination platform: OS and version... "Solaris 5.5.1" 2
-
Enter the directory into which to install FLEXlm. If the directory does not exist, the installer prompts you and optionally creates it for you.
- [FLEXlm 3.0] Enter the destination directory: /usr/bxpro
-
Optionally install the man pages.
- Install optional part "FLEXlm Man" (0.05 Mbytes) {yes/no} yes
- Confirm that you want to install the software as profiled:
-
If there is insufficient disk space to perform the installation, the installer prints a warning message and asks you to specify another directory. Otherwise, the installer proceeds. A spinning bar is displayed while the software is extracted from the CD-ROM.
- >>> Product Install: FLEXlm 3.0 [SunOS 4.1.3_U1]
- Disk Use: 247.87 Mbytes free, 0.36 Mbytes required
-
[FLEXlm 3.0] Extracting media...
[FLEXlm 3.0] Data 100% Installed (0.00 out of 0.00 Mbytes)
Install 0% Complete (0.00 out of 0.36 Mbytes Total)
[FLEXlm Man] Extracting media...
[FLEXlm Man] Data 100% Installed (0.05 out of 0.05 Mbytes)
Install 13% Complete (0.05 out of 0.36 Mbytes Total)
[FLEXlm Bin (SunOS 4)] Extracting media...
[FLEXlm Bin (SunOS 4)] Data 100% Installed (0.31 out of 0.31 Mbytes)
Install 100% Complete (0.36 out of 0.36 Mbytes Total)
-
Enter the directory in which to create the License Data File. This file will contain your License Activation Keys.
Note: GLOBEtrotter Software recommends this default directory location for the License Data File.
- Enter the License Data File directory. [/usr/local/flexlm/licenses]
-
Enter the name of the License Data File to be created.
Note: GLOBEtrotter Software recommends this default filename for the License Data File.
- Enter the License Data File name.[license.dat]
-
Provide various information required by the License Manager, including hostname, hostid, and TCP/IP service port numbers for your license servers. If you do not have this information ready, simply select the defaults. When you obtain your License Activation Key, provide the correct information.
- You will need to enter the hostname, hostid, and TCP/IP service port number for each system you would like to use as a license server. Use the "lmhostid" command to determine the hostid to use. You may enter a maximum of five hostname/hostid/tcpip_port triplets.
- For more information on license server specifications, see the accompanying documentation on configuring the license manager.
- NOTE: If you do not yet have a BX License Activation Key, you may simply use the initial default values and fill in the remaining servers at your leisure.
-
Enter the hostname of license server machine.
License Server hostname [ics] ics -
Enter the hostid of the named machine (use hostid).
Host ID of ics [unset] unset -
Enter the service port for the license manager to use.
TCP/IP Port to use on ics [7310] 7310 -
YES will enter this line in the License Data File...
SERVER ics unset 7310
Is this correct? [y] yThis script cycles, allowing you to provide information on up to five license servers.
-
Press ENTER at the hostname prompt to end the server list
Enter the hostname of license server machine.
License Server hostname [_end_list_] _end_list_
-
Enter the location of the ICSBX daemon. This is located in {BX}/bin, where {BX} is the directory in which Builder Xcessory was installed.
- Enter the location of the ICSBX daemon.[/usr/bxpro/bin]
-
Optionally install the FLEXlm boot scripts.
- You now have the option of installing the scripts necessary to start the license manager when the system is booted. If you have already installed the license manager for another product and are using that lmgrd, you do may not need to install the boot scripts. If this is the first time you have installed a product licensed with the Flexible License Manager, you will want to install the scripts.
- Install the FLEXlm Boot-time Start scripts? [y] y
-
Installing the FLEXlm Boot-time Start scripts...
...Done -
Remember, you need to install the product activation key before starting the license manager daemon.
You can start the license manager immediately. For more information on running the license manager daemon, see "Starting the License Manager Daemon" .
- Start FLEXlm (lmgrd) now? [y] n
- To start the License Manager manually, use the following command line:
-
/export/jackal/tmp/aubtst/bin/lmgrd -c
/export/jackal/tmp/aubst/licenses/license.dat > [logfile] &If you have installed the license.dat file anywhere other than in the default location, the installer reminds you of this.
- I M P O R T A N T N O T E
- Because you have installed the license file in a non-default directory or with a non-default name, you will have to set the LM_LICENSE_FILE environment variable when running a licensed product. See the accompanying documentation for more information regarding the use of this environment variable.
- SUCCESS: Product Installed [FLEXlm 3.0]
- List of installed files: /export/jackal/tmp/aubtst/lmsrvr.dat
- You've now completed the installation of the FLEXlm software. You must now obtain and install your License Activation Key.
Obtaining Your License Activation Key
For purchased products
To receive your activation key, provide ICS with the following information:
- Your Customer Support Number, which can be found on the Customer Support Card in the package or the sticker on the media cover.
- The host name of each license server (that is, the name of each machine that will be running lmgrd).
- The lmhostid of each server.
Obtaining lmhostid for a Server
To obtain lmhostid for a server, execute the following program on the server.
- % {FLEXlm}/bin/lmhostid
where {FLEXlm}is the directory where FLEXlm is installed. This process returns the host id used by lmgrd on your system.
Contacting ICS
Fax or email the information described in "Obtaining Your License Activation Key" to ICS as follows:
- Fax the completed Key Request Form included with your software distribution to (617) 621-9555.
-
Email the information to keys@ics.com. Please include your email address.
Note: ICS provides an activation key encoded with your number of licenses and the date of their expiration. Unless you are notified otherwise, there is no expiration date.
Installing the License Activation Key
Run the Activation Key installation script by entering the following at the command line:
- % {BX}/admin/FLEXlm/addlmkey
where {BX} is the directory in which Builder Xcessory was installed.
You are presented with the following menu:
- =========================================================
- Flexible License Manager License Key Installation
- =========================================================
-
[1] License Data File: /usr/local/flexlm/licenses/license.dat
[2] License Type: FULL BX Feature License
[3] License Version: 5.000
[4] Expiration Date: 01-jan-00
[5] Number of Licenses: 1
[6] Activation Key: -
1. Change license data file.
2. Change license type.
3. Change the license version.
4. Change the license expiration date.
5. Change the number of licenses.
6. Change activation key -
I. Install this key.
Q. Quit - Selection (? for Help):
Edit the options available from this menu by selecting the number or letter corresponding to the option you wish to change.
Enter "I" to proceed with the installation of the key. The script tells you how the installation is progressing. When the installation is completed, the script returns you to your UNIX prompt.
Setting Up License Servers in license.dat
If your license server information was available when you installed FLEXlm, your license.dat file should now be complete. New Builder Xcessory users, however, probably did not have the hostid available, because the utility used to obtain the id (lmhostid) was in the process of being installed.
Editing the license.dat file
Edit the license.dat file as follows:
- Add your license server information to the beginning of the file.
- Replace any incomplete or incorrect SERVER information that may have been generated during the FLEXlm install procedure.
Example license.dat file
This section provides an example license.dat file. If you are using multiple license servers, list them one after another on separate lines.
SERVER hostname hostid TCP/IP_port
DAEMON ICSBX {BX}/bin
FEATURE BuilderXcessory ICSBX 5.000 01-jan-00 5 7CE011B74C7D \
VENDOR_STRING="ICS Builder Xcessory"
Note: Your License Activation Key is generated using your License Server information. If you change license servers, you must obtain a new License Activation Key.
Starting the License Manager Daemon
Starting lmgrd with license.dat in the default directory
After setting up the license.dat file, you must start the License Manager (lmgrd) daemon. If you put the license.dat file in directory /usr/local/flexlm/licenses, enter the following to start the license manager daemon:
- % {BX}/bin/lmgrd > {your log file directory}/{your log file} &
Starting lmgrd with license.dat in a directory other than default
If you decide to put the license.dat file somewhere other than in directory /usr/local/flexlm/licenses, or if you change the name of the license file, you must set the LM_LICENSE_FILE environment variable or use the -c option. To start lmgrd with the -c option type the following all on one line:
-
{BX}/bin/lmgrd -c
{license_file_path}/{license_file_name}
> {your_log_file_directory}/{your_log_file} &
Overriding the default name and directory
To override /usr/local/flexlm/licenses/license.dat as the location or the name of the license file, use the environment variable LM_LICENSE_FILE. For example:
- setenv LM_LICENSE_FILE <license_file_path>
where <license_file_path> is the full pathname to the license file, including the name of the license file.
Multiple license files
If you have multiple license files in various locations, you can list each of them in the LM_LICENSE_FILE variable:
- setenv LM_LICENSE_FILE <path_one>:<path_two>:...
Typically, lmgrd is started automatically at system boot time by adding the command to /etc/rc.boot, /etc/rc.local, or the appropriate startup file.
License Manager Daemon Already Running
If the License Manager (lmgrd) daemon is already running and you change or add a FEATURE line for an already running daemon, you should use the FLEXlm utility lmreread. This program notifies the license server that there have been changes made to the license.dat file.
If you add any DAEMON lines to the license.dat file, use lmdown to shut down the license manager and then restart lmgrd, rather than running lmreread.
All of the FLEXlm utilities are located in {FLEXlm}/bin, where {FLEXlm}is the directory where the FLEXlm software is installed. The man pages for these utilities are printed in the Builder Xcessory Reference Manual.
Troubleshooting FLEXlm
Refer to Appendix C--License Manager in the Builder Xcessory 5.0 Reference Manual for complete information on FLEXlm, including a guide to troubleshooting the license manager installation.
Integrating BX into a Development Environment
Overview
This section describes how to integrate Builder Xcessory 5.0 into SunSoft WorkShop, DEC FUSE, or Silicon Graphics Developer Magic (formerly CASEVision) environments.
After installing BX PRO into your development environment, you can use your environment's tools with Builder Xcessory, as described in the Builder Xcessory User's Guide.
Integrating into SunSoft WorkShop
To integrate Builder Xcessory with SunSoft WorkShop:
- Change directories to {BX}/admin/WorkShop, where {BX} is the directory where Builder Xcessory is installed.
- Enter the following at the command line:
- When prompted by the script, enter the Builder Xcessory home directory ({BX}) and the SunSoft WorkShop directory.
When the script finishes running, Builder Xcessory is added to the WorkShop Manager.
Integrating into DEC FUSE
To integrate Builder Xcessory with DEC FUSE:
- Change directories to {BX}/admin/FUSE, where {BX} is the directory where Builder Xcessory is installed.
- Enter the following at the command line:
- When prompted by the script, enter the Builder Xcessory home directory ({BX}) and the DEC FUSE directory.
When the script finishes running, Builder Xcessory is added to the DEC FUSE Control Panel Tools Menu.
Integrating into SGI Developer Magic
To integrate Builder Xcessory with SGI Developer Magic:
- Change directories to {BX}/admin/DevMagic, where {BX} is the directory where Builder Xcessory is installed.
- Enter the following at the command line:
- When prompted by the script, enter the Builder Xcessory home directory ({BX}).
When the script finishes running, Builder Xcessory is added to the Developer Magic Launch menu.
Removing ICS Software
Using the remove Script
The BX PRO distribution includes a script called remove that removes any or all of the software packages that are a part of BX PRO. The remove script is in the top-level directory of the CD distribution.
Running the remove Script
To run remove, follow these steps:
- Log in as root.
- Mount the CD as appropriate for your platform. If you are unsure how to do this, consult your system administrator.
- cd to the mount directory.
- Run ./remove.
You are prompted for the name of the directory in which the software to be removed was installed:
- Enter directory of ICS product you wish to remove:
The remove script examines the directory to create a list of ICS products to remove. You are asked to confirm the removal of each product in turn.
- Do you want to remove the product `product_name' [Yes/No]?
When finished, the script displays the following message.
Product `product_name' has been uninstalled.
ICS Support
Types of Support
When you purchase an ICS product, you receive technical support for one year. Technical support includes the following:
- Hotline Support: Ensures that you successfully install your ICS product. Also provides expert assistance with programming and usage problems.
- Online Support: Provides access to our FAQ (Frequently Asked Questions), mailing lists, and other products on our website.
- Major and minor updates to your software.
Hotline Support
Use the telephone, Fax, or e-mail to make the following requests or reports:
- Request keys, a basic requirement to enable the full functionality of Builder Xcessory. Please have all necessary information ready.
- Request installation and configuration assistance, to help you get a product loaded from the installation media and functioning on your system. We believe our installation process is quick and easy, but if you should have problems, we're here to help.
- Request help with resolving problems or workarounds.
- Report bugs or suggest enhancements. If you discover a bug or want to suggest an enhancement, you are encouraged to submit it to ICS, and we will acknowledge receipt and give you a way to refer to your report in future communications. We do not guarantee a resolution.
- Request status on incidents previously reported.
Support hours
ICS Installation Support is available on standard business days from 9:00 a.m. to 6:00 p.m. ET. While we do not guarantee response time, a telephone call normally will be answered by a member of ICS Support staff, and an ICS engineer will respond within a few hours. Electronic mail messages receive an automated acknowledgment.
Support contacts
To contact ICS, use one of the following methods:
| Method | Number or Address |
|---|---|
| Telephone | (617) 621-0060 |
| Fax | (617) 621-9555 |
| E-mail (installation help) | support@ics.com |
| E-mail (bug reports) | bx-bugs@ics.com |
| Website | http://www.ics.com/ |
Support number
Please supply your support number when you contact us. The support number is attached to the reply card with your shipment and to the media you have purchased.
Note: We assume you have a basic understanding of software installation on your system, and a general knowledge of how the X Window System works.
Online Support
ICS Online Support is available to all customers.
Website
ICS provides access to a database of Frequently Asked Questions on our website:
From our home page, just follow the hypertext links. Suitable browsers include Mosaic, Netscape (for the X Window System, Macintosh, or Windows), and Lynx (for non-graphical interfaces).
If You Need More
After one year, an ICS Hotline Support contract provides continued support from ICS engineers, including answers to product functionality and usage questions. If you would like continue receiving assistance from ICS, please ask your sales representative about ICS Hotline Support.
ICS Consulting Services are available for in-depth assistance beyond the scope of a Support contract. Again, please contact your sales representative for more information about ICS Consulting Services.