Skip to main content
Knowledge Basev11.1

Pre Installation

Celoxis is a powerful application, yet easy to install and configure if you follow the steps given below. Not following the instructions can lead to a lot of wasted hours. If you do not follow something, contact us and we will help you out.

  1. Your database server must be up and running and you must have created a database and a database user for Celoxis. If not, first do that as described in the chapter on database setup. Keep your database information ready: database name, login, password. You will be asked to input these during the installation process.
  2. Create an email account for Celoxis in your email server. Celoxis should be able to read email via IMAP and also send email using this account. Think of Celoxis as a regular user in your system. Note down the username and password. This will be used in installation.
  3. Decide how your users would want to access Celoxis. For example, if your domain is acme.com, you can have celoxis.acme.com, projects.acme.com, pm.acme.com, etc. Before you begin installation, ensure that your DNS server has been updated with this hostname and is working fine by using the ping command.
  4. Download and install JDK 8 from Oracle's Java download center. If your operating system is 64 bit, then you must install the 64 bit version, else you must install the 32 bit version. Also, you must install the JDK, not JRE.
  5. Create a directory for installation of the application and uploaded files. On Windows, we recommend: C:\celoxis, while on Linux, we recommend: /usr/local/celoxis. Avoid creating a directory with name having the space character. The directory should have at least 10GB + size of uploaded files you will upload into Celoxis.
  6. Download the installation zip file (link will be sent to you via email) and copy it to the directory created above.
  7. Unzip it. Your installation directory should contain something like:
    psa_11.1.0/
    ├── LICENSE
    ├── NOTICE
    ├── bin/
    ├── conf/
    ├── lib/
    └── webapps/
  8. You should have received a license.properties file in an email from us that contains your license information. Keep this file ready. You will be asked to upload this file during the installation process.

Configure JAVA_HOME environment variable

Celoxis uses Java and for it to work correctly, the JAVA_HOME environment variable must be correctly set.

  1. Right click My Computer.
  2. Click Properties.
  3. Click the Advanced tab (or click Advanced system settings in Windows Vista.)
  4. Click the Environment Variables.
  5. Under System variables, click New.
  6. Set Variable name to JAVA_HOME and Variable value to the path of JDK e.g. C:\Program Files\Java\jdk1.8.0_05
  7. Click OK.
  8. Click OK on the Advanced tab to close the window.

Verify JAVA_HOME is correctly set

Open a command prompt and type java -version. You should see something like:

C:\>java -version
java version "1.8.0_05"
Java(TM) SE Runtime Environment (build 1.8.0_05-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.5-b02, mixed mode)
C:\>