Smart Proxies

The smart proxies page can be accessed via The Infrastructure Menu:

Infrastructure > Smart proxies

Smart proxies are autonomous orcharhino components that may run on a separate host from the main orcharhino installation. A given smart proxy will handle the communication between orcharhino and one or more network services external to orcharhino (for example with VMware’s vSphere virtualization solution).

Since smart proxies are autonomous, they can be used by orcharhino to communicate with network services in other networks. In such a scenario the smart proxy would be located in the same network as the network services in question.

The communication between orcharhino and its proxies is encrypted and uses very few ports. This way orcharhino can connect to services within a DMZ, without constituting a threat to IT security. When proxies are placed close to the relevant services this can also help with latency within large distributed networks.

The main orcharhino installation will always come bundled with an integrated smart proxy (with a complete feature set), such that the host orcharhino is installed upon can function as the sole smart proxy for many use cases.


The smart proxies page contains a Create Smart Proxy button, and a list of smart proxies known to orcharhino (as mentioned above, this list will always include the host orcharhino itself is installed upon):

List of known smart proxies
  • Clicking on the name of a smart proxy in the Name column (3) of the list (2), will take you to the smart proxy overview page for that smart proxy. (See Viewing a Smart Proxy below).
  • Clicking on the Create Smart Proxy button (1) will open the create smart proxy window. (See Creating a Smart Proxy below).
  • Selecting Edit from the Actions column (4) will take you to the edit smart proxy page for that smart proxy. (See Editing a Smart Proxy below).
  • Selecting Delete from the Actions column (4) will delete the smart proxy entry from the list of smart proxies.
  • Selecting Refresh from the Actions column (4) will refresh the list of Features supported by the smart proxy. (This is useful when additional features are installed).
  • Selecting Certificates from the Actions column (4) will take you to the Certificates tab, on the Puppet CA tab of the smart proxy overview page for that smart proxy. (See Viewing a Smart Proxy below).
  • Selecting Autosign from the Actions column (4) will take you to the Autosign entries tab, on the Puppet CA tab of the smart proxy overview page for that smart proxy. (See Viewing a Smart Proxy below).

Creating a Smart Proxy

The create smart proxy window can be accessed via the Create Smart Proxy button:

Infrastructure > Smart proxies >> Create Smart Proxy

Note

Clicking the Create Smart Proxy button, does not actually “create” a smart proxy, rather it serves to add a preexisting smart proxy to the list of smart proxies known to orcharhino. (See also: Smart Proxy Guide).

When adding a smart proxy to orcharhino you must provide a name, and the URL where the smart proxy resides (this URL must be resolvable on the orcharhino host):

Adding a smart proxy
  • The Name (1) should be something meaningful that allows users to identify the network the smart proxy is located in (e.g.: <hostname>.<domain>).
  • The URL (2) would typically have the following layout: https://<hostname>.<domain>:<port> (See also the Smart Proxy Guide for more information on setting up smart proxies).
  • You should assign a context to your smart proxy via the Locations and Organizations tabs (3). (See also: The Context Menu).
  • Remember to click Submit (4) to save your changes.

Editing a Smart Proxy

The smart proxy editing page (for a given smart proxy) can be accessed via the list of smart proxies:

Infrastructure > Smart proxies >> list of smart proxies > Actions column > Edit

This page is essentially the same as the create smart proxy window, with the difference that fields will be prefilled with the settings of the proxy being edited:

Edit a smart proxy

Viewing a Smart Proxy

The smart proxy overview page (for a given smart proxy) can be accessed via the list of smart proxies:

Infrastructure > Smart proxies >> list of smart proxies > name of a smart proxy

A smart proxy overview page displays a wealth of information about the selected smart proxy, and the host it is running upon. (Including but not limited to, the full list of services/features enabled on the smart proxy, log messages, puppet information, and pulp storage information). It also includes a Back button, an Actions drop down menu, an Edit button, and a Delete button:

Structure of the smart proxy page
  • The Back button (1) will take you back to the smart proxies page.
  • The Actions drop down menu, the Edit button, and the Delete button collectively (2), cover most of the actions available through the actions column of the list of smart proxies on the smart proxies page (see Smart Proxies above for more information).
  • Note that there are several tabs (3) on the smart proxy overview page (see below for more information).

The Overview tab of the smart proxy overview page looks as follows:

Overview of a configured smart proxy
  • The Overview tab lists details about the smart proxy, like it’s URL (with port), version, and active features.
  • The Overview tab also lists pulp storage information.

The Services tab of the smart proxy overview page looks as follows:

Services provided by a smart proxy
  • The Services tab lists details (like version information) on each service supported by the smart proxy.

The Logs tab of the smart proxy overview page looks as follows:

Logs of a smart proxy
  • The Logs tab shows a list of logs for the smart proxy.
  • Logs can be filtered by filter level (via drop-down menu) or via the search bar provided.
  • The Refresh button will refresh the list of logs to include all the most recent logs.
  • Note that selecting Expire logs from the Actions drop down menu, will hide all logs older than the current time. (After selecting Expire logs the logs list will display exactly one log, since the expire logs action, will itself launch a loggable event).