Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DOC and version 8.2.0

...

Info
titleRequirements

Note: Python3, Docker, and Rabbit MQ services are used to support and run Managed Servers. Local customers planning on utilizing managed servers will need to either install these services, or contact support@6connect.com for assistance to accommodate specific network needs. 

Required installations are already included for Cloud hosted customers. 


Table of Contents

...

  • VM creation, management, and monitoring from within ProVision
  • Minimal requirements - Managed Servers only requires Python3 and Docker as dependencies
  • OS options include CentOS and Ubuntu
  • Supports both remote and manual setups
  • Supports both root and non-root installations (for the latter, some root steps may be required)
  • Installation and upgrade may be performed either via internet connection or locally:
    • Remote internet install/upgrade connects to 6connect's servers to get new versions
    • Local installs/upgrades will require users to upload the new version locally into their ProVision instance
    • No kernel updates or other system updates are required for local updates - only the Docker container will be updated.
  • Pre-defined Pre-and-Post Commands

Monitoring Features include:

...

These settings provide the "default" values for servers created from the Managed Servers Tab. 

After making any settings updates, be sure to click "Save Changes" under the updated module.

...

If RabbitMQ has not already been installed on your ProVision instance / VM, you will need to install it by running the included shell script (Note: Installing RabbitMQ requires internet access.):


1) Run install_rabbitmq.sh

...


This script is taken from Installing on Debian and Ubuntu — RabbitMQ and may need an update in future. Even better option would be to provide erlang and rabbit packages and install from them.

2) You may verify the installation is working by opening http://your.host:15672 

3) Once confirmed working, go to ProVision Admin Settings → Managed Server Settings. Then, enter the RabbitMQ IP, port, username, and password into the RabbitMQ Settings section. When done, click "Save Changes".

...

  • Default Monitoring API IP: The default IP to be used for API calls (heartbeat, activation, etc.) . This is the IP of ProVision's server, at which the managed servers will send API requests. This is because if systemd-resolved is stopped, it is highly possible that ProVision's host is not resolvable. For this reason we make the API requests similar to "curl https://194.24.189.120/api/endpoint -H 'provision.mycompany.com'". Here, we list the local IPs of ProVision for managed server monitoring and to send API requests, as multiple IPs may be available depending on the Provision set up.
    • Note: The Default Monitoring API IP can be set to a default value in this area, but it may also be set individually per managed server as an override.
  • Verify CA: Toggle to "on" if you wish to enable the CA check.
  • Communication type: Push (when the server pushes data to ProVision) and pull (when ProVision connects to the server and pulls the data). Push is preferred, but Pull-based may be desirable in cases where a firewall would not allow inbound connections to ProVision.
  • Monitoring of the system: Toggle to "on" to enable monitoring of system statistics.
  • System monitoring interval: How often (in seconds) the system will be checked. The smaller the interval, the more data there will be to store. 
  • Monitoring of the DNS: Toggle to "on" to enable gathering statistics from the DNS server.
  • DNS monitoring interval: How often (in seconds) the DNS server will be monitored. Data will be aggregated for the set period of time and the aggregated results will be sent. 
  • Raw data retention: The number of minutes to retain raw data. By default, this is set to 1440 minutes (1 day). Raw data requires sizable storage needs.
  • Aggregated data retention: The number of days to retain aggregated data.

...

Fill in the remaining update settings as applicable to the selected update mode:

  • Internet Docker Update (recommendedRecommended) - This uses a Docker update directly from our docker registry. Internet connection is required for the managed server in order this mode to work.
    • When this is chosen, fields to enter tokens for
    our gitlab/registry appear to be filled in:
    • the DNS / DHCP repository will displayed.
      Note
      For assistance obtaining repository tokens, please contact support@6connect.com.


Expand
titleUpdate Settings - Docker Update (Internet)...
Update Settings  - Docker Update Mode (Internet)

API timeout: Timeout for API calls in milliseconds.

Update Mode: Enter the source for updates, depending on internet accessibility. Two options are available:

  • ProVision Image Download (Local) - This option is for to update from ProVision, locally. No internet connection is required from the managed server. When this option is selected you have to get the image files from our gitlab and upload it in ProVision.   The relevant gitlab project is at https://git-lju.6connect.com/6connect/pv-monitor/-/releases, but an image file must be manually downloaded from a separate secure site and then uploaded into ProVision. 
Note

If "Image Download (Local)" is selected, you must download the image file from a secure 6connect site to then upload for this setting. Please contact support@6connect.com for credentials to access the image download area.

  • Internet Docker Update - This uses a Docker update directly from our docker registry. Internet connection is required for the managed server in order this mode to work. When this is chosen fields for tokens for our gitlab/registry appear to be filled in:
    • Update username: Enter the username for updates.
    • DNS update token: Enter the token for the DNS repository.
    • DHCP update token: Enter the token for the DHCP repository.
    • Monitoring update token: Enter the token for the Monitoring repository.
  • Test Tokens: Click to test the applied tokens for DNS, DHCP, and Monitor
. 4
  • .
Note
For assistance obtaining repository tokens, please contact support@6connect.com.


  • ProVision Image Download - If Update Mode is set to "Image Download (Local)", then no ProVision Image Download - This is for updates from ProVision. No internet connection is required from the managed server. When this option is selected you have to get the image files from our gitlab and upload it in ProVision.   The relevant gitlab project is at https://git-lju.6connect.com/6connect/pv-monitor/-/releases, but an image file must be manually downloaded from a separate secure site to then upload into ProVision. 


Expand
titleUpdate Settings  - Image Download (Local)...
Update Settings  - Image Download (Local)

If Update Mode is set to "Image Download (Local)", then the following settings will display to enter:

Image file: Attach the Image file for upload to ProVision.

API timeout: Timeout for API calls in milliseconds.

upload to ProVision.

Note

If "Image Download (Local)" is selected, you must download the image file from a secure 6connect site to then upload for this setting. Please contact support@6connect.com for credentials to access the image download area.

API timeout: Timeout for API calls in milliseconds.

Update Mode: Enter the source for updates - Image Download (Local), or opt to change to Docker Update (Requires Internet).Update Mode: Enter the source for updates - Image Download (Local), or opt to change to Docker Update (Requires Internet). If Image Download is selected, no internet connection is required from the managed server. When this option is selected you have to manually get the image files from our gitlab and upload it in ProVision.   The relevant gitlab project is at https://git-lju.6connect.com/6connect/pv-monitor/-/releases

Images history: Available only after saving changes.

Test Tokens: Click to test the applied tokens for DNS, DHCP, and Monitor. 

...