LIMBAS installation

Once all packages have been installed, PHP configured, the Apache HTTP server set up and an empty database created, LIMBAS can be installed. For distribution-specific preparation, see CentOS, Ubuntu, OpenSUSE or FreeBSD and for setting up the database, see database setup.

Download

LIMBAS can be downloaded from http://sourceforge.net/projects/limbas/files or https://github.com/limbas/limbas.

Save the download file (here openlimbas_5.x.x.tar.gz) in {DocumentRoot} and unzip it there:

$ tar xzfv openlimbas_5.x.x.tar.gz

When unpacking, the directory {DocumentRoot}/openlimbas is created with the following subdirectories:

limbas_src	This is where the LIMBAS source files are located, which can be overwritten in the event of an update without losing individual settings.
vendor	Here you will find independent external applications that are used by LIMBAS. It is possible to update these applications independently of LIMBAS, but this is not recommended as the interaction is only tested with the versions contained in the LIMBAS installation.
public	public is the publicly accessible entry point and contains the index.php and the rewrite rules.
dependent	This is the working directory in which individual settings are also stored. The TEMP and USER directories must be available as symbolic links in public.

To enable individual settings to be saved in LIMBAS, the Apache server must have write access to ./openlimbas/dependent and all subdirectories. To enable this, the owner of this directory and its subdirectories must be changed to the Apache user. For more details, see the installation documentation for the various distributions/operating systems.

Installation

It must be ensured that the firewall configuration allows access from this browser to the LIMBAS host.

The LIMBAS database structure can now be created using a browser.
To do this, the LIMBAS installation script must be called up with the following URL: http://{LimbasIP}/openlimbas/public/install/

The web interface automatically tries to enter all paths correctly. If this does not happen or the fields remain empty, the php.ini should be checked again.

• Click on ‘check’ to check whether all the required functions are available. The installation can only be continued if the minimum requirements are met. This can be recognised by the green and yellow ticks. If this is the case, you can select the desired installation:
  • demo.tar.gz: The database contains user data with which the properties of LIMBAS can be demonstrated
  • clean.tar.gz: The database does not contain any user data. (See Configuring ODBC)
• Click on ‘install’ to start the installation process. The progress of the installation can be recognised by the green progress bar.
• User ‘root’: The installation script transfers the database settings to the file {DocumentRoot}/openlimbas/dependent/inc/include_db.lib. If this file is changed, access to the database is no longer possible. To prevent unwanted manipulation, all write permissions to this file should be removed.

chmod 444 {DocumentRoot}/openlimbas/dependent/inc/include_db.lib

Execution

After successful installation, LIMBAS can be started by clicking on the ‘test installation’ link or by entering the following URL: http://[url]/openlimbas/public/. [url] can be localhost, for example.

Immediately after calling up the URL, you will be asked to authenticate yourself. The following default user with all administrator rights is available for this purpose:

• User name: admin
• Password: limbas