ASReml v3.00 Installation Notes ------------------------------- Platform: Intel x86 or AMD 32-bit based PC Operating System: Linux (32-bit) Limits: Max Workspace = 2000Mb Features: Interactive Graphics with hardcopy options EPS, WMF, JPG, HPGL, HPGL2, BMP, WPM Note this implementation produced under Red Hat Fedora Core 10, should be suitable for other similar Linux versions. Unlike ASReml 2.0 this version has been statically linked with Motif libraries, simplifying the installation process. Please contact support@asreml.co.uk in case of problems that arise. Files ----- The program is provided in a universal linux version. This should be suitable for most recent versions of Linux. It has been successfully tested on many systems, including versions of Fedora from Fedora Core 6 and upwards. The files are contained in a compressed download as follows: asreml-3.xvv-linux-32.tar.gz where the letters 'x' and 'vv' are replaced by the sub-version and build letters of the software. The initial release in 2009 was formed from ASReml 3.0fl, i.e. x=0 and vv="fl". Small incremental changes to the sub-version may occur during the lifetime of this software, principally to correct bugs that arise in use. The tar archive contains a number of files, some of which are common to all versions and the executable program which is specific to the target system. The contents of the archive is as follows: bin\asreml.sh shell script to invoke the program bin\asreml-3.xvv-32 executable image file, ASReml version 3.x, build vv bin\RequestLicense a tool to generate a license request bin\myowngdg.f90 example Fortran source for OWN variance structure doc\ASReml.htm HTML Help files (view in normal browser) doc\UserGuide.pdf Principal source of reference doc\UpdateR3.pdf Description of changes since version 2.00 doc\pedigree.pdf Description of pedigree options examples\*.* Data and input files for examples contained within the User Guide Installation ------------ 1. Create a directory to hold ASReml v3. The suggested location is: /usr/local/asreml3 which will require root privilege. Alternatively, you can install the software in personal file space, e.g. $HOME/asreml3 2. Copy the appropriate version of the ASReml archive file from the CD-ROM directory ASReml/linux, or download it from http://www.vsni.co.uk. Then extract the files to the directory /usr/local/asreml3. It should create subdirectories with contents as listed above. The commands required are of the form gunzip linux-32-3.0fl.tar.gz tar xf linux-32-3.0fl.tar 3. This step can be ignored if you have installed to /usr/local/asreml3. If you have installed to another location you need to edit the asreml.sh script to set the appropriate path name for ASREML_DIR, the ASReml home directory. 4. The asreml.sh script should be used to invoke the program as it sets up various environment variables required by ASReml. To make it easily available, copy to an appropriate location or create a link to the file, e.g. in /usr/local/bin: ln -s /usr/local/asreml3/bin/asreml.sh /usr/local/bin/asreml You are now ready to install a license key. If you have a license key for ASReml 2.0 it may also be valid, depending on whether you have maintained support on the software. You should check the FEATURE line to see if the version number is 0910 or greater. For example: FEATURE ASReml VSN 0912 ........ If so you can just copy the ASReml 2 license file (asreml.lic) into /usr/local/asreml3/bin. If you need to renew your license, or need to activate ASReml for the first time, you can run the RequestLicense application which is located in the bin directory. Just type: /usr/local/asreml3/bin/RequestLicense and follow the instructions that appear. You will have the choice of online registration or saving to a file which can then be sent via email. Licensing --------- A summary of FLEXnet licensing as used within ASReml is given in the ASReml HTML help files. Open doc/ASReml.htm in your browser and read the relevant section of the volume entitled "ASReml License Management". Support ------- Any errors, omissions, or other problems should be reported to: support@asreml.co.uk