2.2. Unix/Linux Platforms: Follow the steps below to complete the installation:
Step 1. For 32-bit Linux platforms, locate the:
LINGO-LINUX-IA32-12.0.tar.gz
file on your CD. Alternatively, if you are running a 64-bit version of Linux, then you can choose to install a 64-bit version of LINGO using:
LINGO-LINUX-64x86-12.0.tar.gz
Step 2. Copy this file into an installation directory of your choice (e.g. $HOME):
%> cp LINGO-LINUX-IA32-12.0.tar.gz $HOME
Step 3. Change the working directory to $HOME and uncompress the file using
the ‘gzip –d’ command as below. This operation creates LINGO-LINUX-IA32-12.0.tar (in the case of 64-bit versions, LINGO-LINUX-64x86-12.0.tar will be created).
%> gzip LAPI-LINUX-IA32-12.0.tar.gz
Step 4. Uncompress the tar file using the ‘tar –xvf’ command as below. This will create the LINGO directory lingo12/.
%> tar –xvf LINGO-LINUX-IA32-12.0.tar
Step 5. Go to the lingo12/bin/<PLATFORM> binaries directory and make sure all the files are in executable mode. If they are not, you should change their mode by typing
%> chmod 755 *
For 32-bit installations, the <PLATFORM> folder will be linux32/ and for 64-bit installations the folder will be linux64/.
Step 6. Update the LD_LIBRARY_PATH environment variable so that it also points to the LINGO binaries folder. It is assumed that the installation directory is $HOME/lingo12.
%> LD_LIBRARY_PATH=$HOME/lingo12/bin/<PLATFORM>:$LD_LIBRARY_PATH
%> export LD_LIBRARY_PATH
Step 7. Set the LINGO_12_HOME environment variable to point to the main LINGO folder. For example, if your installation directory is $HOME/lingo12, then the environment variable should be set as:
%> LINGO_12_HOME=$HOME/lingo12
%> export LINGO_12_HOME
You may also execute the shell script lingo12/bin/<PLATFORM>/lingovars.sh to perform the required updates on these environment variables. To execute this script manually, enter the following at command line
%> source $HOME/lingo12/bin/<PLATFORM>/lingovars.sh
Alternatively, to execute the script automatically at logon, append this line to the end of your startup script (.bashrc or .bash_profile for the bash shell).
Step 8. If you were provided a LINGO license file (look for a file called lndlng12.lic), then you should copy this file into the appropriate folder, e.g.: $HOME/lingo12/license/<PLATFORM>.
If you do not have a valid LINGO license file and you wish to create a demo license, then go to the lingo12 folder and run the create_demo_license script as follows:
cd $HOME/lingo12
sh create_demo_license.sh
A demo version of LINGO will run just as standard versions do, however, the maximum model capacity is restricted.
Step 9. You should now be able to run LINGO by entering 'lingo12' to a command prompt. 64-bit users should enter 'lingo64_12'. If the environment variables are not set up correctly, you will receive the following error message every time you start LINGO.
[Error Code: 171]
License key was not found or is invalid.
In this case, please refer to the steps above to be sure the required environment variables are set up correctly and that you have run the script to create a demo license.
Step 1. For 32-bit Linux platforms, locate the:
LINGO-LINUX-IA32-12.0.tar.gz
file on your CD. Alternatively, if you are running a 64-bit version of Linux, then you can choose to install a 64-bit version of LINGO using:
LINGO-LINUX-64x86-12.0.tar.gz
Step 2. Copy this file into an installation directory of your choice (e.g. $HOME):
%> cp LINGO-LINUX-IA32-12.0.tar.gz $HOME
Step 3. Change the working directory to $HOME and uncompress the file using
the ‘gzip –d’ command as below. This operation creates LINGO-LINUX-IA32-12.0.tar (in the case of 64-bit versions, LINGO-LINUX-64x86-12.0.tar will be created).
%> gzip LAPI-LINUX-IA32-12.0.tar.gz
Step 4. Uncompress the tar file using the ‘tar –xvf’ command as below. This will create the LINGO directory lingo12/.
%> tar –xvf LINGO-LINUX-IA32-12.0.tar
Step 5. Go to the lingo12/bin/<PLATFORM> binaries directory and make sure all the files are in executable mode. If they are not, you should change their mode by typing
%> chmod 755 *
For 32-bit installations, the <PLATFORM> folder will be linux32/ and for 64-bit installations the folder will be linux64/.
Step 6. Update the LD_LIBRARY_PATH environment variable so that it also points to the LINGO binaries folder. It is assumed that the installation directory is $HOME/lingo12.
%> LD_LIBRARY_PATH=$HOME/lingo12/bin/<PLATFORM>:$LD_LIBRARY_PATH
%> export LD_LIBRARY_PATH
Step 7. Set the LINGO_12_HOME environment variable to point to the main LINGO folder. For example, if your installation directory is $HOME/lingo12, then the environment variable should be set as:
%> LINGO_12_HOME=$HOME/lingo12
%> export LINGO_12_HOME
You may also execute the shell script lingo12/bin/<PLATFORM>/lingovars.sh to perform the required updates on these environment variables. To execute this script manually, enter the following at command line
%> source $HOME/lingo12/bin/<PLATFORM>/lingovars.sh
Alternatively, to execute the script automatically at logon, append this line to the end of your startup script (.bashrc or .bash_profile for the bash shell).
Step 8. If you were provided a LINGO license file (look for a file called lndlng12.lic), then you should copy this file into the appropriate folder, e.g.: $HOME/lingo12/license/<PLATFORM>.
If you do not have a valid LINGO license file and you wish to create a demo license, then go to the lingo12 folder and run the create_demo_license script as follows:
cd $HOME/lingo12
sh create_demo_license.sh
A demo version of LINGO will run just as standard versions do, however, the maximum model capacity is restricted.
Step 9. You should now be able to run LINGO by entering 'lingo12' to a command prompt. 64-bit users should enter 'lingo64_12'. If the environment variables are not set up correctly, you will receive the following error message every time you start LINGO.
[Error Code: 171]
License key was not found or is invalid.
In this case, please refer to the steps above to be sure the required environment variables are set up correctly and that you have run the script to create a demo license.