.. _web-external-proxies:

Web External Proxies
---------------------

.. _21.1|VOSS-772:

.. index:: web;web external
.. index:: web external; web external add; web external del; web external list

*On a web proxy node only*, remote server proxies can be managed.

The commands should be run on the relevant web proxy node.

The commands to add or remove remote server proxies will automatically
reconfigure and restart the nginx process, so some downtime will result.

* To *add* remote server proxies and ports, run the command on the relevant node: 

  **web external add <URL> <remote IP:port>**


  Note the ``<URL>`` can include a path, for example:

  ``http://172.49.90.53:8888/myurl/set``

  so that when the proxy URL is then entered as ``https://<vossIP>/myproxy/``,
  this will then resolve to ``http://172.49.90.53:8888/myurl/set``.


* To *remove* remote server proxies, run the command on the relevant node: 

  **web external del <URL>**

* To *list* configured remote proxies on a web proxy node,
  run the command on the relevant node: 

  **web external list**

For example, adding, listing and removing remote servers:
  
  ::

     platform@VOSS:~$ web external add myproxy http://172.49.90.53:8888
     Updating the locations requires the web server to be restarted.
     Do you wish to continue? y
     You have new mail in /var/mail/platform
     
     platform@VOSS:~$ web external list
         external: 
             myproxy: 
                 upstream: http://172.49.90.53:8888
     
     platform@VOSS:~$ web external del myproxy
     Updating the locations requires the web server to be restarted.
     Do you wish to continue? y
     You have new mail in /var/mail/platform

     platform@VOSS:~$ web external list
         external: value not set