Installing Qedit/ix Pre-Release Tape

Installing other tape types...

Introduction If you are a new Qedit/UX user, please follow the installation instructions in the Qedit User Manual. To install this upgrade of Qedit, follow these steps:

1. You must log on as root.
2. Create the correct directory structure.
3. Restore Qedit/UX and its associated files from the distribution tape.
4. Set up variables to let Qedit know where some of its supporting files are located.
5. Set up a link between /var/tmp and /usr/tmp if you are installing on HP-UX 10..x.
6. If you have the Qedit for Windows server, you need to start the daemon process. (optional)

The installation should take about half an hour, during which time no one can use Qedit. The following instructions apply to existing Qedit users who are installing a new pre-release version. The whole process should take about 30 minutes, assuming that no one is using Qedit or any of its components.

Installation Assistance

If you have any questions or run into any problems, please call us. Technical support is available on weekdays from 7 a.m. to 4 p.m. Pacific time at 1-800-453-8970.

Combined Qedit/Suprtool Tapes

If the tape you received has more than one product on it (e.g., Qedit and Suprtool), you can take a shortcut instead of following the complete instructions for both products. Steps that are common to both installations need only be done once. That is, there is no need to restore twice, or setup the Robelle account twice, or install the Qlib and Bonus programs twice, or clean up unneeded files twice. Note that if you do not use this shortcut it is not a problem; it will just take you a few minutes longer, and you will have to mount the restore tape a second time. Say you install Qedit first, followed by Suprtool:

1. Do all of the Qedit steps, except for the final Purge Installation Files step.
2. Then do the Suprtool installation starting with the :stream Install.Suprjob step. Skip the initial Restore and Robelle Accoount steps, and skip the Qlib/Bonus step. Do the final Purge Installation Files step.

Step 1: Log On as Root

There are two ways you can log on as root:

1. Exit from HP-UX and log on with root as the user name.
2. If you are already logged on, you can execute this command:

   su -
   

   In either case, you have to know and supply the user password for root.

   Step 2: Create Robelle Directory

   Before restoring files, you must first create the directory in which Qedit will reside:

   mkdir /opt/robelle
   

   Step 3: Restore Files

   Use the following command to restore the Qedit/UX files from the distribution tape:

   tar xv /opt/robelle
   

   This command assumes your tape device is /dev/rmt/0m. If it is not, you need to specify your tape device using the "f" option in the tar command. For example, if your tape device is /dev/rmt/1m, you need to use the following command to restore the files: tar xvf /dev/rmt/1m /opt/robelle

   Step 4: Setting Up Variables

   You can set up numerous variables to make running any of the Robelle products easier. The three variables that we recommend setting are ROBELLE, PATH and MANPATH.
   • The ROBELLE variable tells the Robelle products where it's supporting files are located.
   • The PATH variable, when set, allows the user to run Qedit by just typing "qedit" instead of the fully qualified program name.
   • The MANPATH variable, when set, allows users to access the manpage (Help page) for Qedit.
   You can invoke Qedit with the following command:

   /opt/robelle/bin/qedit
   

   The easiest way to add variables accessible to all users is to set the variables in the global exec file for the shell you use.

   For the Bourne and Korn Shells we recommend the following additions:

   export ROBELLE=/opt/robelle
   export PATH=$PATH: $ROBELLE/bin
   export MANPATH=$MANPATH: $ROBELLE/man
   

   Remember to delete any PATH or MANPATH settings in /etc/d.profile, so that new users do not override your changes. You also have to warn existing Bourne and Korn shell users to change their .profile file in their home directories. For the C Shell we recommend that you add the following commands after any existing PATH or MANPATH statements in the /etc/csh.login file:

   setenv ROBELLE /opt/robelle
   set path=($path $ROBELLE/bin)
   setenv MANPATH "$MANPATH": $ROBELLE/man
   

   Remember to delete any PATH or MANPATH settings in both /etc/d.login and /etc/d.schrc, so that new users do not override your changes. You also have to warn existing C shell users to change their .login and .cshrc files in their home directories.

   Step 5: Setting Up Links

   When you run Qedit, it creates and uses certain temporary files. On HP-UX 10.x systems, temporary files are generally created in the /var/tmp directory. To get Qedit to keep an undo log and redo stack, you must set up a link between /usr/tmp and /var/tmp. To check whether this has already been done, enter

   ls -l /usr/tmp
   

   If a link exists, you will see a line such as this:

   lrwxrwxr-t 1 root sys    8 Aug 16  1996 /usr/tmp -> /var/tmp
   

   If the link is not set up, you can create it by entering

   ln -s /var/tmp /usr/tmp
   

   Step 6: Start the Qedit for Windows Server (optional)

   If you have the Qedit for Windows server software, you must start the Qedit/UX daemon process before any Qedit clients can connect to your HP-UX machine. To allow users to connect to the Qedit/UX daemon process, you must log on as root and issue this command:

   qedit -d
   

   The Qedit server process requires three log files. By default, these files are located in the following directory:

   /opt/robelle/log/qedit/
   

   If you have moved Qedit to a different directory, you will have to perform the following steps:
   1. Set the ROBELLE environment variable with the new directory name before you start the Qedit server process.
   2. Make sure the new directory has exactly the same structure as the /opt/robelle directory.