Mario Valle Web

STM4 – installation

The kit contains a precompiled STM4 version. If you need to recompile STM4 (eg. to add your modules) follow the instructions at the end of this page.

Look at the download page for the kit location.

Linux installation

  1. Install AVS/Express V7.2.1 from your Linux distribution
  2. Make sure the following environment variables are defined:
    XP_ROOTpoints to the AVS/Express installation directory (here called <xp_dir>)
    MACHINEdefined as linux
    LANGen_US (define only if you have problems with the user interface labels)
    LD_LIBRARY_PATHmust contains <xp_dir>/lib/linux
    PATH must contains <xp_dir>/bin/linux
  3. Copy your license file license.dat to <xp_dir> or define XP_LICENSE_SERVER as <host>:<port> (see your system manager)
  4. Check the AVS/Express installation by executing express from the command prompt
  5. cd somewhere, but not under <xp_dir>
  6. Get the STM4 kit called CSCSlib-bin.tar.gz
  7. Unpack the STM4 kit: tar xvzf CSCSlib-bin.tar.gz
    The resulting directory will be named CSCSlib
  8. Edit the CSCSlib/avsenv file changing the CSCSlib install location (/home/mvalle/CSCSlib) to yours. The affected lines starts with: MSMSSERVER and XP_PATH
  9. Execute the customized AVS/Express running ./go If there are problems with your OpenGL support try: ./go -nohw
  10. The STM4 modules are under the STM4 library. Prepackaged applications are under "Full Apps" sublibrary.

Special note for Linux Red Hat EL3: you should install as written above, then define MACHINE as linux_el3 and rename the linux directories under lib, bin and include from linux to linux_el3

Windows PC installation

  1. Install AVS/Express V8.0 from your Windows distribution. Be sure to install the version that supports VC++ 10
  2. Make sure the following environment variables are defined:
    XP_ROOTpoints to the AVS/Express installation directory (here called <xp_dir>)
    MACHINEdefined as pc10
    PATH must contains <xp_dir>\bin\pc and <xp_dir>\runtime\bin\pc
  3. Copy your license file license.dat to <xp_dir> or define XP_LICENSE_SERVER as <host>:<port> (see your system manager)
  4. Check the AVS/Express installation by executing express from a command window
  5. Get the STM4 kit called CSCSlib.zip
  6. Unpack the STM4 kit using, for example, WinZip. The resulting directory will be named CSCSlib. Don't unpack under <xp_dir>! If you unpack it under C:\ skip the following two steps.
  7. Edit the go.bat (or go-viz.bat if you have AVS/Express Visualization Edition) launcher file and edit the following line: 
        set XP_ROOT=C:\express
    Changing C:\express to your AVS/Express installation directory (here called <xp_dir>)
  8. Edit the CSCSlib\avsenv file changing the CSCSlib install location (C:\CSCSlib) to yours. The affected lines starts with: MSMSSERVER and XP_PATH
  9. Execute the customized AVS/Express running go.bat
    If you have AVS/Express Visualization Edition run instead go-viz.bat
  10. The STM4 modules are under the STM4 library. Prepackaged applications are under "Full Apps" sublibrary.

Mac installation

  1. Install AVS/Express V7.1 from your Mac distribution and remember to install also OpenMotif 2.2
  2. Make sure the following environment variables are defined:
    XP_ROOTpoints to the AVS/Express installation directory (here called <xp_dir>)
    MACHINEdefined as darwin
    DYLD_LIBRARY_PATHmust contains <xp_dir>/lib/darwin (and the path to your OpenMotif lib directory)
    PATH must contains <xp_dir>/bin/darwin
  3. Copy your license file license.dat to <xp_dir> or define XP_LICENSE_SERVER as <host>:<port> (see your system manager)
  4. Start the X server (under Applications/Utilities). The server should be started every time you use AVS/Express or STM4.
  5. Check the AVS/Express installation by executing express from the command prompt
  6. cd somewhere, but not under <xp_dir>
  7. Get the STM4 kit called CSCSlib-darwin.tar.gz
  8. Unpack the STM4 kit: tar xvzf CSCSlib-darwin.tar.gz
    The resulting directory will be named CSCSlib
  9. Edit the CSCSlib/avsenv file changing the CSCSlib install location (/Users/mvalle/CSCSlib) to yours. The affected lines starts with: MSMSSERVER and XP_PATH
  10. Execute the customized AVS/Express running ./go If there are problems with your OpenGL support try: ./go -nohw
  11. The STM4 modules are under the STM4 library. Prepackaged applications are under "Full Apps" sublibrary.

