Installing 13.5

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.

Preparing for Installation

  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. If your email server is unreliable or does not support plussed addressing, consider using Gmail.
  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 Java Development Kit v8 (JDK 8). We recommend Amazon Correto which is a no-cost, multiplatform, production-ready distribution of the Open Java Development Kit (OpenJDK). Download from Amazon's Java 8 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.
    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:\>

    1. Open a terminal and login as the user on whose behalf Celoxis application will be started.
    2. In the appropriate profile file depending on the shell you use (e.g. .bash_profile or .profile for bash), type: export JAVA_HOME=/usr/java/jdk1.8.0_05 replacing the path with the correct directory in which Java 8 was installed.
    3. Save the file.
    4. Logout and Login again.

    Verify JAVA_HOME is correctly set

    Open a shell and type $JAVA_HOME/bin/java -version. You should see something like:

    $ $JAVA_HOME/bin/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)
    $

  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.

Before you proceed

Before you proceed, keep the following handy:

  • The license.properties file sent by our support team.
  • The database user and password.
  • A host name which your users will use to access Celoxis e.g. celoxis.acme.com
  • A location for the data directory. This is the directory that will store files, search indices and other files. At least 10 GB should be free. Also, this directory should not exist. We recommend that you store it as a subdirectory of the installation directory and name it data. So if you have installed celoxis in D:\celoxis, then the data directory should be D:\celoxis\data.

Start Celoxis

  1. Open a command prompt
  2. Type %JAVA_HOME%\java -version.
  3. You should see something like:
    C:\> %JAVA_HOME%\java -version
    java version "1.8.0_131"
    Java(TM) SE Runtime Environment (build 1.8.0_131-b11)
    Java HotSpot(TM) 64-Bit Server VM (build 25.131-b11, mixed mode)
  4. Go to the Celoxis installation directory – cd C:\celoxis
  5. Run the startup.bat file – psa_13.5.x\bin\startup.bat

  1. Open Terminal
  2. Type $JAVA_HOME/java -version.
  3. You should see something like:
    $ $JAVA_HOME/java -version
    java version "1.8.0_131"
    Java(TM) SE Runtime Environment (build 1.8.0_131-b11)
    Java HotSpot(TM) 64-Bit Server VM (build 25.131-b11, mixed mode)
  4. Go to the Celoxis installation directory – cd /usr/local/celoxis
  5. Run the startup.sh file – psa_13.5.x/bin/startup.sh

Install Celoxis

  1. Open http://your-server-name:8888/ in browser.
  2. Click on the Install button.
  3. Read the EULA and click Agree if you agree to the terms.
  4. Choose a site admin password between 8 to 10 characters.
  5. Upload the license.properties file sent by us.
  6. You will be shown the license details. Verify its correctness.
  7. Choose your database and enter the database username and password.
  8. Enter the data directory path. Double check that it does not exist.
  9. Press OK.
  10. On the "Add Company" form, add your details. We recommend that your Company code be the second level domain i.e. if your domain name is acme.com, then enter acme here. Enter the Celoxis URL to be http://your-server-name:8888.
  11. You should be taken to a sample Dashboard
  12. You can now move on to the site settings chapter to configure some advanced settings.