3.9.5 and Newer

Notes:

To obtain the file, you can either use "wget" or an SFTP software (like WinSCP or FileZilla) to move the downloaded file over to the new server. In this example, we will be using "wget"
- To use the "wget" command, your Chronicall server will need full internet access to download the Chronicall software. Otherwise, it will not work
We do not require the download of Java to run newer versions of Chronicall. We have an embedded JVM to handle that task now.

Obtain your download link. This can be done by putting your full serial key into our downloads site
Locate your respective OS iteration of Chronicall.
- For our example, we will be downloading the Debian iteration
Right-click and select "Copy Link Address"
In your terminal, navigate to the desired directory and type the following:
```
wget -O 'chronicall-setup.tar.gz' 'https://(rest of the link that was copied from Chronicall)'
```
- It should look something like this:
  
  After you have typed out the command, run it, and let the download proceed. It may take a while depending on your network connection.
After the download is complete, you should see a new tar.gz file. To expand it, run the following command:
```
tar -xzf <file-you-downloaded>.tar.gz
```
It should look like this (Red, below):

After you run the command you should now have a new directory, navigate into the new directory (Orange, above).
If you are running a standard install (no variation to install path beyond root), the only required parameter is -serial followed by your serial key
- ```
./install.sh -serial YOURXIMASOFTWARESERIAL**********
```
  - NOTE: If you are installing Chronicall in demo mode, use -demo instead
- If you aren't running a standard install, type -help instead of the -serial switch at the end for installation options
  - For example, here's what that looks like:
You can access the web client from any network computer by opening your web browser and navigating to http://Server_Name_or_IP:9080
- If you specified a different base port, replace 9080 with that port number
- If Chronicall does not start automatically, you may need to stop and start Chronicall's Windows services.
After following the installation guide, if you run into additional issues please reach out to Xima Support.

3.9.4 and Older

Chronicall can be installed on Debian and Red Hat-based (Red Hat, CentOS, and Fedora) Linux servers.

Note: You must have Oracle's Java 7 or 8 installed
- You can check the java version by typing java -version

This article shows how to manually set the correct Java path if another Java, like Open JDK, is in use.

You can download the setup file, as well as other Linux-specific files, from our downloads page.

Open the command terminal and navigate to the directory where the setup file was downloaded and unzip the downloaded file using unzip, followed by the filename
- Example:
  - ```
  unzip ipoffice_chronicall_rpm_64_setup_3_6_12.zip
```
- NOTE: If the unzip command fails to work, you may need to install it according to your Linux Distro
  - For Ubuntu & Debian
    - ```
    sudo apt install unzip
```
- For CentOS & Fedora
  - ```
  sudo yum install unzip
```

Navigate into the new directory using cd.

cd ipoffice_chronicall_rpm_64_setup_3_6_12

At this point, log in as the root user if you haven't already done so
Run a command to change the install.sh into an executable file
- ```
chmod +x install.sh
```
The last step to launching the installer is running ./install.sh
- You can add parameters to specify settings, but any that you do not specify will be given default values and can be changed later in Chronicall's system settings
If you are running a standard install (no variation to install path beyond root), the only required parameter is -serial followed by your serial key

If you are installing Chronicall in demo mode, use -demo instead.
```
./install.sh -serial SERIALKEY1234567890ABCDEFGHIJKLM
```
If you do not have a serial key, please contact your Xima Reseller or the Xima sales team

Once the installation is finished, Chronicall should begin running
You can access the web client from any network computer by opening your web browser and navigating to http://Server_Name_or_IP:9080/chronicall.html
- If you specified a different base port, replace 9080 with that port number
- If Chronicall does not start automatically, you may need to stop and start Chronicall's Windows services.

Example of Linux Install

[root@primaryipo ~]# wget -O chronicall_download.zip 'http://rest.ximasoftware.com/chr/download?serial=SERIALKEY1234567890ABCDEFGHIJKLM&type=ipoffice&os=linux&param=chronicall&param=setup&param=rpm_64'
--2014-07-25 10:26:54--  http://rest.ximasoftware.com/chr/download?serial=SERIALKEY1234567890ABCDEFGHIJKLM&type=ipoffice&os=linux&param=chronicall&param=setup&param=rpm_64
Resolving rest.ximasoftware.com... 174.143.255.51
Connecting to rest.ximasoftware.com|174.143.255.51|:80... connected.
HTTP request sent, awaiting response... 200 OK
Length: 132598961 (126M) [application/zip]
Saving to: chronicall_download.zip
100%[================>] 132,598,961 6.24M/s   in 21s
2014-07-25 10:27:15 (6.16 MB/s) - chronicall_download.zip saved [132598961/132598961]

[root@primaryipo ~]# unzip chronicall_download.zip
Archive:  chronicall_download.zip
   creating: ipoffice_chronicall_rpm_64_setup_3_6_4/
  inflating: ipoffice_chronicall_rpm_64_setup_3_6_4/README.txt
  inflating: ipoffice_chronicall_rpm_64_setup_3_6_4/eula.html
  inflating: ipoffice_chronicall_rpm_64_setup_3_6_4/install.jar
  inflating: ipoffice_chronicall_rpm_64_setup_3_6_4/install.sh

[root@primaryipo ~]# cd ipoffice_chronicall_rpm_64_setup_3_6_4/

[root@primaryipo ipoffice_chronicall_rpm_64_setup_3_6_4]# sh install.sh -serial SERIALKEY1234567890ABCDEFGHIJKLM 

JInstallationFramework loaded.
The default Chronicall port range 9080-9089 is unavailable. The next 10 port range available is 9090-9099. Would you like to use this range? (y or n) y
It appears that Chronicall is already installed. Continuing this installation process will destroy any existing Chronicall data.
Would you like to continue installing Chronicall? (y or n) y
Attempting to stop chronicall and postgres if running...
Installing Chronicall...
Setting Up System...
Copying Web Server Installation Files...
Copying Web Server App Files...
Configuring Web Server...
Copying Postgres Files...
Setting Up Database...
Setting Up services...
Copying Chronicall Jars...
Deleting Temporary Postgres Files...
Starting Web Service...
Installation Complete!
Start/Stop Commands:
        service chronicall start
        service chronicall stop
Go to http://10.0.1.6:9090 in a browser to access Chronicall

{[{category.name}]}

Linux Installation

3.9.5 and Newer

Notes:

3.9.4 and Older

Table of Contents

Environment

Operating System

PBX System

Chronicall Version