FlexS Installation Guide
################################################################################
--------------------------------------------------------------------------------
1. Download and unpack
--------------------------------------------------------------------------------
Linux/Unix:
After downloading and unpacking (tar xvzf ) the FlexS software
package, you have the following files and directories:
- config_sp.dat FlexS configuration file
- doc/ Directory containing help documents: you
can find the full user guide here:
doc/flexs_ug.pdf
- example/ Various example input files
- flexs link to the FlexS executable
- flexs-2.1.0- FlexS executable
- flexv FlexV executable
- install.readme Readme file containing information about the
installation process
- predict/ The output directory
- python/ FlexS Python bindings (only Linux 32 bit)
- static_data/ Encrypted static data files
- tmp/ All sorts of temporary files, get lost when
quitting the program
On Unix-like systems, flexs-2.1.0- is the main executable. If it
does not have the 'x'-flag, set it with "chmod +x flexx-2.1.0-".
Windows:
Start the exe that was downloaded and follow the steps in the installation
wizard - set up a desktop icon for easy access.
One extra file whose existence should be highlighted at this stage if
you missed it already is: "doc/flexs_ug.pdf"!
--------------------------------------------------------------------------------
2. License Keys
--------------------------------------------------------------------------------
Our software is license key protected. Please be aware that you cannot run
FlexS under any circumstances without a valid license. If you do not already
have a license, please use the form at:
http://www.biosolveit.de/license/
to request a license for our software or to request further information about
the licensing procedure. Alternatively you may mail us at:
license@biosolveit.de
To obtain a valid license you must determine the processor or system ID of your
computer. To do this you can use the small ID generation tool 'FlexIDgen'.
You can download this from:
http://www.biosolveit.de/download
Linux/Unix: If this executable does not have the 'x' flag, set it with
chmod +x flexidgen.
Alternatively, you may complete the installation of FlexS and
try to start it without a license. FlexS will in this case fail
to start and print the ID information on the screen. For Linux/Unix
you may also start the tool with the -i flag:
flexs -i
to see the ID information.
After you receive your license keys from us, you are ready to proceed
with the next stage of the installation.
--------------------------------------------------------------------------------
3.1 BioSolveIT license scheme for Linux/Windows platforms
--------------------------------------------------------------------------------
For the Linux and Windows versions of FlexS we use the FlexLM license
management system which allows flexible administration of your licenses.
License format: Each line of a license file includes the name of the licensed
tool or module, and -- among other information -- the version number and the
expiration date of the license.
Example:
INCREMENT FlexS BIOSOLVE 2.0 28-jun-2005 uncounted \
HOSTID=COMPOSITE=803C749ABB01 SIGN="0078 AD79 1445 A900 \
906E 00A4 AB51 F600 AFC8 4394 9356 3C87 EBD2 4A7B E88D"
INCREMENT FlexS_C BIOSOLVE 2.0 28-jun-2005 uncounted \
HOSTID=COMPOSITE=803C749ABB01 SIGN="0089 BE66 7456 A340 \
816F 1145 A671 F666 EF48 5396 3456 4587 E452 4456 2887"
This license information should be saved on your system in a text
file with the suffix .lic. You must then choose one of the following
methods which will allow FlexS to access the licenses.
3.1.1 Setting an environment variable to access the licenses
--------------------------------------------------------------------------------
Set the BIOSOLVE_LICENSE_FILE environmental variable to point to your license
file:
Windows:
Go to the Environment Variables window via:
Control Panel -> System -> Advanced -> Environment Variables
Choose 'New' and enter BIOSOLVE_LICENSE_FILE} as the name and the complete
path to the license file as the value.
Linux/Unix:
Use the setenv or export command -- for example:
setenv BIOSOLVE_LICENSE_FILE /home/user/flexlmlicenses/biosolveit.lic
3.1.1 Running a FlexLM license server
--------------------------------------------------------------------------------
Instead of specifying a license file directly in the configuation file, it is
also possible to enter the name of a FlexLM license server instead. First,
you must have a FlexLM license system running to which you have access.
A current version of the license manager daemon and the BIOSOLVE vendor daemon
can be downloaded from:
http://www.biosolve.it/download
To administer your FlexS licenses using a license server, your FlexLM
administrator must take the following steps:
1. Add the FlexS license file to the directory where FlexLM searches for
licenses.
2. Add the BIOSOLVE vendor daemon to the directory where the lmgrd (license
manager daemon) resides.
For more help starting and running FlexLM with BioSolveIT licenses, please
visit our FAQ at:
http://www.biosolve.it/faq
Or consult the Macrovision homepage at:
http://www.macrovision.com/services/support/fnp_utilities.shtml
for further technical information about installations of FlexLM.
When using a license server, you must inform FlexS of the server's
name. To do this, you can specify the license server directly in the section
@LICENSE_FILES of file config_sp.dat by adding the line:
Windows:
;@myserver
Linux/Unix:
:@myserver
for a server called 'myserver'.
Alternatively, you can set the environment variable BIOSOLVE_LICENSE_FILE
to @myserver.
If you administer your licenses with FlexLM, it is also possible to use
floating licenses, i.e. licenses that are hosted by a server and distributed
to FlexS clients on demand. Floating licenses have a special layout.
A floating license is always locked to the name or the IP address of the server
and its processor ID (and not of the computer where FlexS will run). Again,
this processor ID can be obtained by running FlexIDgen on the server.
Example of a floating license:
SERVER myserver COMPOSITE=103C749ABB91
USE_SERVER
VENDOR BIOSOLVE
INCREMENT FlexS BIOSOLVE 2.0 28-jun-2005 100 SIGN="00C6 1440 7772
E4A8 116C FFFB EDC8 F400 B648 5413 6ECA 8852 4A2E 29B8 E5D6"
INCREMENT FlexS_C BIOSOLVE 2.0 31-mar-2005 10 SIGN="0000 AFBC
4A28 5A3E 4A88 9300 694B 4F00 5B38 4A52 AF98 288E C8BD C322
F063"
In this example the user has 100 FlexS and 10 FlexS_C (a module)
licenses. Every time a new instance of FlexS is launched the server transfers
the license to the application. When FlexS finishes its computations the
license is returned to the server.
--------------------------------------------------------------------------------
4. Linux/Unix only: Defining the root directory
--------------------------------------------------------------------------------
If you are running FlexS on a Linux or Unix system, the configuration file
config_sp.dat must be present in each directory where FlexS will be run (or
see the documentation about how to define an alternative location for a
configuration file).
The second essential entry required in the config_sp.dat after the license
information is the root directory - a line starting @ROOTDIR. All paths
specified later in the file are relative to this path except those starting
with '/' or './'. In the @DIRECTORIES section, you can define default paths
to various data locations. The @STATIC\_DATA section contains paths and
filenames of the static data files of FlexS and the @PROGRAMS section contains
paths and filenames of executables.
For a simple installation in the current directory, you can write the
current path into the definition of the root directory and just leave
all the rest as it is. You can customize the configuration of FlexS
later on and individually for each user. You may already include the
paths for RCGENERATOR, and 3DGENERATOR at this time.
--------------------------------------------------------------------------------
5. Starting FlexS: a first simple test
--------------------------------------------------------------------------------
Windows:
After making the adjustments for licensing (as described above), double
click on the desktop icon for FlexS or start the flexs.bat which is
located in the installation directory.
Linux/Unix:
Change to the directory where FlexS was unpacked. After making the
adjustments for licensing and definining the root directory (as described
above), enter the command /flexs at the prompt.
After printing a startup message, FlexS will read the configuration file and
the static data files. You should then see the FlexS prompt:
FLEXS>
Type 'quit' and 'y' to terminate FlexS.
--------------------------------------------------------------------------------
6. Basic visualization
--------------------------------------------------------------------------------
BioSolveIT offer a basic visualization tool FlexV for use with FlexS, which
is already built into the FlexS package.
No license key is needed for FlexV. When started the first time, FlexV generates
a .flexv file in your home directory. This file will be used to store
visualization preferences and should therefore be separate for each user.
--------------------------------------------------------------------------------
7. Libraries missing?
--------------------------------------------------------------------------------
We only use standard shared libraries in FlexS. In FlexV, one of the following
libraries may be missing:
OpenGL:
libGL is missing. In this case, OpenGL is not installed on this machine.
Please contact your system vendor or administrator.
--------------------------------------------------------------------------------
8. Known Issues
--------------------------------------------------------------------------------
- Token not numeric error under Linux
If you are running a Linux system and get the error message 'Token not
numeric' while reading data, this is caused by the language support
contained in the C library (floating point numbers are expected to contain
',' instead of '.' in some languages). Unset the $LANG variable before
running FlexS to circumvent language support.
- Runing flexv.exe under Vista and Windows7
If you have problems to run flexv.exe correctly, then activate the
"Compatibility Mode" for Windows XP in the properties of flexe.exe
and try it again.
--------------------------------------------------------------------------------
Now for any further help or information, we refer you to the User Guide:
doc/flexs_ug.pdf
|
