![]() |
|
|
|
}
?>
| >Home | >FAQ |
Topics
|
| Installation Guide for Linux BioServer |
|
There is no need to shut down other applications in order to install
the software, however it may be advisable to
enhance the speed of your installation. Your machine should be connected
to the internet to enable the full installation of all applications.
The Java SDK 1.4 is a pre-requisite for successful installation of your BioBind software. We recommend the Blackdown port for linux. Alternatively the SUN microsystems version may be used. Your server should already have a web server installation. Apache Tomcat is included as part of the BioBind installation. Your BioBind software supports the use of Generic NQS or OpenPBS batch queueing systems. Should you have a different system installed on your server, please contact us. Login as Root to the machine that will be running the Jemboss server. Set up a user account biobind on the server. Tomcat is installed by your BioBind installation wizard and run as the non-priveleged user "biobind". Insert the CD into the drive. To launch the install wizard execute the install script by typing cd /mnt/cdrom/install at the prompt. The mountpoint may be different depending on the hardware and Linux distribution. Your BioBind software will automatically search for the Java installation in the most obvious places. Should it fail to find it, you will be prompted for the exact path of the Java location on your machine. |
| Licence |
| The BioBind Ltd Licence is a legal document that must be accepted in order to continue with the installation of your BioBind software. Declining the licence will result in termination of the installation. |
| Licence Key |
| Your BioBind software will only function using a valid 32 character licence key. If the key fails to validate, check that all numbers are zero and not the letter O. Should you have entered an invalid key, an error message will appear. If you have checked the above and your key still fails to function, please contact us. |
| Proxy Settings |
|
On most systems, web pages are retrieved directly from the
internet. Most home users will not access the internet using proxies
and should leave the fields blank. However, some sites have a central
server and the site policy insists that web pages are accessed through
the server. Such a server is known as a proxy and can cache frequently
queried web pages to improve search efficiency. The server is
accessed by specifying a name and a port. A port is a doorway into the
computer. The most common port for web access is 8080.
In most cases the proxy will look something like wwwcache.institute.ac.uk:8080 for institutes or wwwcache.company.co.uk:8080 for companies. Proxy information is available from the web browser. A variety of commonly used web browsers is listed below together with instructions for retrieving proxy data. Access this information and type it into the BioBind Proxy Settings window.
Internet ExplorerOpen the Tools menu and access Internet Options. Select the Connections tab and then the LAN settings button. If you require a proxy, the Advanced button under the Proxy Server section will be accessible. Click this button and type into the BioBind Proxy Request Field the Proxy address to use information followed by a colon (:) and then the Port number for both the HTTP field and the FTP field.NetscapeOpen the Edit menu and select Preferences. Click on the arrow next to Advanced and highlight Proxies. Copy the information in the HTTP Proxy field followed by the information in the Port field. Do the same for the FTP field.MozillaOpen the Edit menu and select Preferences. Click on the plus sign next to Advanced and highlight Proxies. Copy the information in the HTTP Proxy field followed by the information in the Port field. Do the same for the FTP field.OperaOpen the Tools menu and select the Preferences option. Choose the Network option from this sub menu and then Proxy Servers. Copy the relevant information from the HTTP and FTP fields.KonquerorOpen the Settings menu and select the Configure Konqueror option. Choose the Proxy icon from the scroll list on the left hand side of the window. On the Proxy tab on the right hand side ensure that the Use Proxy option is checked. (If it isn't checked and you are otherwise connected to the Internet, then you do not need a proxy for your machine) Follow one of the Setup buttons. Copy the relevant information from the HTTP, FTP and Port fields. |
| Jemboss Server Settings |
These settings are designed to enable the smooth running of
your web service.
This box is checked by default and specifies that users must provide a username and password at login to the server. Uncheck this box if you do not require this option. IP address The information required here is the IP address of the server to which your users will log in. By default it is set to the server's IP address and should not need changing unless it is incorrect. Use Data Encryption This option is selected by default and encrypts data transfer between the client and server. It is the recommended setting. Uncheck the box if you do not wish to use Secure Socket Layer (SSL) / HTTPS encryption. Port This information relates to the port used to access the services for Tomcat and the Jemboss results directory. The default port is 8443 for a secure connection (HTTPS) and 8080 for a non-secure connection (HTTP). The default Tomcat installation directory is /usr/local/tomcat The Jemboss Results Directory is where the EMBOSS applications are run and every result stored. By default it is located at /tmp/SOAP/emboss. It is highly recommended you change this as this directory is often removed on rebooting. |
| Jemboss SSL Server Settings |
These settings are required to sign the jar files used to launch
the Jemboss web page. They are also required for the https client-server
connection.
The password enables the client access to the server and should be at least six characters long. Organisation Name Name of the organistion to whom the BioBind software is licensed. This is the name that will appear on the authentication certificate. Location This information will also appear on the authentication certificate and should indicate the location of your organisation. Country Set by default to UK this can be altered by placing the cursor inside the text box. This information will also appear on your authentication certificate. Days until Expiry This sets the expiry information for the SSL certificates. Once these have expired, Tomcat is no longer accessible. It is recommended that these certificates are updated regularly for security purposes. The default setting of 365 days can be altered. There is no specified maximum limit. |
| Jemboss Batch Settings |
These are required to specify any batch queueing parameters.
This is the default setting and if no queuing system is selected, this option will run your software as a background process on the server. OpenPBS or Generic-NQS If authentication has been selected then either of these options will elect to submit batch processes to the network queueing software supported by the BioBind software. If you have a different batch queue system, please contact us.
|
| Select RPMs |
There are 8 RPM modules which include the entire EMBOSS package, the
PHYLIP, ESIM4, DOMAINATRIX and primer3 applications together with the
PRINTS and Rebase databases and aaindex.
These are free from any restrictions and are all selected by default.
Sizes shown are for the i386 version. RPMs for x86_64 are slightly
larger.
|
| BioBind Installation |
| All selected RPMs will now be installed on your machine. Should all 8 RPMs be selected, installation should take approximately 1 minute. |
| Select Downloads |
| BioBind does not distribute some EMBASSY packages or data which have potentially restrictive licencing conditions. If use of this data is allowed at your site then leave the selection boxes checked, otherwise de-select them. Please see our EMBASSY page for further details. |
| BioBind Downloads |
| Your software will automatically retrieve this information from the appropriate web site and install it. Total installation time for all additional modules is approximately 8 minutes using 512Kbps downstream speed. |
| Installation Complete |
|
This message will tell you that your installation is complete.
The installation may take a few minutes as it starts up the
server and to sign jar files.
To set up the BioBind web launch page for your new bioinformatics web services, there are 2 final steps:
Alias /Jemboss/ "/usr/local/emboss/share/EMBOSS/jemboss/jnlp/"
application/x-java-jnlp-file jnlp to your mime.types file on the server. This enables the web server to recognise JNLP applications. |
| Starting the Server |
|
The server is automatically started by the BioBind install wizard.
Once the server has been halted, subsequent starts must be made
manually.
To start and stop the Tomcat server, the commands tomstart and tomstop should be executed as root. This launches Tomcat as the user biobind. To halt the server, the command tomstop must be used as Root. |
| Increasing Memory Allocation |
When you install your Bioserver, the default memory allocation is
200Mb. To customise this memory allocation pool,
edit the tomstart script that is used to run the tomcat
server.
|
| Accessing EMBOSS |
| Type the name of an EMBOSS program at the prompt to access this software. |
| Accessing Jemboss |
| Clients will access the Jemboss web page with a URL specified by you. Users can click on the Launch Jemboss link to fire up the interface on their own machine. Each client machine must have Java 1.3 (ideally 1.4) and Java Web Start installed. The interface is supported for PCs, Linux and Mac OS X. |
| Uninstalling your BioBind software |
|
Should you upgrade to a new version of the software, you must first
remove the old installation. Login as Root and re-insert your BioBind Software CD (either the original one or a new one). If your mountpoint is /mnt/cdrom type /mnt/cdrom/scripts/uninstall and the old software will be removed. If your mountpoint is different, replace /mnt/cdrom with the relevant path. This uninstalls both the EMBOSS/EMBASSY/Jemboss applications and the Tomcat web launch software and takes approximately 1 minute. |
| ©2005 BioBind.com All rights reserved. |