{"type":"doc","content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{},"macroMetadata":{"macroId":{"value":"e40fb404-067a-4c61-ad00-4863d322ebaa"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"2d13796f-32ba-46dd-919a-d506825718f9"}},{"type":"paragraph","content":[{"text":"When AGILITY is installed in customer premises (either private or public clouds controlled by customers), two optional components are included with the AGILITY image and are advisable to deploy. ","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"AGILITY Toolbox","type":"text"}]},{"type":"paragraph","content":[{"text":"AGILITY-Toolbox is a subject matter expert (SME) execution environment where B-Yond SMEs can perform model improvement-related work at customer-premises. AGILITY-Toolbox allows making incremental changes to deployed models without taking any customer data out of the premises. ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AGILITY-Toolbox has Wireshark and Docker enabled. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AGILITY-Toolbox must have HTTPS access to AGILITY via the AGILITY API as well as HTTPS access to B-Yond’s artifact registry (hosted on Oracle US-East cloud) for upgrades/updates of toolkit (a Docker container) used by the SME team for processing customer PCAP files on premises. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AGILITY-Toolbox is deployed as a single VM of 2 vCPU/16GB RAM with 100GB disk. ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"AGILITY-Toolbox Deployment","type":"text"}]},{"type":"paragraph","content":[{"text":"AGILITY-Toolbox is available to be deployed in both public and private cloud environments.","type":"text"}]},{"type":"paragraph","content":[{"text":"Download the VM image sent to you by email. The URL will have a validity period.","type":"text"}]},{"type":"paragraph","content":[{"text":"The instructions on how to use pre-authenticated URLs are at https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/usingpreauthenticatedrequests.htm. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Public Clouds","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"text":"AWS","type":"text","marks":[{"type":"code"}]},{"text":": Use the specified AMI (Amazon Machine Image) provided by B-Yond.","type":"text"}]},{"type":"paragraph","content":[{"text":"Azure","type":"text","marks":[{"type":"code"}]},{"text":": Use the specified Azure VM image provided by B-Yond.","type":"text"}]},{"type":"paragraph","content":[{"text":"Google Cloud","type":"text","marks":[{"type":"code"}]},{"text":": Use the specified Google Cloud VM image provided by B-Yond.","type":"text"}]},{"type":"paragraph","content":[{"text":"On-Premises Virtualization Platforms","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"text":"OpenStack","type":"text","marks":[{"type":"code"}]},{"text":": Download the provided qcow2 image specifically configured for OpenStack.","type":"text"}]},{"type":"paragraph","content":[{"text":"VMware","type":"text","marks":[{"type":"code"}]},{"text":": Download the provided VMware disk image specifically configured for VMware virtualization environments.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are using other cloud providers or virtualization solutions, you may need to convert the qcow2 or VMware disk images to the format required by your platform. Consult the documentation of your specific provider or platform for instructions on image conversion.","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the B-Yond provided images is recommended as they are pre-configured and optimized for running AGILITY-Toolbox.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Provision the VM","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ce75b26f-febc-44d4-afcb-fdf3a6666511"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"CPU","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Memory (GB)","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Boot Disk (GB)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"16","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"100","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Note: These values can be adjusted based on the number of simultaneous SMEs accessing the AGILITY-Toolbox.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"VMware ESXi","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To import a virtual machine stored on a VMware Hosted product to an ESX/ESXi host, run:","type":"text"}]},{"type":"codeBlock","content":[{"text":"vmkfstools -i virtual_machine.vmdk /vmfs/volumes/datastore/my_virtual_machine_folder/virtual_machine.vmdk\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create the VM using the imported disk. Option ","type":"text"},{"text":"Guest OS: Other Linux (64-bit)","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using the console login as ","type":"text"},{"text":"root","type":"text","marks":[{"type":"code"}]},{"text":" , password ","type":"text"},{"text":"almalinux","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set up static network configuration, e.g. using nmtui.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Increase VM disk size:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Increase disk size from ESXi","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rescan using ","type":"text"},{"text":"echo 1>/sys/class/block/sda/device/rescan","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Recreate the partition ","type":"text"},{"text":"2","type":"text","marks":[{"type":"code"}]},{"text":" with ","type":"text"},{"text":"fdisk","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":" printf \"d\\n\\nn\\n\\n\\n\\np\\nw\\n\" | fdisk /dev/sda\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Increase the filesystem size using ","type":"text"},{"text":"xfs_growfs /dev/sda2","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure ssh options, e.g. set authorized kes for default cloud-user ","type":"text"},{"text":"almalinux","type":"text","marks":[{"type":"code"}]},{"text":" or another user.","type":"text"}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-info","text":":info:","shortName":":info:"}},{"text":" For ESXi 8.0, use ","type":"text"},{"text":"Guest OS: Other Linux (64-bit)","type":"text","marks":[{"type":"code"}]},{"text":" enable the LSI Logic parallel SCSI controller option.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"OpenStack","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(As an administrator) Create an image:","type":"text"}]},{"type":"codeBlock","content":[{"text":"glance image-create --disk-format qcow2 --container-format bare --file ./Agility-Toolbox-X.Y.Z-AlmaLinux-X-YYYYMMDD.x86_64.qcow2 --min-disk 25 --min-ram 2048 --name Agility-Toolbox-X.Y.Z","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(As an administrator) Create a member for the glance image:","type":"text"}]},{"type":"codeBlock","content":[{"text":"glance member-create

","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(As an administrator) Accept the membership for the glance image:","type":"text"}]},{"type":"codeBlock","content":[{"text":"glance member-update

accepted","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(As a user) Create a VM using the image:","type":"text"}]},{"type":"codeBlock","content":[{"text":"openstack server create --flavor --image agility-toolbox --nic net-id= --security-group --key-name ","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Public Clouds (AWS, Azure, GCP, etc.)","type":"text"}]},{"type":"paragraph","content":[{"text":"Follow the procedures specified by your cloud provider. These procedures typically include the following steps:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Image selection: Choose the AGILITY-Toolbox VM image obtained from B-Yond or the converted image.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Shape specification: Specify the number of virtual CPUs (vCPUs) and RAM for the instance.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Boot disk specification: Define the size and type of the boot disk.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Networking configuration: Configure the network settings for the VM.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Public SSH key(s): Provide the SSH key(s) that will be used to access the VM.","type":"text"}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"[!NOTE] The VM boot time might take between 5 and 10 minutes in total.","type":"text"}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Next Steps","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SSH into it using the ","type":"text"},{"text":"cloud-user","type":"text","marks":[{"type":"code"}]},{"text":" and the associated private key:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"AMI: ","type":"text"},{"text":"ec2-user","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"OCI: ","type":"text"},{"text":"opc","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Generic Cloud: ","type":"text"},{"text":"almalinux","type":"text","marks":[{"type":"code"}]}]}]}]}]}]},{"type":"codeBlock","content":[{"text":"ssh -i

@\n","type":"text"}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that all components are up and running:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"sudo su -\n\ntshark -v\nTShark (Wireshark) 2.6.2 (v2.6.2)\ndocker ps -a\nCONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES\na3123875cb25 gcr.io/byond-infinity-platform/agility-toolkit:0.0.56 \"/bin/bash -c /opt/b…\" 2 weeks ago Up 2 weeks 0.0.0.0:80->2223/tcp, :::80->2223/tcp toolkit-sme-toolkit-1","type":"text"}]},{"type":"orderedList","attrs":{"order":3},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add ssh public keys for B-Yond SME team members by updating ","type":"text"},{"text":"/home/agilityuser/.ssh/authorized_keys","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"AGILITY Backup","type":"text"}]},{"type":"paragraph","content":[{"text":"AGILITY Backup is a back-up service used to back-up AGILITY data and configuration in a location outside the fault domain of AGILITY. In the instance of a catastrophic problem, AGILITY can be restored from its backup. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Options to implement the back-up service: ","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using your own S3-compliant object storage service","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using the nearest suitable public cloud S3-compliant object storage (if permitted)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using a dedicated VM, called “AGILITY-Backup”, where B-Yond’s own S3-compliant object storage service runs. It is deployed in a separate fault domain by the customer. ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"AGILITY must have https access to AGILITY-Backup to read/write backup. ","type":"text"}]},{"type":"paragraph","content":[{"text":"AGILITY-Backup must have HTTPS access to B-Yond’s artifact registry (hosted on Oracle US-East cloud) for upgrades/updates of object storage server (a Docker container). AGILITY-Backup VM will require 2 vCPU/16GB RAM with 300GB disk. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"AGILITY-Backup Deployment","type":"text"}]},{"type":"paragraph","content":[{"text":"AGILITY-Backup is available to be deployed in private cloud environments. Since all public clouds offer an S3-compliant object storage service, using such a VM on a public cloud is not a viable option.","type":"text"}]},{"type":"paragraph","content":[{"text":"Use the pre-authenticated URL to download the VM image from B-Yond object storage (in Oracle Cloud): ","type":"text"},{"text":"https://objectstorage.us-ashburn-1.oraclecloud.com/p/","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://objectstorage.us-ashburn-1.oraclecloud.com/p/97qLyQ7SDAXILKAbdMPqEGk2Ql0VZG9EVQF3nofSt2HNQUYHbnl8qjvIIq-2Rj3b/n/idcci80yilhd/b/cloud-images/o/agility/3.72/Agility-3.72.1-AlmaLinux-8-GenericCloud-8.8-20230915.x86_64.vmdk"}}]},{"text":"XXXX","type":"text","marks":[{"type":"underline"}]}]},{"type":"paragraph","content":[{"text":"Each URL will have a validity period, so make sure the download the image as instructed by B-Yond.","type":"text"}]},{"type":"paragraph","content":[{"text":"The instructions on how to use pre-authenticated URLs are at ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://docs.oracle.com/en-us/iaas/Content/Object/Tasks/usingpreauthenticatedrequests.htm"}},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"On-Premises Virtualization Platforms","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text"}]},{"type":"paragraph","content":[{"text":"OpenStack","type":"text","marks":[{"type":"code"}]},{"text":": Download the provided qcow2 image specifically configured for OpenStack.","type":"text"}]},{"type":"paragraph","content":[{"text":"VMware","type":"text","marks":[{"type":"code"}]},{"text":": Download the provided VMware disk image specifically configured for VMware virtualization environments.","type":"text"}]},{"type":"paragraph","content":[{"text":"If you are using other virtualization solutions, you may need to convert the qcow2 or VMware disk images to the format required by your platform. Consult the documentation of your specific provider or platform for instructions on image conversion.","type":"text"}]},{"type":"paragraph","content":[{"text":"Using the B-Yond provided images is recommended as they are pre-configured and optimized for running AGILITY-Backup.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Provision the VM","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"8bc4fef8-f843-44aa-b78a-33f3541bcea6"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"CPU","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Memory (GB)","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Boot Disk (GB)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"2","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"16","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1},"content":[{"type":"paragraph","content":[{"text":"300","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Note: Disk size for AGILITY-Backup can be adjusted based on the amount of analysis and retention period for AGILITY. B-Yond will provide the guidance for the proper disk size.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"VMware ESXi","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To import a virtual machine stored on a VMware Hosted product to an ESX/ESXi host, run:","type":"text"}]},{"type":"codeBlock","content":[{"text":"vmkfstools -i virtual_machine.vmdk /vmfs/volumes/datastore/my_virtual_machine_folder/virtual_machine.vmdk\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create the VM using the imported disk. Option ","type":"text"},{"text":"Guest OS: Other Linux (64-bit)","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Using the console login as ","type":"text"},{"text":"root","type":"text","marks":[{"type":"code"}]},{"text":" , password ","type":"text"},{"text":"almalinux","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set up static network configuration, e.g. using nmtui.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Increase VM disk size:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Increase disk size from ESXi","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rescan using ","type":"text"},{"text":"echo 1>/sys/class/block/sda/device/rescan","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Recreate the partition ","type":"text"},{"text":"2","type":"text","marks":[{"type":"code"}]},{"text":" with ","type":"text"},{"text":"fdisk","type":"text","marks":[{"type":"code"}]}]},{"type":"codeBlock","content":[{"text":" printf \"d\\n\\nn\\n\\n\\n\\np\\nw\\n\" | fdisk /dev/sda\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Increase the filesystem size using ","type":"text"},{"text":"xfs_growfs /dev/sda2","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configure ssh options, e.g. set authorized kes for default cloud-user ","type":"text"},{"text":"almalinux","type":"text","marks":[{"type":"code"}]},{"text":" or another user.","type":"text"}]}]}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"type":"emoji","attrs":{"id":"atlassian-info","text":":info:","shortName":":info:"}},{"text":" For ESXi 8.0, use ","type":"text"},{"text":"Guest OS: Other Linux (64-bit)","type":"text","marks":[{"type":"code"}]},{"text":" enable the LSI Logic parallel SCSI controller option.","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"OpenStack","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(As an administrator) Create an image:","type":"text"}]},{"type":"codeBlock","content":[{"text":"glance image-create --disk-format qcow2 --container-format bare --file ./Agility-Backup-X.Y.Z-AlmaLinux-X-YYYYMMDD.x86_64.qcow2 --min-disk 25 --min-ram 2048 --name Agility-Backup-X.Y.Z","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"(As an administrator) Create a member for the glance image:","type":"text"}]},{"type":"codeBlock","content":[{"text":"glance member-create

@\n","type":"text"}]},{"type":"orderedList","attrs":{"order":2},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that all components are up and running:","type":"text"}]}]}]},{"type":"codeBlock","content":[{"text":"sudo su -\n\nkubectl -n agility-backup get pod\nNAME READY STATUS RESTARTS AGE\nagility-minio-provisioning-cgtdm 0/1 Completed 0 25h\nagility-minio-76c4c9d4ff-2252q 1/1 Running 1 (24h ago) 25h","type":"text"}]},{"type":"orderedList","attrs":{"order":3},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Collect the minio credentials to be configured in AGILITY back-up configuration as follows: ","type":"text"}]},{"type":"codeBlock","content":[{"text":"agility-backup","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Follow the instructions listed in ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://b-yond-infinite-network.github.io/agility-docs/"}},{"text":" to configure back-up destination and schedule for AGILITY.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"[Optional] Attach an External Disk","type":"text"}]},{"type":"paragraph","content":[{"text":"In cases where external disk attachment is necessary, follow these steps. This will depend on the type of external disk used.","type":"text"}]},{"type":"paragraph","content":[{"text":"All example commands are executed as ","type":"text"},{"text":"root","type":"text","marks":[{"type":"code"}]},{"text":" user.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Prepare the VM","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access the VM using ssh","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Stop the processes:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo su -\n\n/usr/local/bin/k3s-killall.sh\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Rename the original directory ","type":"text"}]},{"type":"codeBlock","content":[{"text":"export MOUNT_PATH=/var/lib/rancher/k3s/storage\nmv ${MOUNT_PATH} ${MOUNT_PATH}.old","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"NFS example","type":"text"}]},{"type":"paragraph","content":[{"text":"NFS server provides an endpoint to mount locally a remote directory.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Create a directory on your VM to serve as the mount point for the NFS share:","type":"text"}]},{"type":"codeBlock","content":[{"text":"mkdir -p ${MOUNT_PATH}\nchmod 0700 ${MOUNT_PATH}","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Back-up the ","type":"text"},{"text":"/etc/fstab","type":"text","marks":[{"type":"code"}]},{"text":" file","type":"text"}]},{"type":"codeBlock","content":[{"text":"cp /etc/fstab /etc/fstab.backup","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Add an entry at the end of the ","type":"text"},{"text":"/etc/fstab","type":"text","marks":[{"type":"code"}]},{"text":" file to specify the NFS share and the mount point. The entry should follow this format:","type":"text"}]},{"type":"codeBlock","content":[{"text":"echo \": nfs _netdev,defaults 0 0\" | tee -a /etc/fstab\n","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Replace with the IP address or hostname of the NFS server, with the path of the directory you want to mount, and with the path of the local mount point you created in Step 1. ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"For example, if the NFS server IP address is 192.168.1.100 and the remote directory you want to mount is /data, the entry would look like this:","type":"text"}]},{"type":"codeBlock","content":[{"text":"echo \"192.168.1.100:/data /var/lib/rancher/k3s/storage nfs _netdev,defaults 0 0\" | tee -a /etc/fstab\n","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Apply a ","type":"text"},{"text":"daemon-reload","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]},{"type":"codeBlock","content":[{"text":"systemctl daemon-reload","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"To mount all entries listed in ","type":"text"},{"text":"/etc/fstab","type":"text","marks":[{"type":"code"}]},{"text":", you can use the ","type":"text"},{"text":"mount -a","type":"text","marks":[{"type":"code"}]},{"text":" command.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Ensure that your VM has network connectivity to the NFS server and that you have the necessary permissions to access the NFS share.","type":"text"}]},{"type":"paragraph","content":[{"text":"Now that you have mounted the NFS component, go to the ","type":"text"},{"text":"Restart back-up process","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" section.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Block volume example","type":"text"}]},{"type":"paragraph","content":[{"text":"If your cloud gives you the ability to provision block storage and attach the disk to your VM, please follow the recommended procedures. For example, it involves several ","type":"text"},{"text":"iscsi","type":"text","marks":[{"type":"code"}]},{"text":" commands executions.","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Once Attached, format the disk (e.g., ","type":"text"},{"text":"sdb","type":"text","marks":[{"type":"code"}]},{"text":"):","type":"text"}]},{"type":"codeBlock","content":[{"text":"export DEV_PATH=sdb\n\nmkfs.ext4 -m 0 -F -E lazy_itable_init=0,lazy_journal_init=0,discard /dev/${DEV_PATH}\n\nmkdir -p ${MOUNT_PATH}\nmount -o discard,defaults /dev/${DEV_PATH} ${MOUNT_PATH}\nchmod 0700 ${MOUNT_PATH}\n","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Persist the changes:","type":"text"}]},{"type":"codeBlock","content":[{"text":"cp /etc/fstab /etc/fstab.backup\n\nUUID=$(sudo blkid -s UUID -o value /dev/${DEV_PATH})\necho $UUID\n\necho UUID=$(sudo blkid -s UUID -o value /dev/${DEV_PATH}) ${MOUNT_PATH} ext4 _netdev,nofail 0 2 | tee -a /etc/fstab\n","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Now that you have mounted the Disk component, go to the ","type":"text"},{"text":"Restart back-up process","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" section.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Restart back-up process","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Synchronize the new volume ","type":"text"}]},{"type":"codeBlock","content":[{"text":"rsync -avl ${MOUNT_PATH}.old/ ${MOUNT_PATH}/","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Start the process:","type":"text"}]},{"type":"codeBlock","content":[{"text":"systemctl start k3s","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Wait a few seconds and ensure that all services are in the Running state:","type":"text"}]},{"type":"codeBlock","content":[{"text":"kubectl -n agility-backup get pod\nNAME READY STATUS RESTARTS AGE\nagility-minio-provisioning-cgtdm 0/1 Completed 0 34d\nagility-minio-76c4c9d4ff-2252q 1/1 Running 2 (61s ago) 34d","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Verify that the system is functioning correctly by performing following tasks. ","type":"text"}]},{"type":"codeBlock","content":[{"text":"kubectl -n agility-backup exec -it deploy/agility-minio -- mc ls local/agility-backup\nkubectl -n agility-backup exec -it deploy/agility-minio -- mc du local/agility-backup","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Remove the old directory ","type":"text"}]},{"type":"codeBlock","content":[{"text":"rm -rf ${MOUNT_PATH}.old","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Troubleshooting","type":"text"}]},{"type":"paragraph","content":[{"text":"When listing pods, ","type":"text"},{"text":"agility-minio-xxxxxxx-xxxxx","type":"text","marks":[{"type":"code"}]},{"text":" pod is not on ","type":"text"},{"text":"Running","type":"text","marks":[{"type":"code"}]},{"text":" status ","type":"text"}]},{"type":"codeBlock","content":[{"text":"[root@agility-backup ~]# kubectl -n agility-backup get pod\nNAME READY STATUS RESTARTS AGE\nagility-minio-provisioning-cgtdm 0/1 Completed 0 42d\nagility-minio-76c4c9d4ff-csshh 0/1 CrashLoopBackOff 3 (20s ago) 45m","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure synchronization between ","type":"text"},{"text":"${MOUNT_PATH}.old/","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"${MOUNT_PATH}/","type":"text","marks":[{"type":"code"}]},{"text":" was successfull ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure PVCs directory have right permissions ","type":"text"}]},{"type":"codeBlock","content":[{"text":"chmod 0777 /var/lib/rancher/k3s/storage/pvc-*\nkubectl -n agility-backup rollout restart deployment agility-minio","type":"text"}]}]}]}],"version":1}

Browser not supported