| SMR Home Page |
| About SMR |
| Products |
| Services |
| Documentation |
| Papers and Publications |
| Tutorials |
| Workshops |
| Miscellaneous |
This document describes how to obtain and install software from SMR. We assume a certain familiarity with basic UNIX commands.
Software from SMR is available to customers via the Internet from
the SMR software server. Upon request, CD's can be obtained from SMR,
too. The customer account on the SMR software server allows for
downloading and installing the licensed software(s). Downloading and
installaing software is performed with the
The following prerequisites are needed for installing SMR software with the SMR package manager:
You might have to consult your system administrator to make sure that access to the SMR software server via SSH is possible.
Prior to installation, you must decide where to install the software. All software contained in the packages will be copied to the directory called "installation prefix". We recommend the following installation prefixes:
| $HOME/local | Default proposed by the smrpm script. | |
| $HOME/local-smr | In case you have other programs in $HOME/local and you do not want to mix. | |
| /usr/local/smr | If you have root privileges and want to install the software for all users. |
Prior to installing software from SMR, you must obtain a valid license key file from SMR and install it on your system. If the license key file is not properly installed the installation procedure will not work and no software will be installed. For obtaining a license key file, please contact us in writing, by E-mail, or call us at +41 (0)32 3452121.
The license key file must be installed in your environment, and the environment variable SMR_LICENSE must contain the absolute path to the license key file. The SMR software installation procedure then checks whether this environment variable is set. If this is not the case, the SMR software installation procedure will print an error message and will fail.
Example: Install the license key file SMR_LICENSE_mylicensein a directory $HOME/licenses and define the SMR_LICENSE environment variable. In a bash shell environment, this would consist of the shell command
export SMR_LICENSE=$HOME/licenses/SMR_LICENSE_mylicenseThe above command has to be placed in one of the login files, such as $HOME/.bashrc.
You have obtained from SMR the username and password for the account on the SMR software server. Log in on the machine where the software will be installed and download the smrpm script:
prompt$ mkdir temp; cd temp prompt$ ssh username@c2.smr.ch smrpm_get > smrpm prompt$ chmod u+x ./smrpm
The first command line mkdir creates a temporary directory and changes the current working directory to that temporary directory. The second command downloads the smrpm script from the SMR software server. The last command set the execute permission on the smrpm script.
You need to have the environment variable SMR_LICENSE set to point to the license file. smrpm checks whether this environment variable is set. If this is not the case, smrpm will print a warning together with instructions how to set this variable.
The next step is to install a package over the net. The general command is
prompt$ ./smrpm -s username@c2.smr.ch -i xxx
where xxx is the name of the package to be installed and username your user name. Note that smrpm automatically selects the correct platform and the dependent packages will automatically be installed. smrpm copies the packages from the SMR server to the current local directory and leaves the packages after having performed the installation. The packages can be removed with
prompt$ rm *.smprmor they can be kept for local installation (see ./smrpm --help for instructions).
The examples below list the installation commands for some of the SMR packages.
To install baspl++, type
prompt$ ./smrpm -s username@c2.smr.ch -i baspl++
To install the MemCom 7 libraries, type
prompt$ ./smrpm -s username@c2.smr.ch -i MEMCOM-7
To install the MemCom 7 libraries and the MemCom tools, type
prompt$ ./smrpm -s username@c2.smr.ch -i pymcbrowser
Once smrpm script is started, it will ask you for the installation prefix, proposing $HOME/local. Enter your desired installation prefix. Then it will ask for the execution prefix. This is usually the same as the installation prefix. Just press the <enter> key.
You need to set two additional environment variables in order to execute SMR software: PATH and LD_LIBRARY_PATH (or one of LD_LIBRARY32_PATH, LD_LIBRARY64_PATH or SHLIB_PATH depending on the system). smrpm checks if these environment variables are set correctly. If this is not the case, smrpm will print instructions on how to set the environment variables.
smrpm downloads and installs the required packages from the SMR software server. It will automatically choose the right packages for your platform and operating system's version and it will resolve any dependencies, i.e. it will install or update all packages required for any given package.
Depending on the speed of your Internet connection, the download and installation process may take a few minutes. The installation process is successful if no errors are printed, that is, smrpm terminates with something like:
Ok: Package PyOpenGL-2.0.0.44--i686-pc-linux-redhat-9 installed. Ok: Package baspl++-1.1.5--i686-pc-linux-redhat-9 installed.
In case of errors, please send the smrpm.log file generated by the smrpm script to <bug-smrpm@smr.ch>.
If you have not done so already, make sure that the PATH and LD_LIBRARY_PATH are set properly (see above).
To test baspl++ visualization software, launch
prompt$ baspl++ -t -d
On the terminal window, type:
>>> Scene()
This will create a new Scene object, which is a window where meshes will be displayed. If the Scene window appears, then baspl++ is installed correctly and OpenGL 3D graphics support is functional.
To test the MemCom database manager, including the Python interface and the database browser: Launch the Python interpreter and create a small MemCom database with
prompt$ python
>>> import memcom
>>> db = memcom.db('test.mc', 'rw')
>>> db['A1'] = [1, 2, 3]
>>> db['B'] = [4.0, 5.0, 6.0]
To terminate the Python interpreter, press CTRL-D. Inspect the newly created database with the MemCom browser:
prompt$ mcbrowser test.mcThis should display the contents of the database.
Documentation is installed together with the software. All documentation is available in HTML, and most of the documentation is also available in the Portable Document Format (PDF).
Enter the following URL in your web browser (replace $PREFIX by the chosen installation prefix):
file:///$PREFIX/local/share/doc/SMR-index.html
The smrpm script has the capability for semi-automatically updating the installed packages. To updating all installed packages, log in on the machine where the software will be updated and execute the following commands:
prompt$ mkdir temp; cd temp prompt$ ssh username@c2.smr.ch smrpm_get > smrpm prompt$ chmod u+x smrpm prompt$ ./smrpm -s username@c2.smr.ch -ua
smrpm copies the packages from the SMR server to the current local directory and leaves the packages after having performed the installation. The packages can be removed with
prompt$ rm *.smprmor they can be kept for local installation (a summary of the command options is obtained with ./smrpm --help).
For help, or for submitting bug reports and comments, please send mail to support@smr.ch or contact us by telephone at +41-32-3452121.