Avaya IPO - Server Installation

1.0. Chronicall Call Reporting Specs

Format

  • Downloadable setup file

Database

  • PostgreSQL

Web Server

  • Apache Tomcat

User Interface

  • Web Interface and Chronicall Desktop Application

Avaya IP Office

  • Release 4.0 - 9.1

IP Office Connection

  • Release 4.0 - 9.1: System Monitor
  • Release 10.0 and newer: Devlink3

Note: Devlink3 requires Avaya CTI Link License


Avaya Licenses Required

  • IP Office 10.0 + - CTI Link License

Virtual Machine

  • VM Ware

Chronicall Server Requirements

🚧

Installation Location

Chronicall cannot be installed on the same PC/Server as IP Office Server Edition or the Application Server.

  • Windows 7 or higher; Windows Server 2008 or higher; 32/64-bit Linux
  • 250 GB or more of available disk space
  • 4-8 GB or more of RAM
  • Quad-Core CPU (minimum)

Note: The chart below shows the amount of RAM required per Realtime Agent Seat.

Realtime Agent Seats1-1010-2526-5051-250250+ Agents
RAM4GB4GB6GB8GB8GB & 2nd Server for Realtime Node Software

User PC Requirements

  • Windows 7 or higher; 32/64-bit Linux
  • Internet Explorer
  • Java 7 or above
  • Javascript enabled

Recording Storage

The following chart details the number of days until the disk drive is filled up from recording. Use this information to determine your company’s needs.

1 Agent5 Agents10 Agents25 Agents
32 GB700140702814
250 GB5,4611,092546218109
500 GB10,9222,1851,092437218
1000 GB21,8454,3702,185875437

Assume 8 hours per agent, per day


VRTX CPU & Server Requirements

2.0. Chronicall Standard Installation

📘

SIP Trunk Utilization

If you are utilizing a SIP trunk, it is recommended (but not required) that a Port Mirror be utilized.

Note: It is recommended that no more than two devices are attached to the Chronicall Server. If more than two VRTX devices are needed, be sure that they are attached to separate, stand-alone servers. Three VRTX devices are supported per server. If encrypting recordings, additional memory may be needed. Refer to the chart below for memory requirements for the amount of VRTX devices and Recording Ports (RP)

CPU & RAM
1 VRTX - 10 RP:
* Standard Chronicall Server Specs
1 VRTX 11-23 RP:
* Single Chronicall PC w/2 GB RAM
2 VRTX up to 25 RP:
Single Chronicall PC w/2 GB RAM
Octa Core Processor/1 PC for Chronicall
* 1 PC for Recording
2 VRTX up to 46 RP:
1 PC for Chronicall
1 PC w/ 6 GB RAM & Quad Core CPU
3 VTRX up to 69 CPU:
PC w/ minimum Chronicall specs
PC w/8 GB Ram and Octa Core CPU

2.1. Chronicall

SETUP

Follow the steps through this installation guide in order to setup, install, and configure Chronicall and Recording Library.

  1. Read the End-User Agreement. Select "I accept the agreement" if you agree.
  2. Select the location where you would like Chronicall to be installed. C: is the default, but you may install it on the network drive of your choice.
  3. Input the serial key that was provided to you by Xima.
  4. On the PostgreSQL page, the port, user, and password are given to you by default. You may change the information if desired.
  5. The Web Server Port information will automatically populate. You may change this information if desired.

INSTALLATION

  1. Select install.
  2. Once the install is finished, open Internet Explorer and enter the given web address.

📘

Note

Internet Explorer is currently the only web browser that supports the required Java Plugin.

  1. Use the default Username and Password. You may change this later under user accounts.

3.0. Recording Library Installation

When installing Recording Library there are two standard choices:

  1. VRTX
  2. Voicemail Pro.
    Follow the steps under the specific section that matches your network needs.

3.1. Recording Library Setup for VRTX

With networks that have a VRTX, Chronicall will monitor the network traffic on the trunk that the VRTX is recording. Follow the following steps to install Recording Library for VRTX.


SETUP

  1. Download the VRTX Driver here. You will need to enter your Chronicall Serial Key before you can run the driver.
  2. Run the installer and follow the installation wizard.
  3. Go to Device Manager and confirm that VRTX is in the USB section.

INSTALLATION

When installing Recording Library for VRTX you have two choices depending on where you have Chronicall installed:

  1. If Chronicall and the Recording Library share the same server go to 3.1.a.
  2. If Chronicall and the Recording Library will not share the same server go to 3.1.b.

3.1.a Chronicall and the Recording Library share the same Server (VRTX)

