Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


In this section you can find the Universal Bar prerequisites and installation steps.

Please refer to this section for the old xCally Phone Bar installation and use.




Prerequisites

General Requirements

  • Secure Connection must be enabled
  • xCALLY details: IP address and port

  • User name and password for Agent configuration access


Info
titleShuttle Compatibility

Note that for correct operation, the xCALLY Universal Bar requires at least version 2.4.74 of xCALLY Shuttle


Software

The following software is required for the installation of the Universal Bar ApplicationIf not already installed, the installer will attempt to download and install the software before allowing Universal Bar installation:


Info
titleImportant notice

If you run the Motion bar on Windows 7, it's particularly important that you install the above vcredist_x86.exe


  • Enable Microsoft .NET Framework 3.5 in Control Panel (Note: Must have administrative rights)

    You can enable the .NET Framework 3.5 through the Windows Control Panel. This option requires an Internet connection.

    1. Press the Windows key Windows Windows logoImage Removed on Windows (the logo on your keyboard), type "Windows Features", and press Enter. The Turn Windows features on or off dialog box appears.

    2. Select the .NET Framework 3.5 (includes .NET 2.0 and 3.0) check box, select OK, and reboot your computer if prompted.

      Installing .NET with the control panel


You don't need to select the child items for Windows Communication Foundation (WCF) HTTP Activation and Windows Communication Foundation (WCF) Non-HTTP Activation unless you're a developer or server administrator who requires this functionality.

If you encounter errors during the .NET Framework 3.5 installation please refer to the following pages:

https://docs.microsoft.com/en-us/dotnet/framework/install/dotnet-35-windows-10

https://support.microsoft.com/en-us/help/2734782/net-framework-3-5-installation-error-0x800f0906-0x800f081f-0x800f0907

http://bit.ly/2rYdofs


User PC Requirements

The following are the minimum and recommended requirements for the Universal Bar.


Features

Requirements

Processor

Minimum: Pentium 4 2.4 GHz or equivalent.

Optimal: Intel Core 2 Duo or equivalent.

Memory

Minimum: 1 GB RAM

Optimal: 2 GB RAM

Hard Disk Space

50 MB

Operating System

Microsoft Windows 7

Microsoft Windows 8

Microsoft Windows 10

Connection

IP network connection (broadband, LAN, wireless)

Sound Card

Full-duplex, 16-bit or use USB headset


Info

The Motion Universal Bar is available only for Windows.

If you have other OS you can use external SIP phones and log into the xCally Agent web interface.

Here some SIP phones for Linux:

https://jitsi.org/
http://www.linphone.org/
http://www.ekiga.org/


Multimedia Device Requirements

The Universal Bar require both speakers and a microphone to make calls. Any of the following configuration are acceptable:

  • External speakers and microphone

  • Built-in speakers and microphone

  • Dual-jack multimedia headset

  • USB multimedia headset.

  • USB phone


Info
titleFirewall

Remember you need at least ALL the following open ports to/from your xCally server and your agent Universal Bar.

TCP: 80, 443, 5060, 5061

UDP: 5060, 5061 and the whole range from UDP 10000 up to 20000 included

ICMP: open! You need to be able to ping your XCALLY server from the agent computers

Please look also at the CentOS iptables rules and modify those in the file: /etc/sysconfig/iptables adding new IP addresses where and when you need. The command service iptables restart will apply the new rules you have modified.
The following commands will stop and remove your iptables firewall - in case you would like to prefer to manage the security with another external firewall:
service iptables stop
chkconfig iptables off 


Info
titleNAT

When you install the XCALLY server behind NAT, you need to properly setup the parameters externip and localnet
(otherwise you will probably have no audio properly working)

You can setup those parameters inside the Web section Settings - Network

Suppose you have the following network details on your XCALLY server:
Private IP address
and mask configured inside the Linux machine = 192.168.5.37 mask 255.255.255.0 (ifconfig Linux command to check)
Public IP address
to reach the server = 54.233.4.6

It means you will need to configure the following Settings - Network parameter on the xCally interface:
externip: 54.233.4.6
localnet: 192.168.5.0 mask 255.255.255.0


You DO NOT need to setup externip or localnet if the XCALLY server is NOT behind a NAT



Installation Procedure


Download and Install the Motion Universal Bar: 

setup.msi   

using Google Chrome, Firefox or MS Edge to download the setup.


The installer will first check for software pre-requisites or will attempt to download and install them






Info

If you use the Safari browser you will need to rename the file from Setup.msi.exe to Setup.msi










At the end of the download, the Universal Bar installer procedure will start automatically










Click Next and then select where the software must be installed and how it can be started (for ease of maintenance only change the destination folder if absolutely necessary)


Info
titleInfo

Default XCALLY Universal Bar log file is located at:

%USERPROFILE%\xCALLY\Logs









Click Close to complete the installation

When the software installation has been completed, double click on the Desktop Universal Bar Shortcut:


When the Universal Bar starts, enter the information necessary for logging in:

  1. Host: Enter the IP address of the xCALLY System. Use Your Server IP address (i.e. 192.168.1.10)

  2. Username: This should match the user’s xCALLY Agent Name.

  3. Password: This should match the user’s xCALLY Agent Password.















Info

When you install xCally for the first time, you can use the following demo accounts in order to make some tests:

Username: john.doe or jane.miller
Password: shuttle55



If the PC is running the Window firewall, you may be prompted whether to allow the Multichannel Universal Bar application to connect. In this case select Allow Access:






Now you can make a test call using the Universal Bar (i.e. dial the 600 extension for the echo test, or 6000 for the support test queue in the dialpad)

          












Info

If the PC has a different firewall, the prompts and method for allowing connection may differ