Installation and Configuration 

 This page will guide you throw the basic installation and configuration of the system. If you encounter problems during the installation, please contact me or have a look at our success stories, which also describes installations of different customers.

BinBase needs these services installed

• installed JBoss application server - installation procedure
  • accessible over the network
  • configuration ALL started
  • correct version
• installed postgresSQL database server - installation procedure
  • please provide a user account which can create schema's,tables,views,indexes,triggers
  • please provide a database where the user has access to
  • make sure the server accepts remote connections
• installed rocks linux cluster 5.0 - installation procedure
  • make sure the nodes have access to the database server and application server
  • make sure java 1.5 is installed
  • make sure that the JBOSS_HOME variable exist on the cluster nodes
  • make sure that the BINBASE_NODE_MEMORYvariable exist on the cluster nodes

Read here to install a complete BinBase system from scratch!

Step by Step tutorial install including cluster setup

Installation of BinBase if not used the StepByStep guide

Currently we provide a graphical installer and a text based installer. you can obtain the from our webpage.

1. download installer.jar
2. start your application server
3. su into the user account of the application server (thats the user who starts the application server!)
4. run the installer and be patient since this can easily take 10 minutes depending on your internet connection and other factors.
   1. java -jar installer.jar text for console mode
   2. java -jar installer.jar for graphical mode or double click the jar file.
5. check that the install log does not show any errors, if you encounter error please contact us and we try to help
6. restart your application server
7. binbase should be now installed

Once the installation process is done you need to make some additional configuration.

Updating to a newer version of BinBase

With the upcoming BinBase 3.4 version there is going to be an updater available. Which makes this process as painless as possible.

But first please backup your complete database!

• make a complete dump of your postgres database
• execute: java -jar updater.jar

follow these instructions:

BinBase 3.x to BinBase 3.4

common installation errors

installer dies with message java not found

this happens if java is not installed or if it's not found in current path. This can happen if the file .bashrc exists not in the home directory of the user. 

installer dies with the message wrong java version found

please make sure you have java 1.5 installed. The software wont work with 1.4 or 1.6 (java 6) since 1.4 has missing features and java 1.6 has compatibility issues.

installer dies with messages like not enough free space

make sure that there is enough space available on the cluster and in your temp directory

application server refuses connections

you maybe forgot to restart your application server or you did not start JBoss with the right parameters, please make sure you start jboss like this

sh run.sh -c all -Djboss.bind.address=0.0.0.0 -Djava.rmi.server.hostname=my.host.name

installer dies during text mode over ssh connection with connection refused exception

if you install BinBase over an ssh connection please make sure that X forwarding is enabled, even if you choose text mode install. This seems to be related to a bug in the installer library and we can't really change this.