Go to the previous, next chapter.

Some Useful Tools

There are a number of useful goodies installed in the ftp area of dxsoft and a few examples of these are given in this chapter. On this machine you will find only a few of the most used utilities (mxrn, phone 3270 etc.) and some system management aids (such as monitor, top etc.). For any other public domain and CERN software (GNU, TeX, CERNLIB etc.) there is another service - the Application Software Installation Server (ASIS). Copies of the "ASIS Installer's Guide" (21) may be obtained from the machine "asis01" via anonymous ftp as shown below:

	   #ftp asis01
	   #Name (dxsoft.xxxxx): anonymous
	   #use your e-mail address as the password
	   #cd asis
	   #get ASIS-Installer.ps.Z
	   #quit
	   #uncompress ASIS-Installer.ps.Z

Copies of "ASIS Installer's Guide" guide may also be obtained from the User Consultancy Office (UCO) in building 513.

The convention is to install this software in a /usr/local file system. See section User Accounts, of this guide for some hints on how to create a new file system on your disk. You will need to log in as root or become superuser during the installation of these products.

Installing Binaries from dxsoft

In some cases you will find the binary files and the man pages are already available from the server. In this case just copy these files to the relevant directories on your machine. In all cases, whether simply copying the binaries or compiling the source files read the README files before starting. The following example shows how to copy the compiled phone command and man pages:

	   #cd /usr/local/bin
	   #ftp dxsoft
	   #Name (dxsoft.xxxxx): anonymous
	   #use your machine name as the password
	   #cd pub/phone/bin
	   #binary
	   #get phone
	   #lcd /usr/man/manl
	   #cd ../doc
	   #get phone.l
	   #quit
	   #chmod 755 /usr/local/bin/phone

Compiling the Source Files

The following are examples of how to copy and compile the source files for a few of the most popular utlities.

Usenet Newsreader

A version of a Usenet newsreader is available via ftp from the node dxsoft. The following describes the steps to follow in order to install either dxrn (for DECwindows) or mxrn (for Motif) on your workstation. For those who prefer it nn is also available via ftp from dxsoft in the directory pub/nn.

Go to the directory where you wish to keep the compressed files. One suggestion is that you create the directory /usr/local/kits for this purpose:
```
	   #cd /usr/local
	   #mkdir kits
	   #cd kits
```

Copy the kit from dxsoft:

	   #ftp dxsoft
	   #Name (dxsoft.xxxxx): anonymous
	   #use your machine name as the password
	   #cd /pub/xrn/src
	   #binary
	   #get dxrn.tar.Z
	   #quit

Go to the directory where you wish to put the source files:

	e.g. /usr/local/src/XRN

	   #cd /usr/local/src
	   #mkdir XRN
	   #cd XRN

uncompress and untar it but keep the compressed tar file:

	   #zcat /usr/local/kits/dxrn.tar.Z | tar xvf -

The Makefile will attempt to put the binary in /usr/local/bin and the man pages (if required) in /usr/man/manl. If these directories do not exist create them:
```
	   #cd /usr/man
	   #mkdir manl
	   #cd /usr/local
	   #mkdir bin
```
If you wish to specify different target directories modify the relevant Makefile.
The name of the news server has to be specified. This may be done in two ways:
Either create a directory /usr/local/lib/rn and put in it a file called server which contains the name of the server (dxcern), or add the following entries in the .Xdefaults of all accounts from which the newsreader will be started.
```
	   dxrn.nntpServer:    dxcern     (for DECwindows)

  or

	   mxrn.nntpServer:    dxcern     (for Motif)
```

Optionally add the following files to /usr/local/lib/rn:

    Filename          Contents 
    --------          -------- 
    domain            The internet domain name (.cern.ch)
    hiddenhost        The name of the  host to use as the users   
                      host name in the  "From" field  in a news   
                      article being  posted (e.g.  the  name of   
                      your machine or mail server).               
    organization      CERN, European Laboratory for Particle      
                      Physics                                     
    pathhost          The name of the host to use as the users    
                      hosts name in the "Path" field in a news    
                      article being  posted (e.g.  the name of 
                      your  machine or mail server).

Compile dxrn/mxrn: First of all make sure that you are in the directory that contains the source files:

      #cd /usr/local/src/XRN
                    
  For DECwindows: 
      
      #make install
	
  and                                                
      #make install-man            (if the man pages are
                                    to be installed.)
     
  For Motif Version 1.1.3:

      #make -f Makefile.motif113 install

  and
 
      #make -f Makefile.motif113 install-man (if the man pages are 
	                                           to be installed.)

NB: For previous versions of Motif use the file Makefile.motif.

Use the Customise/Applications Definitions option of the session manager to add dxrn (or mxrn if the version for Motif was compiled).

        Menu Item:         Menu Command: 
        dxrn               /usr/local/bin/dxrn

   or for Motif  

        mxrn		   /usr/local/bin/mxrn

Use the Customize/Application Menu of the session manager to add dxrn or mxrn.
The source and tar files are no longer required and you may wish to delete them in order to save disk space. Use the rm command to do this:
```
	   #cd /usr/local/src
	   #rm -r XRN
	   #rm /usr/local/kits/dxrn.tar.Z
```

