Commit a6f1ccd0 authored by Laurent Meiller's avatar Laurent Meiller

Merge branch 'Callisto.10' into 2019.05

parents 019e2e05 0fcaebf6
......@@ -58,3 +58,15 @@ Files path summary table
+------------------------+-------------------------------------+-------------------------------------------------------------------------------------------------------+
| postgresql-11-main.log | /var/log/postgresql/ | Database log file. |
+------------------------+-------------------------------------+-------------------------------------------------------------------------------------------------------+
Connections to database and replication schema
==============================================
This schema shows required database connections between different types of servers.
These connections must be authorized in ``pg_hba.conf`` file. It is being done automatically or it is described in installation or upgrade documentation.
It also shows how asterisk database is replicated. Only configuration tables are replicated between asterisk databases
and only event tables (cel and queue_log) are replicated to stats database.
.. figure:: images/db_connections.png
:scale: 100%
.. _system_proxy:
*******************
Proxy Configuration
*******************
......@@ -10,43 +12,47 @@ it to work correctly.
Instead you should configure the proxy on a per service basis as described
below.
System Applications
===================
Installation and upgrade operations use different tools for which the proxy must be configured if any.
apt
===
---
.. important:: This is needed because apt is used for installation and upgrade
Create the :file:`/etc/apt/apt.conf.d/90proxy` file with the following content::
Acquire::http::Proxy "http://domain\username:password@proxyip:proxyport";
curl
----
dhcp-update
===========
*This step is needed if you use the DHCP server of the XiVO. Otherwise the DHCP configuration won't be correct.*
.. important:: This is needed because ``curl`` is used during installation and upgrade
Proxy information is set via the :file:`/etc/xivo/dhcpd-update.conf` file.
Create the :file:`~/.curlrc` file with the following content::
Edit the file and look for the ``[proxy]`` section.
proxy = http://proxyip:proxyport
proxy-user = "username:password"
docker
======
------
.. important:: This is needed because docker images will be downloaded during installation or upgrade
When upgrading or installing XiVO it will attempt to download docker images.
For the proxy configuration, you need to create a systemd configuration file.
See Docker documentation: https://docs.docker.com/config/daemon/systemd/#httphttps-proxy
provd
=====
Proxy information is set via the :menuselection:`Configuration --> Provisioning --> General`
page.
wget
====
----
*This step is needed because this tool is used by xivo-upgrade script.*
.. important:: This step is needed because this tool is used by xivo-upgrade script and install scripts
Create the :file:`~/.wgetrc` file with the following content::
......@@ -54,10 +60,35 @@ Create the :file:`~/.wgetrc` file with the following content::
http_proxy=http://username:password@proxyip:proxyport
XiVO Services
=============
Several XiVO services needs also the proxy to be configured, if any.
dhcp-update
-----------
.. important:: This is needed if you use the DHCP server of the XiVO. Otherwise the DHCP configuration won't be correct. It must be set before the wizard is run.
Proxy information is set via the :file:`/etc/xivo/dhcpd-update.conf` file.
Edit the file and look for the ``[proxy]`` section.
provd
-----
.. note:: This is needed to download plugins
Proxy information is set via the :menuselection:`Configuration --> Provisioning --> General`
page.
xivo-fetchfw
============
------------
*This step is not needed if you don't use xivo-fetchfw.*
.. note:: This is needed to download firmwares
Proxy information is set via the :file:`/etc/xivo/xivo-fetchfw.conf` file.
......
......@@ -8,7 +8,7 @@ System
DHCP Server <dhcp/dhcp>
Mail <mail/mail>
Network <network/network>
database
Database <database/database>
backup_restore
cli_tools/cli_tools
https_certificate
......
......@@ -10,5 +10,5 @@ The reporting is composed of four packages: pack-reporting, xivo-full-stats, xiv
These packages will feed the tables of the xivo_stats database:
- xivo-db-replication feeds the tables cel and queue_log in real time, and the configuration tables (dialaction, linefeatures, etc...) every 5 minutes
- xivo-full-stats feeds in real time tha tables call_on_queue, call_data, stat_queue_periodic, stat_agent_periodic and agent_position
- xivo-full-stats feeds in real time the tables call_on_queue, call_data, stat_queue_periodic, stat_agent_periodic and agent_position
- xivo-reporting-db and pack-reporting work together to feed the tables stat_queue_specific, stat_agent_queue_specific and stat_agent_specific every 15 minutes
\ No newline at end of file
......@@ -89,7 +89,7 @@ mobile phone it would usually be `0xxxxxxxxx@default`.
Usage
-----
Tha agent has to login using the custom line, the standard ccagent features are available. However, due to external line
The agent has to login using the custom line, the standard ccagent features are available. However, due to external line
some phone control features are not available - the agent can't answer, put on hold or transfer calls from the ccagent
interface. On the XiVO side, please ensure that the call distributed to the agent is canceled if the agent doesn't answer
before the call is answered by for example the voicemail.
......@@ -50,6 +50,36 @@ On *server1*:
* pass the Wizard
.. _xds_main_ami_configuration:
AMI configuration
-----------------
.. note:: Once a :ref:`media server is defined <xds_xivo-define_media_server>` in webi, Reporting Server will use
the VoIP interface for AMI connection to all media servers **and XiVO**. Here we authorize it on XIVO.
If XiVO CC is installed, do the following steps before adding media server.
Otherwise you can first define media servers and do these steps right after XiVO CC installation,
but before starting it to prevent problems with fail2ban.
#. Edit **existing** file :file:`/etc/asterisk/manager.d/02-xivocc.conf` to add permission for Reporting Server:
* ``permit`` to authorize the VoIP IP of the Reporting Server. E.g.:
.. code-block:: bash
...
deny=0.0.0.0/0.0.0.0
permit=10.32.5.9/255.255.255.255
permit=10.32.0.9/255.255.255.255
...
#. Apply the configuration::
asterisk -rx 'manager reload'
.. _xds_xivo-define_media_server:
Define Media Servers
......@@ -217,6 +247,8 @@ On *server3*:
* install a XiVO CC (see :ref:`ccinstallation`)
* configure it
* before starting it, change the :ref:`AMI configuration <xds_main_ami_configuration>` on XiVO.
Known Limitations
=================
......
......@@ -68,6 +68,8 @@ The installed Debian must:
Installation
^^^^^^^^^^^^
.. note:: If your server needs a proxy to access Internet, configure the proxy for ``apt``, ``wget`` and ``curl`` as documented in :ref:`system_proxy`.
Once you have your Debian stretch properly installed, download the XiVO installation script and make
it executable::
......@@ -76,7 +78,7 @@ it executable::
And run it::
./xivo_install.sh
./xivo_install.sh -a 2018.16-latest
At the end of the installation, you can continue by running the :ref:`configuration
wizard. <configuration_wizard>`
......
......@@ -90,4 +90,6 @@ On MDS
apt-get purge '^dahdi-linux-modules*' -y
* Run ``xivo-remove-postgres-94`` after dist-upgrade to remove postgres 9.4.
* Postgresql: check :file:`/var/log/postgresql/postgresql-11-main.log` for specific upgrade steps
......@@ -96,8 +96,6 @@ User And Agent Configuration
- When and agent is disassociated from its user, xuc server has to be restarted.
- We strongly advise to not delete any user or agent to keep reporting available for them.
Even so when an agent is deleted, xuc server has to be restarted,
- Restarting XUC server with active calls may result in :ref:`wrong agent's state <agent_states_after_xuc_restart>`.
Install from repository
=======================
......@@ -108,6 +106,8 @@ The installation and configuration of *XiVO CC* (with its *XiVO PBX* part) is ha
Install process overview
------------------------
.. note:: If your server needs a proxy to access Internet, configure the proxy for ``apt``, ``wget`` and ``curl`` as documented in :ref:`system_proxy`.
The install process consists of two parts:
#. The first part is to manually run the ``xivocc_install.sh`` script to install the dependencies (ntp, docker, docker-compose...) and which will trigger the *XiVO CC* installation.
......
......@@ -101,10 +101,8 @@ Check the XiVO PBX
Check PostgreSQL configuration
------------------------------
- Postgresql has to be configured to listen on all interfaces.
See `listen_addresses` in file :file:`/etc/postgresql/9.4/main/postgresql.conf`.
- Connection from the XiVO CC for user asterisk must be authorized.
See file :file:`/etc/postgresql/9.1/main/pg_hba.conf` which must contain a line::
See file :file:`/var/lib/postgresql/11/main/pg_hba.conf` which must contain a line::
host asterisk all 192.168.0.2/32 md5
- A user `stats` must exists. Use command ``\dg`` in psql.
......
......@@ -89,7 +89,7 @@ Behavior Changes
* Version was upgraded to version 16: note that diaplan application ``Macro`` no longer works and needs to be updated to use ``GoSub`` dialplan application.
* Language now defaults to fr_FR. To change it to english, one should:
* verify that the packages `asterisk-sounds-wav-en-us`, `xivo-sounds-en-us` are installed
* and set, in file :file:`/etc/asterisk/asterisk.conf` the *defaultlanguage* parameter to `en_US`
......@@ -133,7 +133,7 @@ Table listing the current version of the components.
+----------------------+----------------+
| db | 2019.05.09 |
+----------------------+----------------+
| outcall | 2019.05.08 |
| outcall | 2019.05.10 |
+----------------------+----------------+
| db_replic | 2019.05.00 |
+----------------------+----------------+
......@@ -159,9 +159,49 @@ Table listing the current version of the components.
+----------------------+----------------+
| xuc | 2019.05.06 |
+----------------------+----------------+
| xucmgt | 2019.05.08 |
| xucmgt | 2019.05.10 |
+----------------------+----------------+
Callisto.10
-----------
Consult the `Callisto.10 Roadmap <https://projects.xivo.solutions/versions/152>`_.
Components updated: **xivo-config**, **xivo-manage-db**, **xivo-outcall**, **xivo-upgrade**, **xivocc-installer**, **xucmgt**
**CCAgent**
* `#2687 <https://projects.xivo.solutions/issues/2687>`_ - [C] - Cannot scroll to the end of content panel when receiving a call
* `#2758 <https://projects.xivo.solutions/issues/2758>`_ - Webrtc agent is still ringing after logged out on CC agent on login page callisto
**Desktop Assistant**
* `#2648 <https://projects.xivo.solutions/issues/2648>`_ - Autolog user using token
**WebRTC**
* `#2482 <https://projects.xivo.solutions/issues/2482>`_ - Double ringbacktone on api dial for WEB RTC
**XiVO PBX**
* `#2358 <https://projects.xivo.solutions/issues/2358>`_ - Doc - Enhance installation and upgrade behind a proxy
* `#2587 <https://projects.xivo.solutions/issues/2587>`_ - Logrotate configuration for /var/log/postgresql/ should be created on fresh install and upgrade
.. important:: **On media servers upgraded from Borealis** to Callisto.00, 01 or 02, ``xivo-remove-postgres-94`` must be **re-run**
after dist-upgrade to remove postgresql-common.
* `#2618 <https://projects.xivo.solutions/issues/2618>`_ - XDS - DB on MDS can't be connected through unix socket after upgrade from Borealis
* `#2686 <https://projects.xivo.solutions/issues/2686>`_ - Hostname change is not taken into account
* `#2721 <https://projects.xivo.solutions/issues/2721>`_ - CallerID doesn't work with an external PBX
* `#2728 <https://projects.xivo.solutions/issues/2728>`_ - Download of Docker GPG key does not work behind a proxy
* `#2766 <https://projects.xivo.solutions/issues/2766>`_ - xivo-webi cannot display routes if your are on Edge or Chrome < v69
**XiVOCC Infra**
* `#2291 <https://projects.xivo.solutions/issues/2291>`_ - XiVO UC Installer does not set correct pgxivocc address in xivo/custom.env for db_replic
* `#2589 <https://projects.xivo.solutions/issues/2589>`_ - XiVO CC installation breaks the main XiVO PBX install if FQDN entered as xuc host
Callisto.09
-----------
......@@ -212,7 +252,7 @@ Components updated: **asterisk**, **config-mgt**, **dahdi-linux**, **xivo-backup
.. important:: When upgrading, it will install new ``dahdi-linux-dkms`` package with necessary dependencies. The removal of the old ``dahdi-linux-modules-*``
packages is handled during the upgrade on XiVO.
However this removal is not handled automatically during upgrade on MDS. Therefore, *on a MDS*, you MUST remove
them manually after the upgrade by running the command::
......@@ -318,7 +358,7 @@ Components updated: **xivo-config**, **xivo-db**, **xivo-manage-db**, **xivo-sys
**Web Assistant**
* `#2416 <https://projects.xivo.solutions/issues/2416>`_ - write flashtext to other connected users
* `#2416 <https://projects.xivo.solutions/issues/2416>`_ - write flashtext to other connected users
* `#2509 <https://projects.xivo.solutions/issues/2509>`_ - Display notification badge on callControl menu of UC Assistant and on Electron tray
* `#2511 <https://projects.xivo.solutions/issues/2511>`_ - Display multiple flashtext on callContol page
* `#2560 <https://projects.xivo.solutions/issues/2560>`_ - Make links clickable in flashtext
......@@ -444,7 +484,7 @@ Components updated: **config-mgt**, **recording-server**, **xivo-agid**, **xivo-
**Reporting**
* `#2048 <https://projects.xivo.solutions/issues/2048>`_ - XDS - UC history should work
* `#2048 <https://projects.xivo.solutions/issues/2048>`_ - XDS - UC history should work
* `#2424 <https://projects.xivo.solutions/issues/2424>`_ - Add scriplet to spagobi
**Web Assistant**
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment