This is the documentation-page for version 0.1

On this page only the most popular documentation (read: screencasts) are published.
For the advanced documentation you should have a look at http://wiki.bimserver.org/ or

download the PDF documentation on http://download.bimserver.org/


Installation

There are two possibilities to install the bimserver: stand alone (with a build in Jetty server) or deploy the WAR file (for example on a tomcat server).
This chapter will describe both options.

option 1: Quick start  standalone version

Requirements
Download and install Java version 6 on http://java.com
Download the latest JAR file on http://download.bimserver.org/
Optional: Download the client on http://download.bimserver.org/ and the free IFCviewer on http://www.ifcbrowser.com

Install

Open the JAR file in a Java virtual machine (double click).
At some point in this process, you might be warned with a firewall message. Of course you should choose ‘do not block’.
You get a small window called ‘BIM Server Starter’. Choose your options (if you don’t know what to do, don’t change them) and click start.
The server will start and during this you will see some messages. There will be a directory deployed including a BerkeleyDatabase. At the end you will see ‘org.bimserver.Server – Server started successfully’. You are now running your own bimserver!

Testing the installation

Open  your favorite web-browser and go to http://localhost:8081/. You will get the ugly opening page of the bimserver. Congratulations: your PC is now a bimserver!
Click on login (yes, it’s hard to find) and login using admin/admin as the username/password.

option 2: WAR file

Requirements
Requirements are as option one, extended with the download and install of  Tomcat version 6 (6.0.18).

Start

Deploy the WAR file in tomcat (if you don’t know howto, read the tomcat instructions).
The starting of the bimserver takes about 20 seconds. There will be a directory deployed including a BerkeleyDatabase.

Testing the installation

Open  your favorite web-browser and go to http://localhost:8080/bimserver-0.1
Attention: when you run tomcat on a different port you should go to the other port. When you deploy a different filename (like bimserver-x.xxx) you should also use a different URL depending on the filename you deployed.
You will get the ugly opening page of the bimserver. Congratulations: your PC is now a bimserver!
Click on login (yes, it’s hard to find) and login using admin/admin as the username/password.

Installation-issues

My standalone server won’t start (testing the installation doesn’t give results). What’s wrong?
Possibilitie 1: The standalone version starts at port 80 (predefined). Make sure there are no other applications (like skype, apache or xamp stuff) using port 80 before starting.
Possibilitie 2: When you are using windows (try ubuntu and) make sure the firewall isn’t blocking the bimserver.

 

First use

Browse (using your favorite webbrowser) to http://localhost:8081/ or http://localhost:8080/bimserver-0.1/ (depending on your installation).
Click on ‘login’ (hard to find, we know).
Login using admin/admin as the username/password.

 

 

What doesn’t work (yet)

Other (global) issues we know of:
– Multiuser
Using the bimserver with several people at the same time can result in ‘unpredictable behavior’
– Logging
Can be much better.
– Exceptions
It happens often that nothing happens after an exception (without userfeedback) resulting in the server to ‘hang’.
– Memorymanagement
The use of memory of the server has to be optimized. It’s possible that the memory reaches it’s limitations due to caching.