Qedit Pre-Release
Installation Instructions

You may want to print this page, for reference.

FTP upload of binary file to HP-UX

Once you have downloaded the binary file to your PC, you need to upload it to the HP 9000.

Please note that the file you downloaded ended in a .Z, however, some browsers especially IE will try and help you and rename file file to be .tgz. Simply rename the file back to .Z when you upload the file or after you upload to your server.

Using your favorite FTP utility, connect as root, and use a binary transfer to PUT the file to the HP-UX server.

Microsoft Windows XP [Version 5.1.2600]
(C) Copyright 1985-2001 Microsoft Corp.
C:\Download>ftp dev.robelle.com
Connected to dev.robelle.com.
220 HP ARPA FTP Server 
User (dev.robelle.com:(none)): root
31 Password required for root.
Password:
230 User root logged on
ftp> binary
200 Type set to I.
ftp> cd /tmp
ftp> put qxpre.Z
ftp> quit
221 Server is closing command connection

The .Z problem

Some ftp clients do not preserve the case in the filename and end up upshifting or downshifting the filename depending on the settings of your ftp client. Some customers have ftp'ed the qxpre.Z file only to end up with the filename as qxpre.z.

This impacts our installation, as compress does not find the file to decompress; or worse, if a file of the same name exists that does have the capital Z at the end, then that (typically older) file is used and you end up installing an older version.

To insure that the following steps work properly please double check that the file you just ftp'ed is placed on the server with the proper name and has a .Z (dot Capital Z) and not the small ".z". You can always rename the file with the .z over top of the file with the .Z with the following:

mv qxpre.z qxpre.Z

Preparing for Install

Backup the Account (Optional)

You can save your current files in the /opt/robelle account using the following steps.

Logon as root.
su -
tar cvf robbackup /opt/robelle/*

Check Your Codes

Before proceeding you should insure that the CPU Id codes that we send match the CPU/SPU-id for your machine. Please note that we sometimes use the term CPU-ID, SPU-id and HPSUSAN to mean the same thing. When you receive codes from Robelle they typically look like this:
(Please note that the following codes are not valid)

Extend codes to add CPU Id 999999999
                 and Model L3000800/A400-44
Product Verification Code:  111111111
        Verification Code:  222222222
        Verification Code:  333333333

You can determine your CPU-ID/SPU-ID with the uname command.

uname -i
999999999

Make sure Qedit is not Running

In order to install Qedit for HP-UX you must be sure that no one else is accessing and that the Qedit server is not running. You can check this normally with a:

	ps -ef | grep qedit

If any copies of Qedit are running you will need to insure that the users save their files and if you have the Qedit server daemon running you will need to kill that process once the users have logged off and saved their files.

If the server is running you would likely see:

	ps -ef|grep qedit
    root 14368     1  0 13:30:13 ?         0:00 ./qedit -d

You would need to kill the process associated with the server. If you don't see the qedit -d you are not running the server option. Please note that you would need to restart the server once the new version has been installed. You can find information on starting the server in the Qedit for Windows Change Notice

Installing the Software

The steps in installing the software are simply:

Restore the files.
Apply the license codes.

Restore the files

Logon as root.

su -
cd /tmp

Decompress the download:

compress -d qxpre

Create the directory where the Qedit files will reside. Obviously if the directory already exists then there is no need to make the directory.

mkdir /opt/robelle

Unpack the Robelle files:

cd /opt/robelle
tar xvf /tmp/qxpre

Wait to be contacted by Robelle with the authorization codes.

Apply the license codes

Once you get the codes you can apply them:

cd /opt/robelle/bin
./extend
Product Verification code: n
Verification code: n
Verification code: n

You can now run Qedit and you should test that Qedit runs by doing:

/opt/robelle/bin/qedit

Cleanup

If Qedit runs and you like to keep things clean like we do, we recommend that you remove the tar file with:

	rm /tmp/qxpre

Checking Permissions

When signing on as root on a security hardened system and creating the robelle directory it may be that only the root user who can run whatever software you are installing.

You can tell a system that has been hardened typically with a umask command, which will return:

What ends up happening when you make a directory with mkdir is the permissions end up being 700 or rwx for root, --- for group, and --- for user. The solution to this is to change the permissions:

chmod -R 755 /opt/robelle

Setting up Environment Variables

If this is an upgrade then it is likely that all the environment variables have been setup and you can skip this section.

You can set up various environment variables to make running any of the Robelle products easier. The four variables that we recommend setting for Qedit are: SHLIB_PATH, 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.

ROBELLE, PATH and MANPATH

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, Korn and Posix Shells we recommend the following additions to the /etc/profile file.

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

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

Configuring different Shells

When you log on to HP-UX, a program is run called the shell. The shell program interprets commands, executes them, and controls command execution. Making configuration changes requires that you know which shell you are using and what files are automatically executed.

Bourne, Korn and Posix Shells

The Bourne, Korn and Posix shells execute the file /etc/profile when you log on to HP-UX. They then look for a file in your home directory called .profile. If it exists, it is executed. If you use SAM to add new users, the file /etc/d.profile is automatically copied to the home group of the new user. If you want to make global changes to the commands that are executed at login in time you typically have to make the changes to the /etc/profile file, and check that the /etc/d.profile (the file that becomes the users .profile file), does not counteract any of the changes that you have made to the global file, such as Path, Manpath or Robelle. You also have may have to warn existing Bourne and Korn shell users to change their .profile file in their home directories.

C Shell

The C shell executes the file /etc/csh.login when you log on to HP-UX. It then looks for the file .login in your home directory. If it exists, it is executed. Next, the C shell executes the file .cshrc in your home directory (also executed any time you invoke a new copy of /bin/csh). If you use SAM to add new users, the files /etc/d.login and /etc/d.cshrc are automatically copied to the home group of the new users. You may need to make changes to /etc/d.login and /etc/d.schrc, so that new users do not override your changes. You may also have to warn existing C shell users to change their .login and .cshrc files in their home directories.

Documentation

See the change notice for full documentation on the new release, including the setting of environment variables.

Qedit Pre-ReleaseInstallation Instructions