3270 Terminal Emulation

Proceed as follows to install this program:

Go to the directory where you wish to keep the compressed files. One suggestion is that you create the directory /usr/local/kits for this purpose:
```
	   #cd /usr/local
	   #mkdir kits
	   #cd kits
```

Copy the kit from dxsoft:

	   #ftp dxsoft
	   #Name (dxsw02.xxxxx): anonymous
	   #use your email address as the password
	   #cd pub/3270
	   #ls           (to list which versions exist)
	   #binary
	   #get 3270vN.N.tar.Z     (where N.N is the version number
	                            e.g. 3270v3.4)
	   #quit

Go to the directory where you wish to put the source files:

	   e.g. /usr/local/src
              
	   #cd /usr/local/src

uncompress and untar it but keep the compressed tar file:
```
	   #zcat /usr/local/kits/3270vN.N.tar.Z | tar xvf -
```
The tar command will create the directory /usr/local/src/3270vn.n and place all the source files for the emulator in it.
Go to the directory 3270vn.n:
```
	   #cd 3270vN.N
```
Edit the Makefile to suit your environment. Note that the procedure requires that the following directories exist on your system. If they do not exist use the command mkdir to create them before continuing.
```
	   /usr/local/bin
	   /usr/local/lib/3270
	   /usr/local/lib/3270/options
	   /usr/var/adm/3270
	   /usr/man/manl 
```
Use the make command:
```
	   #make
```
If you are happy that everything has been compiled correctly, reissue the make command with the install option to move the various components to their target directories:
```
	   #make install
```
There is also a new version of termcap which you may which to copy in the place of the existing file. It will speed up the execution of the 3270 emulation. Be sure to save the current version first.
```
	   #cp /etc/termcap /etc/termcap.old
	   #cp /usr/local/src/termcap /etc/termcap
```
The source and tar files are no longer required and you may wish to delete them in order to save disk space. Use the rm command to do this:
```
	   #cd /usr/local/src
	   #rm -r 3270vN.N
	   #rm /usr/local/kits/3270vn.n.tar.Z
```

Phone

Go to the directory where you wish to keep the compressed files. One suggestion is that you create the directory /usr/local/kits for this purpose:
```
	   #cd /usr/local
	   #mkdir kits
	   #cd kits
```

Copy the kit from dxsoft

	   #ftp dxsoft
	   #Name (dxsw01.xxxxx): anonymous
	   #use your machine name as the password
	   #cd pub/phone/src
	   #binary
	   #get phone.tar.Z
	   #quit

Go to the directory where you wish to put the source files:

	   e.g. /usr/local/src/PHONE
	
	   #cd /usr/local/src
	   #mkdir PHONE
	   #cd PHONE

uncompress and untar it but keep the compressed tar file:

	   #zcat /usr/local/kits/phone.tar.Z | tar xvf -

The Makefile will attempt to put the binary in /usr/local/bin and the man pages (if required) in /usr/man/manl. If these directories do not exist create them:
```
	   #cd /usr/man
	   #mkdir manl
	   #cd /usr/local
	   #mkdir bin
```
If you wish to specify different target directories modify the Makefile.
Use the make command:
```
	   #make
```
If you are happy that everything has been compiled correctly, reissue the make command with the install option to move the various components to their target directories:
```
	   #make install
```
The source and tar files are no longer required and you may wish to delete them in order to save disk space. Use the rm command to do this:
```
	   #cd /usr/local/src
	   #rm -r PHONE
	   #rm /usr/local/kits/phone.tar.Z
```

Less

Go to the directory where you wish to keep the compressed files. One suggestion is that you create the directory /usr/local/kits for this purpose:
```
	   #cd /usr/local
	   #mkdir kits
	   #cd kits
```

Copy the kit from dxsoft:

	   #ftp dxsoft
	   #Name (dxsw02.xxxxx): anonymous
	   #use your machine name as the password
	   #cd /pub/less/src
	   #binary
	   #get less.tar.Z
	   #quit

Go to the directory where you wish to put the source files:

	e.g. /usr/local/src/LESS                                         
                                                                     
	   #cd /usr/local/src
	   #mkdir LESS
	   #cd LESS

uncompress and untar it but keep the compressed tar file:

	   #zcat /usr/local/kits/less.tar.Z | tar xvf -

The makefile will attempt to put the binary in /usr/local/bin and the man pages (if required) in /usr/man/manl. If these directories do not exist create them:
```
	   #cd /usr/man
	   #mkdir manl
	   #cd /usr/local
	   #mkdir bin
```
If you wish to specify different target directories modify the makefile.
Use the make command:
```
	   #make
```
If you are happy that everything has been compiled correctly, reissue the make command with the install option to move the various components to their target directories:
```
	   #make install
```
The source and tar files are no longer required and you may wish to delete them in order to save disk space. Use the rm command to do this:
```
	   #cd /usr/local/src
	   #rm -r LESS
	   #rm /usr/local/kits/less.tar.Z
```

Go to the previous, next chapter.