Commit 7350032a authored by Etienne Allovon's avatar Etienne Allovon

2720 - enhance proxy configuration page

parent d0cd8e9b
.. _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.
......
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