GAMS 2.50 Installation and System Notes for UNIX
INSTALLATION 4. If you received the system in the form of diskettes or tapes, load all the tapes or diskettes at this point. The To install a complete system, follow the steps below as system is normally stored on diskette or tape in tar for- closely as possible. We advise you to read the whole instal- mat. In most cases, the following command is suf®cient lation procedure before beginning the installation procedure: to load a tape: tar xv. If reading from other than the default device, use 1. Choose a location for the GAMS system directory (the tar xvf /dev/device_name directory where the GAMS system ®les should reside). The total GAMS system may use up to 20 MB. The com- mand df will tell you how much disk space is available where device name is the name of the device. Some on each ®le system. If the directory where you want commonly used names are rfd0 for diskettes, and rst0, to install GAMS is not below your home directory, you rst1, rmt0 and rmt1 for tapes. may need to have super-user privileges on the machine. 5. Make sure you have execute permission set on the ®les 2. Create the GAMS system directory, for instance gamsinst and gamsunpack If you are not sure how to do /usr/gams/bin. Go to this directory. Make sure pwd this, just type in the command returns the name of this directory correctly. chmod 755 gamsinst gamsunpack 3. Transfer the distribution ®les into the GAMS system di- rectory. These ®les may be obtained in a number of 6. Check if the ®le gamslice.txt exists in the GAMS sys- ways, but regardless of how you get them, they should tem directory. If you have a licensed (professional or all be put into the GAMS system directory at this time. If evaluation) version of GAMS, a license ®le is required you have a GAMS CD, ®rst mount the CD. Usually you to solve large models. If a licensed system is shipped on will need to be logged in as root to do this. We assume tape, the license ®le is put on the tape and should already you want to mount the CD over the directory /cdrom. If exist. CD and diskette distributions come with a license the directory you want to mount over does not exist, you diskette; use the tar commands above to extract the li- must create it now. Once this directory is created, mount cense ®le to the GAMS system directory. Some license the CD, using the appropriate command.The correct ar- ®les are sent via email. As a last resort, the license may guments for the mount command vary from machine to have been sent on paper and must be typed in by hand. machine. Some examples are given below: If no license ®le is present, GAMS will still function in demonstration mode and can only solve small prob- SunOS 4.x: mount -r -t hsfs /dev/sr0 /cdrom lems. For example, student and demonstration systems Solaris 2.x: mount -F hsfs -o ro /dev/sr0 are sent without a license ®le. A license ®le can easily /cdrom be added later and gamsinst rerun, so if you cannot ®nd HP-UX: mount /dev/dsk/devicename /cdrom -r a license ®le, you can safely proceed without one. -t cdfs 7. Run the program gamsinst. This will unpack ®les if (where devicename is the name of the CD device) necessary and put the proper directory name into the AIX: mount -v cdrfs -r /dev/cd0 /cdrom gams and gamslib script ®les. It will also prompt the IRIX: mount -dr -t cdfs -o setx user for default solvers to be used for each class of mod- /dev/scsi/sc0dnl0 /cdrom els. If possible, choose solvers you have licensed since (where n is the SCSI target of the CD device) unlicensed solvers will only run in demonstration mode. These solver defaults can be changed by: Digital Unix: mount -dr -t cdfs -o rrip /dev/rz4c /cdrom (a) rerunning gamsinst and resetting the default val- Linux: mount -t iso9660
enable or change a CPLEX license, you need to run a set path = (/your/previous/path/setting ) CPLEX speci®c license pro-gram after completing the set path = ( $path /usr/gams/bin ) # new standard GAMS installation. Please refer to the annex on licensing in the CPLEX section of the Solver Man- Those using the Bourne (sh) or Korn (ksh) shells and ual for details. their variants can modify their .profile ®le by adding the second of the three lines below: 9. Add the GAMS system directory to your path (see `AC- CESS TO GAMS' below). PATH=/your/previous/path/setting PATH=$PATH:/usr/gams/bin # new 10. To test the installation, login as a normal user and run a export PATH few models from a directory other than the GAMS sys- tem directory. You should logout and login again after you make any changes to your path, unless you make the same changes LP: $ gamslib trnsport locally in a shell. $ gams trnsport $ more trnsport.lst 2. You may prefer to alias the names of the shell scripts optimal solution: 153.675 instead of adding to the path as described above. C shell NLP: $ gamslib chenery users can use the following commands on the command $ gams chenery line or in their .cshrc ®le: $ more chenery.lst optimal solution: 1058.9 alias gams /usr/gams/bin/gams alias gamslib /usr/gams/bin/gamslib MIP: $ gamslib bid alias gamsbatch /usr/gams/bin/gamsbatch $ gams bid $ more bid.lst optimal solution 15210109.512 The correct Bourne or Korn shell syntax (either com- mand line or .profile) is: MINLP: $ gamslib procsel $ gams procsel alias gams=/usr/gams/bin/gams $ more procsel.lst alias gamslib=/usr/gams/bin/gamslib optimal solution: 1.9231 alias gamsbatch=/usr/gams/bin/gamsbatch MCP: $ gamslib scarfmcp $ gams scarfmcp Again, you should logout and login again in order for $ more scarfmcp the alias settings in .cshrc or .profile to take effect. This model type has no objective function. 3. Casual users can always type the full name of the script. MPSGE: $ gamslib scarfmge $ gams scarfmge For example, $ more scarfmge /usr/gams/bin/gams trnsport This model type has no objective function.
Technical problems: For any technical questions like in- 11. If you move the GAMS system to another directory, re- suf®cient disk space, CPLEX licensing problems or solver member to rerun gamsinst. It is also good practice to failures please check the GAMS web sites or contact our sup- rerun gamsinst when you add or change your license ®le port staff directly. if this has changed the set of solvers you are licensed to run.
ACCESS TO GAMS
To run GAMS you must be able to execute the GAMS C shell scripts located in the GAMS system directory. There are sev- eral ways to do this. Remember that the GAMS system direc- tory in the examples below may not correspond to the direc- tory where you have installed your GAMS system.
1. Those using the C shell (csh) and its variants can mod- ify their .cshrc ®le by adding the second of the two lines given below: Ð In case of problems, please contact GAMS Development Corporation by email at [email protected], by telephone at (202) 342-0180, or by fax at (202) 342-0181. Make sure that you have pen and paper available to make notes, and if possible, sit in front of the machine when you call.