If Chronicall and the Recording Library share the same server then the Recording Library may have already been installed. Verify or install the Recording Library by doing the following:

  1. Open your server’s local services and verify that the Chronicall Recording Library exists.
  2. If it does not exist, download and run the Chronicall Update (not the Recording Library set up).
    a. When prompted to install the Recording Library on this machine select “Yes”.
    b. Follow the installation and when done repeat Step 3.1.a 1.

🚧

Note

It is not recommended having Chronicall and the recording library share the same server.


3.1.b Chronicall and the Recording Library do not share the same Server (VRTX)

If Chronicall and the Recording Library do not share the same server then the Recording Library requires a separate setup file to be installed on the server where Chronicall is not installed.
Install the Recording Library by doing the following:

  1. Download the Recording Library Setup or App Installer (for Chronicall 3.95 and above) here. You will need to enter your Chronicall Serial Key.
  2. Follow the install steps.
    a. When prompted to enter the Avaya Call Reporting IP Address enter the server address where Chronicall is installed, not the server where Recording Library will be installed.

3.2 Recording Library Setup and Installation for IP Office

With networks that have Voicemail pro and Windows there are two options when setting up the Recording Library. Follow the steps under the appropriate section that corresponds best with your network settings.


3.2.a Chronicall and Voicemail Pro share the same Server (Windows)

If Chronicall and the Recording Library share the same server that is hosting Voicemail Pro, then the Recording Library may have been installed. Verify or install the Recording Library by doing the following:

  1. Open the server’s local services and verify that the Chronicall Recording Library service exists.
  2. If the Recording Library service does not exist do the following:
    a. Download an Chronicall update here. (You will need to enter your Chronicall Serial Key.)
    b. Run the Chronicall update.
    c. Select “Yes” when prompted to install the Recording Library.
  3. Go to section 4 to configure the Recording Library after you ensure the Recording Library has been installed.

3.2.b Chronicall and Voicemail Pro do not share the same Server (IP Office)*

If Chronicall and the Recording Library do not share the same server that is hosting Voicemail Pro then installing Recording Library requires a separate setup file to be installed on the server with Voicemail Pro. To install the needed separate file follow these steps:

  1. Download the setup file here (You will need to enter your Chronicall Serial Key.)
  2. Follow the steps through the installation
  3. Go to section 4 to configure the Recording Library after you ensure the Recording Library has been installed.

3.3 Recording Library Setup for Voicemail Pro on Linux

With networks that have Voicemail pro and Linux, there are three options when setting up the Recording Library. Follow the steps under the appropriate section that corresponds best with your network settings.


3.3.a Chronicall and Voicemail Pro share the same Server (Linux)

