Deploying Votiro Cloud
General Guidelines
To run a successful installation, you need to relate parameters in inventory.yaml. The file is located at /root/ansible-initcluster/inventory.yaml. That's the only file that needs to be updated prior to running the installation:
| n | 3 Key Configurations before running the script install-paralus-playbook.yaml |
| t | Network Configurations: Use the file named 00-installer-config.yaml (located under /etc/netplan) |
| t | Define Configuration Parameters: Use the file named inventory.yaml (located under /root/ansible-initcluster) |
Note: You must configure the NTP (Network Time Protocol) server to be valid and accessible at all times to avoid major issues in our product.
Recommendation for external storage: We recommended working with an external NFS (Network File System) for handling larger volumes or to enhance performance (e.g., to achieve a high sanitization rate). External storage can provide greater flexibility and can accommodate larger file sizes beyond the temporary internal storage limit, ensuring that your operations continue smoothly without interruption. Working with internal storage can cause system errors if temporary internal storage exceeds the maximum. In that case, the system will return an error and sanitization will be enabled only after the temporary storage returns to normal operation.
| a. | Access the first virtual machine with VMRC. |
| b. | Use the credentials that were supplied separately. |
| c. | To switch to the root user, type sudo -i in the terminal. |
| d. | Change hostname command: |
hostnamectl set-hostname NODE_NAME
| f. | Edit (vi) the file named 00-installer-config.yaml to edit VM network settings. |
| g. | Edit lines 8, 11, and 13 (machine address, gateway, DNS address). You must use the prefix / to define the network size. See the example below: |
| i. | Apply network configurations: |
netplan apply
| j. | Repeat on the other VMs. |
| n | Mandatory configurations for fresh install: |
| t | In the 3 nodes configuration, add the node IPs under the hosts: section of the file. |
| t | In the 5 nodes configuration, add the first 3 node IPs under the hosts: section. This will make them the cluster’s master nodes. Uncomment the agent: section and add the IPs of the rest of the nodes there. These nodes will be worker nodes. |
| t | approve_votiro_eula: should be set to yes |
| t | controlplane_vip_address: should receive an unused IP to be used for internal purposes. |
| t | paralus_web_vip: should either receive an unused IP to be used by the system’s load balancer, or leave empty for an external load balancer. |
| t | votiro_cluster_fqdn: should contain the applicable FQDN for the system |
| n | Additional configurations: |
| t | safe_browsing_enabled: set to true or false for Online / Offline mode for safe browsing. |
| t | In fresh install mode, the tenant_id and system_id should be left empty (they are generated automatically). |
| t | In upgrade mode, fill the tenant_id and system_id fields with the data from the previous environment. |
| t | blob_nfs: is to be used if a customer wants to save the original and sanitized files in an external storage. Can be left empty for internal blob storage.
Example value (can use hostname): |
10.10.11.11:/nfs_share_path
| t | file_cache_nfs: is used to achieve better performance for the system. Can be left empty for an internal storage usage.
Example value (can use hostname): |
10.10.11.11:/nfs_share_path
| a. | From the ansible-initcluster directory, run the next command: |
ansible-playbook install-paralus-playbook.yaml
| b. | Follow the instructions on the screen. |
| c. | When done, cat the votiro-setup.log file to verify successful installation. |
| d. | Copy the encryption keys and save it in a safe place (see example below). |
| e. | Run the health check to verify that the system is running properly. |
| n | For big file support, do the following: |
| t | Apply ssh to one of the nodes, and run the /root/extras/scale-for-large-file/change-memory-limit.sh script. |
| t | Edit the cancellation-service-config configmap: |
Kubectl edit cm cancellation-service-config
and increase the CancellationTimeout: field to 01:00:00 (1h)
| t | In the management’s policy page, set the large file case to skip |
Your Votiro Cloud installation has completed successfully.
Comments
0 comments
Please sign in to leave a comment.