Contents
Previous
Next
IndexInstallation consists of two steps: extracting the files from the distribution archive, and running the Install program. Install configures script files for rchart (the diagram editor), dlmgr (the floating license manager), and some utility programs.
If you've purchased license keys, it's easiest to set them up first, since Install will ask you for their location. If you're just evaluating Robochart, you can skip ahead to the section on extracting files.
When you start the Robochart editor (rchart), it requests a license for the current display device from the license manager (daemon) program, dlmgr. The manager runs on your floating license server machine (whose hostname is defined in environment variable RCHT_SERVER). If the request fails (all licenses are in use, or the manager isn't running), a message is displayed to tell you that no license was found. Robochart then runs in demonstration mode, with the file save function disabled.
If network floating licenses have been purchased, an alphanumeric license key will be provided for the machine chosen to be the license server, in the form:
Robochartversion/hostname:key
where hostname is the network hostname of the license server
(this can be displayed with the command uname -n).
The first three characters of key indicate the number of licenses
available from the server. Add this line to the file /etc/licenses on
the server machine (create /etc/licenses if it doesn't already
exist). If you want to put the license key into a different file, enter
the pathname for your license file when prompted by the Install
program. Install will configure the dlmgr script to set the environment variable DLM_LICENSE to the name of this file before starting the license manager, and configure the rchart script to set the
server hostname in RCHT_SERVER.
The Robochart distribution archive is available at http://www.digins.com/rceval.html.
Create an installation directory for Robochart. Recommended locations are /opt/rchart (for SunOS 5.x) or /usr/local/rchart (for SunOS 4.x and Linux). You probably want to be logged in as root for this, although that isn't required. In fact, you can install Robochart in your home directory tree if you like. For example:
% mkdir /opt/rchart
Change to this directory, and use tar to extract the files from the distribution archive, e.g.:
% cd /opt/rchart
% gzcat /tmp/rchart.tar.gz | tar xvof -
Use your installation directory in place of /opt/rchart, and the appropriate location of the archive file. If you've received several archive files (e.g. manuals and documentation), they should all be extracted in the same top-level installation directory. If tar under SunOS4.x gives you file permission error messages, and you have write permission in the installation area, try using /usr/5bin/ustar instead.
The Robochart archive includes the following files, depending on the version:
Install - Robochart installation script Tutorial.cht - Sample/tutorial diagram document README - Late-breaking information and tips (text) index.html - Overview documentation (HTML) rchart.ps - PostScript header rchart.eps - Encapsulated PostScript header rchart.mif - Maker Interchange Format header rchart.plt - HPGL header rchart.info - On-line help text rcdiag.* - Diagram file icons for file managers rcfonts - Font definition file shapedef - Default object and arrow shape definitions cde/ - CDE icons (Solaris) man/ - On-line manual (nroff, HTML, PostScript, text) sun4.4/ - Sparc/SunOS 4.x executables sun4.5/ - Sparc/SunOS 5.x (Solaris) executables i86g/ - Linux/i86 glibc executables
The Install program prompts you for configuration options, then builds several script files in the installation directory. These scripts setup environment variables and invoke the appropriate executable file. To run the installation program, type (for example):
% cd /opt/rchart
% ./Install
Install also creates text file README.install, which shows how a user can add the Robochart directory to their binary and on-line manual directory search paths, and script rchelp, which displays the location of the installation area and gives basic information on getting help with Robochart. If you already have appropriate directories for all local binaries and man pages, you may prefer copying (or linking) the script files to these directories, so that user paths don't need to be changed. For example,
% cp rchart dlactive rcprint rchelp /opt/bin
% cp man/man1/*.1 /usr/local/man/man1
Users can override the installed configuration settings by defining environment variables before starting rchart. Environment variables are described in Section 10.
If you move or rename the Robochart installation directory, or change your licensing configuration, be sure to re-run Install.
If you have floating licenses, you can now enter the command dlmgr on the license server machine to start the license manager. You'll want this program to run automatically when the server is rebooted so that it's always ready to handle license requests from user nodes. Install can optionally configure your system to do this. If you'd rather do it manually:
The utility program dlactive can be run to display the user and display name for all active floating licenses. You can enter a server hostname as an argument to the dlactive command; otherwise, it will query the configured server.
If you are using different machines for your license server and application server, and want to install the license manager software in a separate directory from the application server's area, first do the full install on both machines. Then, you can free up most of the unnecessary disk space on the license server machine by removing that machine's copy of the man, cde, sun4.*/ow, sun4.*/m1.*, and i86g/m2.0 subdirectories.
You can add the following line to /etc/magic (/usr/share/magic in Linux) so that the file command will recognize Robochart documents:
0 string RCV Robochart diagram data
To install Robochart as a personal or system-wide CDE desktop application, so that it is available from the Application Manager and File Manager, see the file cde.txt. For instructions on teaching the OpenWindows file manager about Robochart documents, see the file binder.txt. To setup Robochart access from other tools, see access.txt.
To uninstall Robochart, remove the entire installed directory tree, plus any links you've added to your local binary and manual directories and to your system startup files.
Contents
Next
Index