If Chronicall and the Recording Library share the same server that is hosting Voicemail Pro, then the Recording Library may have been installed. Verify or install the Recording Library by doing the following:

  1. View the /etc/init.d directory and look find recording_library.
  2. If it does not exist, download and run a Chronicall Update (not the Recording Library setup).
    a. Download the Chronicall Update for Linux here (You will need to enter your Chronicall
    b. Navigate to the directory where the setup file was downloaded: cd download_location.
    c. Unzip the downloaded file: unzip ipo_3_8_chronicall_update_3_8_1.zip.
    d. Navigate to the new directory: cd ipo_3_8_chronicall_update_3_8_1
    e. Log in as the root user and run a command to change update.sh into an executable file: chmod +x ./update.sh. f. Launch update.sh: ./update.sh

3.3.b Chronicall and Voicemail Pro do not share the same Server (Linux)*

If Chronicall and the Recording Library do not share the same server that is hosting Voicemail Pro then installing Recording Library requires a separate setup file to be installed on another server that can communicate with the Chronicall server and the Voicemail Pro server. To install the needed separate file follow these steps:

  1. Download the setup here
  2. Change to a common directory.
    a. Ex. The Administrator home directory: cd/home/Administrator
  3. Download the Recording Library Setup for Linux onto the Linux server.
    a. Right click the Recording Library download and select Copy Link Address.
    b. Enter: wget -0 recording_library.zip “Enter download link from step a here”
  4. Unzip the downloaded file: unzip ipoffice_chronicall_update_3_6_50.zip
  5. Run a command to change update.sh into an executable file: chmod +x update.sh
  6. Launch update.sh: ./update.sh

3.3.c Setup Samba to Share Recordings

The Samba files need to be updated so that the right directory is shared and so users can access the shared directory. For your convenience, these files have already been modified and will need to be downloaded then replace the previous files.
Follow these steps:

  1. Change to a common directory
    a. Ex. The administrator directory: cd/home/Administrator
  2. Download the Samba files: wget http://media.ximasoftware.com/tools/smbfiles.zip
  3. Stop the Same files: service smb stop
  4. Unzip the downloaded file: unzip smbfiles.zip
  5. Replace the old samba files with the newly downloaded ones:
    a. mv -f subusers /etc/samba/
    b. mv -f smb.conf /etc/samba/
  6. Start the samba service and set the service to begin at bootup:
    a. service smb start
    b. Configure smb on
  7. Give the VRL folder full permissions: chmod 777 /opt/vmpro/VRL

4.0. Recording Library Configuration

When installing Recording Library there are three standard choices: VRTX, Voicemail Pro for IP Office Windows, and Voicemail Pro for IP Office Linux. Follow the steps under the specific section that matches your network needs.


4.1. VRTX Recording Library Configuration

SETUP

  1. Open Chronicall once you have installed Recording Library
  2. Go to System Settings -> Recording Library
  3. Click on the ellipsis next to “Recording Libraries”
  4. Click “Add”
  5. Select the Recording Library Type
    a. Xima VRTX only
    b. Xima VRTX or VM Pro

SETTINGS CONFIGURATION

Edit the following fields:

  1. Recording Library IP Address: Enter the IP Address of the server where the Recording Library was installed.
  2. Chronicall Server Address:
    Enter the Chronicall Server IP Address.
  3. Recording Storage Location: Configure where the recordings will be stored. The default will be the recording Library directory. You will also be able to manage your retention policies here.

Configuration of SFTP for Windows (Chronicall Version 3.10.2d and newer)

As of Chronicall release 3.10.2d, the Chronicall Recording Library now has a built in SFTP for Windows. This removes the need for the use of the Freeftpd software.

Note: *Before configuring the SFTP, ensure that the Chronicall Recording Library (version 3.10.2d or later) has been installed.
To configure the SFTP follow these steps:

  1. Open Chronicall once you have installed Recording Library
  2. Go to System Settings -> Recording Libraries
  3. Click on the ellipses (...) next to "Recording Libraries".
    a. Select the desired Recording Library
    b. Select "Edit.
  4. Select the ellipses to the right of "Recording Library FTP Server Configuration"
  5. Check the "Enable Recording Library FTP Server" box.
    a. Enter a desired username and password for the SFTP to use
    Note: Make note of the selected username and password as they will be used further on.
  6. Restart the Recording Library service.

Test SFTP and Configure the VM Pro

From the Linux or Windows terminal of the Voicemail Pro, you can test to ensure that it can connect to the SFTP by using a command as seen in the example below:

SFTP [email protected]

436

Note: Replace "Administrator" and the IP with the username created in step 5a and the IP address of the Recording Library machine.

If you receive an error saying the key is invalid, navigate to the known_hosts file at the location specified in the error and remove any lines with the ip of the Recording Library server. Then, save the file, then try the SFTP command again.


Voicemail Pro SFTP Configuration

  1. Open the Voicemail Pro Client and login
  2. Click the "Administration" option at the top of the screen.
    a. Select "Preferences"
    b. Select "General"
  3. Go to the voicemail recording tab and enter the following settings
    a. FTP Username: Username configured in step 5a
    b. FTP Password:
    Password configured in step 5a
    c. Remote FTP Location: /
    d. Remote FTP Host: IP Address of the Recording Library server.
    See example below
487
  1. Click "Test Connection"
    If the connection is successful then you should be good to go. If the connection is not successful review the above steps.

If you received a message saying the connection was successful in step 4 but you are still not seeing recordings, access the "Limbo" folder of the Recording Library. Try restarting the VMPro.

Note: *It is possible to keep the Monitored directory pointed to the Live folder, as the / on the Remote FTP Location tells VMPRO to put the recordings into Limbo.

You will need to schedule an after-hours reboot for VMPRO to apply the changes.


Changing the Language

❗️

Before Changing the Language

When changing the language, the list of Chronicall Standard Reports will not switch to the new language. Rather, the existing English reports will stay, and the new language counterparts will be added to the list. In other words, your list of reports will contain each report in English and a duplicate report in the selected new language.

If you don't want the English version of the reports to remain, you can delete all existing English reports before doing the language download. Simply select all reports in Standard Reports, right click, and select "Delete."

To Change the Language

  1. Upon logging into Chronicall, select "Admin (System)" from the options along the top of the page
  2. Select "Download Translation"
  3. Select your desired language
  4. Hit "OK"

Once the download is complete, the Standard Reports will now contain all standard reports and all future Realtime wallboards from this point on will be in the selected language.

📘

A Note on the Realtime Wallboards

If any Realtime wallboards have been created prior to the download of the new language, the previously created wallboards will remain in English. However, any wallboards created after the language download has been performed will be presented with the downloaded language.