| MetaSite user manual | ||
|---|---|---|
| <<< Previous | Next >>> | |
Chapter 3. Installation
MetaSite is distributed through the Moleculer Discovery web site (http://www.moldiscovery.com) or in CD-ROM format.
If a local CD-ROM device is available you can execute the installation program directly from the CD-ROM.
If you have no CD-ROM directly attached to your computer you will need to transfer the CD-ROM contents to a temporary directory in a local filesystem. The distribution CD-ROM is readable by most computers running UNIX or Windows. The contents can be transferred using FTP, rcp etc...
Important: If you transfer the CD-ROM contents, make sure that the capitalization of the files is preserved. If you use FTP make sure to transfer all of the files as binary data.
3.1. Installation of the windows version
MetaSite is distributed for the windows platform in form of a self-extracting executable file (please note that, depending on the operating system version, administrative priviledges may be required).
STEP 1.
To start the Setup Wizard application double-click the installer icon.
A dialog window is issued, prompting the user for confirmation:

The welcome page of the setup wizard is then shown:

Click on the Next button to proceed to the License Agreement page:

Please read the shown terms and conditions, then click the I Agree button to accept the licensing terms and continue the installation procedure:

The Choose Install Location page allows the users to customize the installation path. Provide a different filesystem location if needed and then click the Install button to start the actual installation process:

Once the installation is completed click the Next button to move to the last page:

The installation is finished. Click the Finish button to close the setup wizard.
STEP 2.
Use of the installed programs requires a suitable license line.
On first run, and as long as no valid license is found for the current host, MetaSite will show a dialog window like this:

Please copy the line shown verbatim and send it to Molecular Discovery. License requests should be submitted online to the Molecular Discovery web site (http://www.moldiscovery.com). We will send you back a similar line containing the license key.
License lines should be copied verbatim to the license.txt file, located in the MetaSite install folder. As long as this file does not contain a suitable license line, MetaSite will keep showing the above information or an error message and will not start.
Please notice that license lines are unique for each system. If you repeat the installation on a different host you will need a new license line.
Note: Installation on Windows Vista. In Windows Vista, by default users do not have write permisions for the file license.txt, even if the user has an Administrator profile. Locate the file license.txt in the installation directory, (for example by exploring folder C:\Programs\Molecular Discovery Ltd.\MetaSite3) and right click on it. Select Properties and then the Security tab. There select the group Users and verify that writing is not permitted. If so, click on the Modify button. A new dialog will appear. Select the group Users and activate the full control option in the Allow column and press OK to apply changes.
3.2. Installation of the unix version
Note: MetaSite can be installed on a NFS server and exported, in such a way that different hosts can share this resource and execute MetaSite on the local CPU. If you plan to share the MetaSite install directory among different hosts read Section 3.2.1 before starting.
STEP 1.
Change directory to the mount point of your local CD-ROM or to the temporary directory where you have copied the contents of the CD-ROM. For example:
cd /CDROM
Start the MetaSite installation tool
./install.sh

Type Yes if you accept the terms and condition.

Type the full path of the Destination directory, the directory where the MetaSite programs will be installed. This should be the name of a new, non-existing directory. Do not create this directory before running install. Be aware that you must have write permission to create such a directory.
The program will copy all of the required files to the installation directory and prepare the MetaSite binary files.
STEP 2
The installation program creates two launch scripts, metasite and metasite-cli, that should be executed to run the corresponding applications. These scripts provide the necessary environment settings and run the corresponding programs in a new shell to avoid potential configuration conflicts.
In order to allow the user to invoke those scripts without providing the full path of the installation directory, the installation path is to be added to the $PATH environment variable.
If you wish to make MetaSite generally available we suggest adding something like the following to the /etc/bashrc file (you will need administrator privileges to do this):
export PATH=/usr/local/metasite:$PATH
where we assume that the installation directory for MetaSite is /usr/local/metasite
If you have no administrative privileges in your computer you can obtain the same results by adding such a line to the file .bashrc present in your home directory.
STEP 3
Use of the installed programs will require a suitable license line.
If you added the above-mentioned line to your configurations file you will need to open a new terminal window to update the environment settings. In this window type:
metasite
On first run, and as long as no valid license is found for the current host, MetaSite will show a dialog window like this:

Please copy the shown line verbatim and send it to MD. License requests should be submitted online to the Moleculer Discovery web site (http://www.moldiscovery.com). We will send you back a similar line containing the license key.
License lines should be copied verbatim to the license.txt file, present in the MetaSite install directory. As long as this file does not contain a suitable license line, MetaSite will keep showing the above information or an error message and will not start.
Please notice that license lines are unique for each system. If you repeat the installation on a different host you will need a new license line.
3.2.1. Installing MetaSite on a NFS server
Start installing MetaSite in the server using steps 1 and 2 of the general procedure described above. This can be done locally on the server or from any workstation sharing an exported server directory. In any case, make sure that you have write permissions on the installation directory during the install procedure. For regular MetaSite use, the installation directory can be mounted "read-only".
For example, let's imagine that MetaSite is installed in the server bigboss, in the directory /usr/programs/metasite. This directory is exported to the workstations willy and billy which mount this directory read-only as /nfs/metasite.
Configure the environment of each workstation so that /nfs/metasite appears in the $PATH. Start MetaSite in each workstation and collect the lines produced in a single block of text:
alpha 319425160 L MSITE_30 31-Dec-2008 z16XBqFJwJBS key
beta -720771573 L MSITE_30 31-Dec-2008 gjerRFMESNoK key
gamma 720771573 L MSITE_30 21-Dec-2008 orxigqOxHqzo key
|
Submit the lines produced by the workstations to the Moleculer Discovery web site (http://www.moldiscovery.com). We will send back similar lines containing the license keys.
| <<< Previous | Home | Next >>> |
| Background | Using the MetaSite GUI |