SGI installation

  1. Install AVS/Express V7.1 64bits from your SGI distribution
  2. Make sure the following environment variables are defined:
    XP_ROOTpoints to the AVS/Express installation directory (here called <xp_dir>)
    MACHINEdefined as sg6
    LANGen_US (if you have problems with the user interface labels)
    LD_LIBRARY_PATHmust contains <xp_dir>/lib/sg6
    PATH must contains <xp_dir>/bin/sg6
  3. Copy your license file license.dat to <xp_dir> or define XP_LICENSE_SERVER as <host>:<port> (see your system manager)
  4. Check the AVS/Express installation by executing express from the command prompt
  5. cd somewhere, but not under <xp_dir>
  6. Get the STM4 kit called CSCSlib-src.tar.gz
  7. Unpack the STM4 kit: tar xvzf CSCSlib-src.tar.gz
    The resulting directory will be named CSCSlib
  8. Rename avsenv-sgi to avsenv
  9. Edit the CSCSlib/avsenv file changing the CSCSlib install location (/home/mvalle/CSCSlib) to yours. The affected lines starts with: MSMSSERVER and XP_PATH
  10. Recompile the toolkit executing: 
    ./regen-sgi
    from inside the <xp_dir> directory.
  11. Execute the customized AVS/Express running ./go If there are problems with your OpenGL support try: ./go -nohw
  12. The STM4 modules are under the STM4 library. Prepackaged applications are under "Full Apps" sublibrary.

Rebuild STM4 on Linux

  1. If you have NVIDIA graphic card, and want to recompile STM4, install also the nvidia_patch.tar.gz patch from the AVS ftp site.
  2. Recompile the toolkit executing: 
    ./regen or ./regen-debug
    from inside the <xp_dir> directory.
  3. On Linux 64bits recompile the toolkit executing: 
    ./regen-linux64 or ./regen-linux64d
    from inside the <xp_dir> directory.

Rebuild STM4 on Windows

  1. If you need to recompile STM4 you need MS Visual C++ 2010 (VC++ 10) or the version you chose when you installed AVS/Express
  2. Reconfigure the toolkit executing: 
    regen.bat
    from inside the <xp_dir> directory.
  3. Edit the generated file express.vcxproj and in the <ItemGroup> section remove all duplicated references to files (there are for example plenty of references to MoleculeDataType.h
  4. To recompile double click on stm4.sln then inside VC++ push 'Build solution'
  5. Then go to the subdirectory cscs_proj/stm4/plugins and double click on plugins.sln then inside VC++ push 'Build solution'

Rebuild STM4 on Windows (Visual Studio 6, 8, 9 or 10)

  1. If you need to recompile STM4 with MS Visual C++ (VC++ 6), MS Visual C++ 2008 (VC++ 8) or MS Visual C++ 2009 (VC++ 9)
  2. Install the adequate build files:
    MS Visual C++ 6 (VC++ 6)
    Go to the directory msvc6 and execute setup-v6.bat
    MS Visual C++ 2008 (VC++ 8)
    Go to the directory msvc8 and execute setup-v8.bat
    MS Visual C++ 2009 (VC++ 9)
    Go to the directory msvc9 and execute setup-v9.bat
    MS Visual C++ 2010 (VC++ 10)
    Nothing should be done
  3. Reconfigure the toolkit executing: 
    regen.bat
    from inside the <xp_dir> directory.
  4. (VC++ 6) To recompile double click on stm4.dsw then inside VC++ push 'Build workspace'
  5. (VC++ 8 and newer) To recompile double click on stm4.sln then inside VC++ push 'Build solution'

Rebuild STM4 on Mac

  1. If you need to recompile STM4 be sure to have the libg2c.a library file. Put it under the AVS/Express installation in the directory <xp_dir>/lib/darwin
  2. Recompile the toolkit executing: 
    ./regen-mac
    from inside the <xp_dir> directory.