225 lines
9.1 KiB
HTML
225 lines
9.1 KiB
HTML
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"
|
|
"http://www.w3.org/TR/REC-html40/loose.dtd">
|
|
<html>
|
|
<meta name="GENERATOR" content="TtH 3.81">
|
|
<style type="text/css"> div.p { margin-top: 7pt;}</style>
|
|
<style type="text/css"><!--
|
|
td div.comp { margin-top: -0.6ex; margin-bottom: -1ex;}
|
|
td div.comb { margin-top: -0.6ex; margin-bottom: -.6ex;}
|
|
td div.hrcomp { line-height: 0.9; margin-top: -0.8ex; margin-bottom: -1ex;}
|
|
td div.norm {line-height:normal;}
|
|
span.roman {font-family: serif; font-style: normal; font-weight: normal;}
|
|
span.overacc2 {position: relative; left: .8em; top: -1.2ex;}
|
|
span.overacc1 {position: relative; left: .6em; top: -1.2ex;} --></style>
|
|
|
|
|
|
|
|
<title> iBioSim Installation Instructions</title>
|
|
|
|
<h1 align="center">iBioSim Installation Instructions </h1>
|
|
|
|
<div class="p"><!----></div>
|
|
|
|
<h3 align="center">Chris J. Myers </h3>
|
|
|
|
<div class="p"><!----></div>
|
|
|
|
<div class="p"><!----></div>
|
|
|
|
<div class="p"><!----></div>
|
|
|
|
<h1>Contents </h1><a href="#tth_sEc1"
|
|
>1 General Requirements</a><br />
|
|
<a href="#tth_sEc2"
|
|
>2 Java Installation</a><br />
|
|
<a href="#tth_sEc3"
|
|
>3 MacOS Installation</a><br />
|
|
<a href="#tth_sEc4"
|
|
>4 Windows Installation</a><br />
|
|
<a href="#tth_sEc5"
|
|
>5 Linux Installation</a><br />
|
|
|
|
|
|
<div class="p"><!----></div>
|
|
|
|
<div class="p"><!----></div>
|
|
<h2><a name="tth_sEc1">
|
|
1</a> General Requirements</h2>
|
|
|
|
<div class="p"><!----></div>
|
|
There are versions of <tt>iBioSim</tt> available for Windows, Linux, and
|
|
MacOS. You can download the appropriate installation file from:<br />
|
|
<a href="http://www.async.ece.utah.edu/iBioSim/">
|
|
<tt>http://www.async.ece.utah.edu/iBioSim</tt>.
|
|
</a>
|
|
<tt>iBioSim</tt> requires that you have
|
|
<a href="http://java.sun.com/javase/downloads/index.jsp">
|
|
Java Runtime Environment 1.6
|
|
</a>
|
|
or higher install on your system. It is also useful to have
|
|
<a href="http://www.graphviz.org/">
|
|
Graphviz.
|
|
</a>
|
|
Also, you should associate files with a ".dot" extension with the
|
|
<tt>Graphviz</tt> tool, and files with the ".xhtml" extension to your
|
|
web browswer. There is also a pure java version available that
|
|
supports most though not all features of <tt>iBioSim</tt>. This is a good option when having trouble with the other installations, since it is machine independent.
|
|
|
|
<div class="p"><!----></div>
|
|
<h2><a name="tth_sEc2">
|
|
2</a> Java Installation</h2>
|
|
|
|
<div class="p"><!----></div>
|
|
To install the pure Java version, you need to download <tt>iBioSim-2.8-Java.zip</tt> and unzip it in the directory you wish to install. The <tt>iBioSim.jar</tt> file should be executable, but may require being invoked using the explicit command: <tt>java -jar iBioSim.jar</tt>.
|
|
The <tt>iBioSim.mac64</tt> script makes it look better on Mac environment.
|
|
|
|
<div class="p"><!----></div>
|
|
<h2><a name="tth_sEc3">
|
|
3</a> MacOS Installation</h2>
|
|
|
|
<div class="p"><!----></div>
|
|
To install on MacOS, you need to download <tt>
|
|
iBioSim-〈version〉-MacOS.dmg</tt> file. You should then
|
|
open this file with <tt>DiskImageMounter.app</tt>. This should open up
|
|
this disk image in <tt>finder</tt>. You should then copy the contents of
|
|
this disk image to your Applications folder. You should then be able
|
|
to start <tt>iBioSim</tt> by double-clicking on this application.
|
|
|
|
<div class="p"><!----></div>
|
|
<h2><a name="tth_sEc4">
|
|
4</a> Windows Installation</h2>
|
|
|
|
<div class="p"><!----></div>
|
|
Download and execute <tt>iBioSim-〈version〉-Setup.exe</tt>.<br />
|
|
The installation uses InstallJammer. It first asks you for your
|
|
preferred installation language. Make your selection and press <tt>OK</tt>.
|
|
|
|
<div class="p"><!----></div>
|
|
<img src="screenshots/language.png" alt="screenshots/language.png" />
|
|
|
|
<div class="p"><!----></div>
|
|
The next screen tells you that you what version you are installing.
|
|
Press <tt>Next</tt> to continue.
|
|
|
|
<div class="p"><!----></div>
|
|
<img src="screenshots/setup.png" alt="screenshots/setup.png" />
|
|
|
|
<div class="p"><!----></div>
|
|
Next, it ask you for an installation location. Please make sure to
|
|
select a path that does not have any spaces or special symbols as
|
|
these cause problems with <tt>iBioSim</tt>.
|
|
|
|
<div class="p"><!----></div>
|
|
<img src="screenshots/location.png" alt="screenshots/location.png" />
|
|
|
|
<div class="p"><!----></div>
|
|
You are now ready to install. Press <tt>Next</tt> to continue.
|
|
|
|
<div class="p"><!----></div>
|
|
<img src="screenshots/confirm.png" alt="screenshots/confirm.png" />
|
|
|
|
<div class="p"><!----></div>
|
|
You are all done. Press <tt>Finish</tt>. If selected, <tt>iBioSim</tt>
|
|
will launch immediately. Otherwise, you can start it using your
|
|
desktop shortcut or from your start menu.
|
|
|
|
<div class="p"><!----></div>
|
|
<img src="screenshots/finish.png" alt="screenshots/finish.png" />
|
|
|
|
<div class="p"><!----></div>
|
|
In your start menu, there should be an option to uninstall. If you
|
|
select this, it will ask if you are sure then proceed to completely
|
|
remove <tt>iBioSim</tt> from your system. It is highly recommended that
|
|
you remove <tt>iBioSim</tt> using this uninstall procedure before
|
|
installing a new version.
|
|
|
|
<div class="p"><!----></div>
|
|
<h2><a name="tth_sEc5">
|
|
5</a> Linux Installation</h2>
|
|
|
|
<div class="p"><!----></div>
|
|
Since InstallJammmer is also used for the Linux install, the
|
|
installation instructions are essentially the same.
|
|
First, download <tt>iBioSim-〈version〉-Linux-x86_64-Install</tt>.
|
|
Open a terminal and browse to where this file was download. You must
|
|
make this file executable:<br />
|
|
<tt>chmod u+x iBioSim-〈version〉-Linux-x86_64-Install</tt>.
|
|
You should then execute this file:<br />
|
|
<tt>./iBioSim-〈version〉-Linux-x86_64-Install</tt>.
|
|
This starts InstallJammer. It first asks you for your
|
|
preferred installation language. Make your selection and press <tt>OK</tt>.
|
|
|
|
<div class="p"><!----></div>
|
|
<img src="screenshots/language.png" alt="screenshots/language.png" />
|
|
|
|
<div class="p"><!----></div>
|
|
The next screen tells you that you what version you are installing.
|
|
Press <tt>Next</tt> to continue.
|
|
|
|
<div class="p"><!----></div>
|
|
<img src="screenshots/setup.png" alt="screenshots/setup.png" />
|
|
|
|
<div class="p"><!----></div>
|
|
Next, it ask you for an installation location. Please make sure to
|
|
select a path that does not have any spaces or special symbols as
|
|
these cause problems with <tt>iBioSim</tt>.
|
|
|
|
<div class="p"><!----></div>
|
|
<img src="screenshots/location.png" alt="screenshots/location.png" />
|
|
|
|
<div class="p"><!----></div>
|
|
You are now ready to install. Press <tt>Next</tt> to continue.
|
|
|
|
<div class="p"><!----></div>
|
|
<img src="screenshots/confirm.png" alt="screenshots/confirm.png" />
|
|
|
|
<div class="p"><!----></div>
|
|
You are all done. Press <tt>Finish</tt>. If selected, <tt>iBioSim</tt>
|
|
will launch immediately. Otherwise, you can start it using your
|
|
desktop shortcut or from your start menu.
|
|
|
|
<div class="p"><!----></div>
|
|
<img src="screenshots/finish.png" alt="screenshots/finish.png" />
|
|
|
|
<div class="p"><!----></div>
|
|
In your start menu, there should be an option to uninstall. If you
|
|
select this, it will ask if you are sure then proceed to completely
|
|
remove <tt>iBioSim</tt> from your system. It is highly recommended that
|
|
you remove <tt>iBioSim</tt> using this uninstall procedure before
|
|
installing a new version.
|
|
|
|
<div class="p"><!----></div>
|
|
Note that since there are a large number of different linux installations, there can be problems especially with older installations. If you are having problems though, first log out and back in. There are some environment variables that need to be set. If you are still having problems, then read on.
|
|
Our linux installations are currently built for 32-bit and 64-bit versions of Fedora 15. While the Java parts of our program port smoothly, there are often issues with the dynamic libraries and the C/C++ programs <tt>reb2sac</tt> and <tt>GeneNet</tt>. If you are having a problem, the first step is to download and build libsbml Version 5.0. You will need to replace the libsbml.so* and libsbmlj.so files with your build of libsbml in either lib or lib64 depending on whether you are using a 32-bit or 64-bit machine. At this point, you should be able to start <tt>iBioSim</tt>. However, if you are still having problems, send an email to <tt>myers@ece.utah.edu</tt> including information about your OS and any error messages when you try to execute <tt>iBioSim</tt> from the command line.
|
|
|
|
<div class="p"><!----></div>
|
|
You should also now test <tt>reb2sac</tt> and <tt>GeneNet</tt>. In your install directory, try the following:
|
|
|
|
<ul>
|
|
<li> cd bin
|
|
<div class="p"><!----></div>
|
|
</li>
|
|
|
|
<li> export LD_LIBRARY_PATH=$BIOSIM/lib:$LD_LIBRARY_PATH <br />
|
|
Note that this is for bash shell, so you may need to change for your shell, if not bash.
|
|
<div class="p"><!----></div>
|
|
</li>
|
|
|
|
<li> ./reb2sac
|
|
<div class="p"><!----></div>
|
|
</li>
|
|
|
|
<li> ./GeneNet
|
|
<div class="p"><!----></div>
|
|
</li>
|
|
</ul>
|
|
You should see the usage lines for these programs. If you do not, you may need custom builds, contact <tt>myers@ece.utah.edu</tt>.
|
|
|
|
<div class="p"><!----></div>
|
|
|
|
<br /><br /><hr /><small>File translated from
|
|
T<sub><font size="-1">E</font></sub>X
|
|
by <a href="http://hutchinson.belmont.ma.us/tth/">
|
|
T<sub><font size="-1">T</font></sub>H</a>,
|
|
version 3.81.<br />On 25 Jan 2015, 15:49.</small>
|
|
</html>
|