Download and install OpenJDK 17 (or later), available from https: / / openjdk.java.net/ .

	What about Java 11?
	BASE 3.19 is the last BASE version that supports Java 11. Starting with BASE 3.20, Java 17 (or later) will be the only supported Java version. Note that Oracle no longer provide a free JDK or JRE. Instead, OpenJDK has to be used.

BASE utilise Hibernate for object persistence to a relational database. Hibernate supports many database engines, but at the moment we only work with PostgreSQL. Support for MySQL was ended in BASE 3.19.

The database names (base2 and base2dynamic are used here), the db_user, and the db_password can be changed during the creation of the databases. It is recommended to change the db_password, the other changes are optional and can be made if desired. The database names, the db_user, and the db_password are needed below when configuring BASE.

	Note
	Note that the db_user name and db_password set here is used internally by BASE in communication with the database and is never used to log on to the BASE application.

	The database must use the UTF-8 character set
	Otherwise there will be a problem with storing values that uses characters outside the normal Latin1 range, for example unit-related such as µ (micro) and Ω (ohm).

Download BASE and unpack the downloaded file, i.e. tar zxpf base-...tar.gz. If you prefer to have the bleeding edge version of BASE, perform a checkout of the source from the subversion repository (subversion checkout instructions at BASE trac site).

If you choose to download the binary package, skip to the next item. The rest of us, read on and compile BASE. If you downloaded a source distribution, unpack the downloaded file tar zxpf base-...src.tar.gz, or you may have performed a subversion checkout. Change to the 'root' base2 directory, and issue ant package.bin. This will create a binary package in the base2 'root' directory. Unpack this new package (outside of the source file hierarchy), and from now on the instructions are the same irrespective where you got the binary package.

This section is intended for advanced users and programmers only. In cases when you want to change the BASE code and try out personalised features it may be advantageous to run the tweaked BASE server against the development tree. Instructions on how to accomplish this is available in the building BASE document. When you return back after compiling in the subversion tree you can follow the instruction here (with obvious changes to paths).

An area for file storage must be setup. Create an empty directory in a proper location in your file system. Set the owner of the created directory to the user the Tomcat server will be running as. Tomcat server set up instructions will follow below. Remember this location for later use. The default location is /usr/local/base2/files.

An area for plug-in and extensions installation must be setup. Create an empty directory in a proper location in your file system, and make sure that the user that the Tomcat server will be running as has read permission in this directory. Tomcat server set up instructions will follow below. Remember this location for later use. The default location is /usr/local/base2/plugins.

Basic BASE configuration is done in <base-dir>/www/WEB-INF/classes/base.config:

See the Appendix B, base.config reference for more information about the settings in the base.config file.

Optional but recommended. You may want to modify extended properties to fit your needs. Extended properties are defined in <base-dir>/www/WEB-INF/classes/extended-properties.xml. There is an administrator document discussing extended properties available. If you plan to perform a migration of a BASE version 1.2 database you should probably not remove any extended properties columns (this is not tested so the outcome is currently undefined). However, adding columns does not affect migration.

Change directory to <base-dir>/bin and execute the following commands:

sudo ./initdb.sh [base_root_login] base_root_password

In the first command sudo is required because a file will be created in the directory defined by userfiles above. If the directory is writable by you then sudo is not needed.

	Important
	The base_root_login and base_root_password you use here is given to the BASE web application root user account. The base_root_login is optional. If not specified, root is used for the login.

If the initialisation script fails, it is probably a problem related to the underlying database. Make sure that the database accepts network connection and make sure that db_user has proper credentials. You may also get a Permission denied on file extension-settings.xml if you do not have write permission to the directory defined by variable userfiles in file base.config. If the initialisation fails on extension-settings.xml you must drop the database and recreate the database as described in BASE (database engine).

Download and install Apache Tomcat 9 available from http: / / tomcat.apache.org.

	Important
	As of BASE 3.15 we are recommending that Tomcat 9 is used for new installations. Tomcat 8.5 may work, but is no longer supported.

There are a few configuration options that are needed to make Tomcat work properly with BASE. The options are set in the CATALINA_OPTS environment variable.

Depending on your system there are probably several ways to set the the CATALINA_OPTS variable. One suggestion is to add the following line (as a single line) close to the top of the catalina.sh script that comes with Tomcat (directory bin):

CATALINA_OPTS="-Xmx1G 
-Dcom.sun.media.jai.disableMediaLib=true
-Djava.awt.headless=true"

For more information about Tomcat options see https: / / tomcat.apache.org/ tomcat- 9.0- doc/ index.html.

Do the following:

and finalise with start, or restart, Tomcat, and try http://hostname:8080/base2 (change hostname to your hostname and base2 if you selected another name for the BASE Tomcat application) in your favourite browser. The BASE log-in page should appear after a few seconds.

This step is optional.

If you want run the Tomcat server through the Apache web server, you need to install the Apache version 2 web server, available from http: / / httpd.apache.org/ , and a apache-tomcat connector, available from http: / / tomcat.apache.org/ connectors- doc/ index.html

Happy BASEing. Now you can log on to your BASE server as user root (use the base_root_password from the database initialisation step above). You should begin with creating a couple user accounts, for more information on how to create user accounts please refer to Chapter 23, Account administration.