Solaris Installation Help

The software has been tested on Solaris8 and Solaris9 (sparc).

Some 3rd Party software may need to be installed in order to use all the
programs contained on this CD.

You may to need to know the "root" password for some tasks.

If you are not sure how to do any of the following tasks, ask your local systems administrator or contact EMAGE.

Installing Additional Solaris Packages

Installing Third Party Software

Installing MouseAtlas Software

Setting Environment Variables

Testing The Installation

Help With Mapping

Contact

Installing Additional Solaris Packages

The OpenGL libraries need to be installed to use the MouseAtlas software.

In Solaris8 (and 9) the OpenGL package is contained in the "Software Supplement CD". The Software Supplement CD contains various additional packages that are not on the standard installation disks. To install OpenGL, simply insert the CD, choose the OpenGL package from the list, and follow the installer instructions. The most uptodate version of OpenGL can also be downloaded from the Sun web site.

Installing Third Party Software

There are two 3rd party software packages that are very useful to manipulate and view image files - ImageMagick and netpbm. These are:-

1. Image Magick (http://www.imagemagick.org)

2. netpbm (http://sourceforge.net/projects/netpbm)

If these are not installed on your computer you should download and install them from the websites shown.

An easy way to find out if these packages are available on your system is to try the commands:-

"which convert" (for Image Magick)

"which ppmtopgm" (for netpbm)

If these return a valid pathname, rather than a "Command not found" message, the packages are already installed. See the example screen shot below.

Installing MouseAtlas Software

The Mouse Atlas software is in the Solaris directory on the CD-ROM.

It can also be downloaded as a compressed tar file from
ftp://ftp.hgu.mrc.ac.uk/pub/MouseAtlas/cd-soft/v2.0.0/Solaris/Solaris.tar.gz (42.6Mb)
Unzip and untar this file with a command like gunzip Solaris.tar.gz ; tar xvf Solaris.tar

Run the script "setupMA.ksh" from the Solaris directory to install the necessary MouseAtlas software.

By default the software installs in "/opt/MouseAtlas/bin" but this can be changed when prompted by the script.

To execute the installation script:-

1. Navigate to the Solaris directory on the CD. The full path may be different on different systems but will be something like /cdrom/mav2.0.0/Solaris

2. Execute the script. At the prompt type

./setupMA.ksh

You will need to have appropriate permission to create directories.

If necessary, execute the script as "root".

A successful installation will look like the example screen shot below.

Setting Environment Variables

The path to the MouseAtlas software needs to be set for the PATH variable.

For example, if the path is the default /opt/MouseAtlas/bin:-

For sh, ksh, bash shell add these lines to your .profile file

PATH=($PATH:/opt/MouseAtlas/bin)

export $PATH

For csh add this line to your .cshrc file.

set path = ($path /opt/MouseAtlas/bin)

For tcsh add the same line to your .tcshrc file.

set path = ($path /opt/MouseAtlas/bin)

Remember to restart any terminal sessions to pick up the new path.

Testing The Installation

If the above steps have been carried out successfully, you will now be able to start the software from the command line.

The "MAPaint" program should start like the example screen shot below.

Contact

If you need help with the CD-ROM please contact:-

ma-edit@hgu.mrc.ac.uk

MRC Human Genetics Unit
Western General Hospital
Crewe Road
Edinburgh
EH4 2XU, UK.

Phone +44 (0)131 332 2471