SpectroCloud/VertexInstall

Vertex Installation Instructions

Vertex Installation

Pre Requisites

1. Needed Downloads

• Binaries: airgap-base-ova (ex. spectro-airgap-podman-v3.1.4.ova)
• Binaries: airgap-fips (ex. airgap-vertex-v4.5.11.bin)
• Binaries: airgap-fips-scar-zip (ex. scar-airgap-vertex-v4.5.11.zip)
• Capi OS Image: k8s_fips (ex. u-2004-0-k-1305-fips.ova)
• Airgap Binaries: kubernetes-<version> (ex. airgap-vertex-pack-kubernetes-1.30.5.bin)
• Airgap Binaries: kubernetes-<version> (ex. airgap-vertex-pack-kubernetes-1.29.9.bin)

2. vCenter Prep

• Tag the DataCenter with k8s-region
• Tag the Cluster with k8s-zone
• Create a VM Folder called spectro-templates
• Create a VM Folder called spectro-vms
• Import the k8s_fips OVA (ex. u-2004-0-k-1305-fips.ova)
  • Rename Image to "r_u-2004-0-k-<version>-fips" (ex. r_u-2004-0-k-1305-fips)
  • Convert VM to Template.

3. Harbor Prep

• Create a new Public Project (spectro-images)

4. OVA Setup

DOCS REFERENCE: https://docs.spectrocloud.com/vertex/install-palette-vertex/install-on-vmware/airgap-install/environment-setup/vmware-vsphere-airgap-instructions/

• Deploy the OVA to vCenter (airgap-base-ova).

1. Machine name: sc-deploy
2. Folder: spectro-vms
3. Acknowledge the certificate.
4. Storage: DERS-HDD
5. Network: DERS-87
6. Set SSH Public Key: <opsman-key>
7. Default User Password: <ders>

• Copy the vertex bin to the sc-deploy vm.

export SC_DEPLOY_IP="172.16.87.51"
scp -i ~/.ssh/opsman /nfs/Download/airgap-vertex-v4.5.11.bin ubuntu@$SC_DEPLOY_IP:/tmp/
scp -i ~/.ssh/opsman /nfs/Download/airgap-vertex-pack-kubernetes-1.30.5.bin ubuntu@$SC_DEPLOY_IP:/tmp/
scp -i ~/.ssh/opsman /nfs/Download/airgap-vertex-pack-kubernetes-1.29.9.bin ubuntu@$SC_DEPLOY_IP:/tmp/

• SSH to the sc-deploy VM.

ssh -i ~/.ssh/opsman ubuntu@$SC_DEPLOY_IP
sudo --login

• Run the BIN Files

#################
# SET VARIABLES #
#################
export OCI_IMAGE_REGISTRY=harbor.dersllc.com
export OCI_PACK_BASE=spectro-images
export OCI_PACK_REGISTRY=harbor.dersllc.com
export OCI_IMAGE_BASE=spectro-images
export SC_VERSION='v4.5.11'

####################
# Trust DERS Certs #
####################
sudo curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/AddTrustExternalCARoot.crt > /usr/local/share/ca-certificates/ders-star-ca.crt
sudo curl --insecure https://ders-gitlab.dersllc.com/ders/vmware-se/-/raw/main/HomeLab/DERS-CA-CERT/ders-ca.cer > /usr/local/share/ca-certificates/ders-ssca.crt
sudo update-ca-certificates

###################
# Log-in via ORAS #
###################
oras login harbor.dersllc.com --username 'admin' --password '<Password>'

##################################
# Setup NFS Mount (NOT REQUIRED) #
##################################
apt-get -y install snapd unzip nfs-common ca-certificates
echo "172.16.85.15:/Download      /nfs/Download    nfs vers=4.0    0 0" >> /etc/fstab
mkdir -p /nfs/Download
mount -a

#################################
# Import Containers into Harbor #
#################################
chmod +x /tmp/airgap-vertex-*
/tmp/airgap-vertex-$SC_VERSION.bin --nodiskspace --target /nfs/Download/airgap-vertex-$SC_VERSION/
# If Setting up CLI is not present in the output run the following:
source /nfs/Download/airgap-vertex-$SC_VERSION/bin/functions.sh; cli_copy
/tmp/airgap-vertex-pack-kubernetes-*

####################################################################
# UNZIP Manifest in /var/www/html/manifests/<Version> on ders-plex #
####################################################################
# ssh to ders-plex
export SC_VERSION='v4.5.11'
mkdir -p /var/www/html/manifests/${SC_VERSION}
mv /nfs/Download/scar-airgap-vertex-${SC_VERSION}.zip /var/www/html/manifests/${SC_VERSION}
cd /var/www/html/manifests/${SC_VERSION}
unzip scar-airgap-vertex-${SC_VERSION}.zip
systemctl restart httpd

curl http://172.16.84.22:8710/manifests/${SC_VERSION}/roar/nickfury/versions.yaml

Vertex Install Steps

# SSH to sc-deploy and run:
palette ec install

# No palette CLI config file detected. One will be created.
# Management Plane Type: 
     Palette VerteX 
# Operating System: 
     ubuntu 
# Enable Ubuntu Pro (required for production)? [y/N]:  Yes 
# Ubuntu Pro token:  C12HPMun5ibCKAqtW%cqBpaL66RNjd 
# enabling experimental podman provider
# No kind clusters found.
# Cloud Type: 
     VMware vSphere 
##########################################################
# Spectro Cloud Artifact Repository (SCAR) Configuration #                                                                                                             
##########################################################                                                                                                                                                                                                                                                                                
SCAR location:  http://172.16.84.22:8710/manifests/v4.5.11/ 
SCAR username:  admin 
SCAR password:  ******** 
Allow Insecure Connection (Bypass x509 Verification)? [Y/n]:  Yes 

• ??Download Certs

curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/STAR_dersllc_com.crt > /opt/spectro/ssl/server.crt
curl --insecure https://ders-gitlab.dersllc.com/ders/ders-proxy/-/raw/master/dersllc-new.key > /opt/spectro/ssl/server.key