⟦ae2239b51⟧

TextFile

The R1000 portion of this release is installed as follows:

1. Traverse to !Machine.Release.Rational_Access.Rev0_5_0
2. Execute R1000_Install.  This will kill the Rational_Access User Interface
   job and then restore:
   
  !Machine.Editor_Data.Rational_Access@
  !Machine.Initialization.Rational_Access_User_Interface
                                                                 
3. Run Refresh_Terminal_Information to enable the new keymaps.


The workstation components must be installed so that they are integrated
with the X-Window system on your workstation and network. There are four
components:

1.   An executable program. This must be placed in an area where users will be 
able to invoke it via their search paths. The recommended location is /usr/
bin/X11. Make sure that the location you choose is available to your users. 
You may wish to provide a config.csh file that updates the search path as 
needed.

2.   Fonts used by Rational Access. These are supplied in ".bdf" form and can be 
used with any X Server. The fonts can either be added to an existing font 
directory (typically /usr/lib/X11/fonts/misc), or another directory of your 
choosing. When the X server runs, it needs to be able to access the fonts. 
They must be visible on the X font search path. You can use the xset com-
mand to add directories to the font search path. Other related commands 
include mkfontdir and bdftosnf.

3.   Application-default file. There are several files accessed using mechanisms 
defined by the X window system. A common set of parameters is defined in 
the file RATIONAL which must be placed in the application defaults directory. 
This is typically /usr/lib/X11/app-defaults. 

4.  A Help file and other parameter files are also placed in a
subdirectory Rational_Access of the app-defaults directory.

You must select a working directory to start the installation process.
The compacted file and installation script will be placed in this
directory (using FTP) by the R1000 installation tools. The workstation
installation script is run from this working directory.

You can complete the Rational Access installation by specifying that the
files be copied into their final destination and then delete the
working directory, or you can complete the installation by creating
symbolic links to the files in the working directory (in which case
the working directory is part of the permanent installation and must
remain).

There are several advantages to installing using symbolic links rather
than copies.  First, multiple versions can be kept online and the links
updated to point to the current version. Second, all components of
Rational Access are kept in one place and updates to them can be more
easily managed using Unix access control. Third, there is more
protection from problems that might be introduced when other parts of
the system are updated, backed-up, or restored.

There are a few disadvantages: system administrators must know where
Rational Access is located in the directory structure if it is to be
backed-up, restored, or copied to other machines. In addition, in an NFS
server environment, client machines must have the appropriate file
systems mounted for the symbolic links to be properly resolved.

There are two components for the installation of Rational Access: 
an R1000-resident part and a workstation-resident part.
The R1000 parts must be installed on each R1000 on which it is to run.
The workstation part must be installed on each workstation that is to
use Rational Access. If multiple workstations share a file server, the
installation can be placed on the shared file server.

The R1000 needs to be running Delta release 2.2 or greater.

You need to be running SUNOS version 4.1.1.           

You need MIT X.V11R3 or greater. X11R4 is preferable. This applies to
the server only. There are not dependencies on client libraries.
                                           
WORKSTATION INSTALLATION

On the workstation, create the directory (named Rev0_5_0) to be used for
the Rational Access installation.  For example, if you want to use
/vendor/rational/Rational_Access, execute the command:

  mkdir -p /vendor/rational/Rational_Access/Rev0_5_0
  
NOTE: The Rev0_5_0 directory must exist on the workstation before
      the files can be moved to the workstation.

On the R1000, traverse to !Machine.Release.Rational_Access.Rev0_5_0

Create a Command Window and run Workstation_Install with parameters for
your workstation: username, password, installation working directory.
The required files will be transferred using FTP. The workstation
directory must exist at this point. If it does not, log onto the
workstation and create it before running Workstation_Install.

 Workstation_Install
    (Release_Name => "Rev0_5_0", 
     Platform => "Sun",
     Target_Machine => "My_Workstation",
     Directory => "/vendor/rational/Rational_Access",
     Username => "Sysmanager",
     Password => "secret");


Then log onto the workstation. If you plan to modify directories to
which you do not have access then you must be superuser to complete the
installation. If installing on a server, make sure that the appropriate
filesystems are mounted read-write.

Run the command :

csh install_release

It will ask you questions about which directories files should be placed
in. Recommended defaults are provided and there are confirmation steps
for all operations.  See the sample interaction below.

If a user has problems with keys not seeming to send anything, there is
an Xmodmap script provided for Sun model 3 and Sun Model 4 keyboards.
Using these scripts should cause all defined keys to become usable.
If you have a type 4 keyboard execute: xmodmap XSun4-xmodmap for type 3
keyboards, execute: xmodmap XSun3-xmodmap.

Sample:

spock% ls

install_release rational.Z

spock% csh install_release

Unpacking rational.Z (takes about a minute)

Is the bin directory /usr/bin/X11? [y]

Do you want a link to rational in /usr/bin/X11? [y]

lrwxrwxrwx 1 root 46 Apr 2 23:33 /usr/bin/X11/rational 
-> /vendor/rational/Rational_Access/rational_access_0_5_0/rational

Put fonts in /usr/lib/X11/fonts/misc? [y]

Is the manual directory /usr/man/mann? [y]

Do you want a link to rational.man in /usr/man/mann? [y]

Are X11 application defaults in /usr/lib/X11/app-defaults? [y]

Should /usr/lib/X11/app-defaults/RATIONAL be a link? [y]n

Do you want RATIONAL copied to /usr/lib/X11/app-defaults? [y]

Do you want Rational Access defaults in
/usr/lib/X11/app-defaults/Rational_Access? [y]

Do you want links to this directory in
/usr/lib/X11/app-defaults/Rational_Access? [y]

RXI2 installation complete.

spock%
DataMuseum.dk

Rational R1000/400

⟦ae2239b51⟧ TextFile

Derivation

TextFile
