Installing the Bayesian Data-Analysis Toolbox ()

Copyright © 1995, 2017 Washington University in St. Louis, Missouri

By downloading or using a copy of Bayesian Toolbox ("SOFWARE") you ("LICENSE") agree to the following terms and conditions. Washington University ("WU") here by grants to LICENSEE a revocable, non-transferable, non-exclusive, royalty-free, non-commercial license to download, install and use SOFTWARE on a single device provided to or owned and controlled by LICENSEE. The SOFTWARE may not be distributed, shared, or transferred to any third party. This license can be terminated at any time and does not grant any rights or licenses to any other patents, copyrights, or other forms of intellectual property owned or controlled by WU.

Commercial use of the SOFTWARE, or derivative works based thereon, REQUIRES A COMMERCIAL LICENSE. Commercial use includes any sale, lease, license, or other transfer of the SOFTWARE in its entirety or in part, to another entity. Commercial use also includes, without limitation, uses of the SOFTWARE by any entity, including Licensee, to perform any service for sale or contract research, to produce or manufacture products for sale. Parties interested in a commercial license should contact G. Larry Bretthorst (gbretthorst@wustl.edu) and Joseph J. H. Ackerman (ackerman@wustl.edu).

LICENSEE AGREES THAT THE SOFTWARE PROVIDED HEREUNDER IS EXPERIMENTAL AND IS PROVIDED "AS IS" , WITHOUT ANY WARRANTY OF ANY KIND, EXPRESSED OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE, OR NON-INFRINGEMENT OF ANY THIRD-PARTY PATENT, COPYRIGHT, OR ANY OTHER THIRD-PARTY RIGHT. IN NO EVENT SHALL THE CREATORS OF THE SOFTWARE OR WU BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF OR IN ANY WAY CONNECTED WITH THE SOFTWARE, THE USE OF THE SOFTWARE, OR THIS AGREEMENT, WHETHER IN BREACH OF CONTRACT, TORT OR OTHERWISE, EVEN IF SUCH PARTY IS ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

The Bayesian Data-Analysis toolbox is a client/server software system. This installation procedure will walk you through the process of setting up a server machine. The server machine contains all of the software needed to run the various analyse and once installed your server machine is an independent standalone installation that does not communicate with Washington university, except when you download or check for updates.

There are several requirements for running this software:

• You must have either a LinuxPC running CentOS 4.1 or higher, or a Sun system running Solaris 9 or 10.

• You must have both Java (6.0 or higher) and Java web start (JavaWS) installed. Note for LinuxPC users: the Java shipped with CentOS is OpenJDK and this Java version does not come with JavaWS, so it cannot be used. To fix this problem, download and install Sun Java.

• While Fortran and C compilers are not strictly required to run this software, the software is much more usable when these are installed. For this reason, I would strongly suggest users install both Fortran and C compilers. The software supports Intel, Gnu and Sun compilers. The Intel compilers cost a few hundred dollars, the Gnu and Sun compilers are free. Note that while the software supports Sun compilers on Solaris, it does not support these compilers on Linux systems.

Downloading and installation the software:

1. Pick the machine that is to act as the server. The server can be a multi-core LinuxPC, either 32 or 64 bit, running CentOS GNU/Linux, or a Sun Solaris system. Lets call this machine "server.name.net".

2. Create an account on "server.name.net" that is to be configured to run the software. This account should only be used by the Bayesian Analysis software. For arguments sake, lets assume that the account is named "bayes", although it can have any name.

3. Login to the "bayes" account on "server.name.net".

4. Assuming both Java and JavaWS are installed and in your path, run the following command:

   javaws http://bayes.wustl.edu:8080/BayesServer/launch.jnlp

   This Java application will display a window containing a set of configurable options. For a first time installation, it will be populated with the installations procedure's best guess at the optional values. When updating your software, it will be populated with the values previously used in the installation procedure. Fill in or modify these options as needed.

5. Hit the install button. The installation procedure will download and install the server and client software and will configure the communications between the clients and server.

6. After the server installation kit completes, it displays a list of commands that must be executed as root. These commands can be copy/pasted to a root login. They will copy the Apache server configuration files to the appropriate system directory, create the server's home directory and copy two Apache server start/stop scripts to the appropirate "/etc/rc3d" directory so that the Apache server automatically starts and stops when the system is rebooted.

After completing the root commands, your server should be up and running and you should have a fully functional installation of the Bayesian Analysis software. You can check to see if the server is running by entering "http://your.server.net:8080" in a web browser, where "your.server.net" should be replaced by the name of your server, and 8080 should be replaced by the port number you used in the installation. This http request should bring up the default page for an apache server.

If you have more than one machine you wish to use as a server, repeat this installation procedure on each machine. When you run the client interface, the "Settings/Server Setup" window allows you to specify the server you want to use.

You should be able to run the client interface on any machine that has Java and JavaWS installed. We routinely run the interface on Sun Solaris, MacOS, CentOS and WindowsPCs. To run the interface, issue the command:

javaws http://server.name.net:8080/Bayes/launch.jnlp

from a command prompt, where you must supply your server name and port number. Additionally, this command can be placed in a shortcut to facilitate starting the interface. Running this command should result in the interface being displayed on your client machine.

Finally, the Bayesian Analysis software does not have an update feature. That is to say, when we distribute new software, one simply reruns the installation procedure to install the updates. So, for example, if you installed the software but did not configure either Fortran or C compilers, then to change this you would simply rerun the installation procedure and select the appropriate compilers. When the installation is done, you system should then support compilers.

If you have any questions or comment please contact me.

This site is being maintained by:
Larry Bretthorst
Dept. Of Chemistry and Radiology
Washington University
St. Louis MO 63130

Phone: 314 362-9994