Deploying the Product

To deploy the product, perform the following:

  1. Use the following configuration to install the product
    configure 
      software cnf software_name 
        url HTTP_HTTPS_File_URL 
        user username 
        password password 
        sha256 sha256_hash 
        exit 
  2. Link the CEE into the desired cluster in the ops-centers section.
    configure 
      clusters cluster_name ops-center app_name instance_name 
      repository-local cnf_repo 
      exit 
  3. Download the TAR ball from the URL.

    software-packages download URL 

    Example:

    SMI Cluster Manager# software-packages download http://<ipv4address>:<port_number>/packages/cee-2019-08-21.tar 
    
  4. Verify whether the TAR balls are loaded.

    software-packages list 

    Example:

    SMI Cluster Manager# software-packages list 
    [ cee-2019-08-21 ] 
    [ sample ] 
    
  5. Configure the necessary Ops Center parameters in the required cluster to deploy the product.

    configure 
       cluster cluster_name 
          ops-centers app_name instance_name 
             repository url 
             netconf-ip ipv4_address 
             netconf-port port 
             ssh-ip ipv4_address 
             ssh-port port 
             ingress-hostname  <ipv4_address>.<customer_specific_domain_name> 
             initial-boot-parameters use-volume-claims true/false 
             initial-boot-parameters first-boot-password password 
             initial-boot-parameters auto-deploy true/false 
             initial-boot-parameters single-node true/false 
             initial-boot-parameters image-pull-secrets 
             exit 
       exit 
    

    Example:

    SMI Cluster Manager# config 
    SMI Cluster Manager(config)# clusters test2 
    SMI Cluster Manager(config-clusters-test2)# ops-centers cee data 
    SMI Cluster Manager(config-ops-centers-cee/data)# repository http://charts.<ipv4address>.<domain_name>/cee-2019-08-21/ 
    SMI Cluster Manager(config-ops-centers-cee/data)# initial-boot-parameters use-volume-claims false 
    SMI Cluster Manager(config-ops-centers-cee/data)# initial-boot-parameters first-boot-password Cisco@123 
    SMI Cluster Manager(config-ops-centers-cee/data)# initial-boot-parameters auto-deploy true 
    SMI Cluster Manager(config-ops-centers-cee/data)# initial-boot-parameters single-node false 
    SMI Cluster Manager(config-ops-centers-cee/data)# exit 
    SMI Cluster Manager(config-clusters-test2)# exit 
    SMI Cluster Manager(config)# 
    
  6. Configure the secrets, if your local registry contains secrets.

    configure 
       cluster cluster_name 
          secrets docker-registry secret_name 
             docker-server server_name 
             docker-username username 
             docker-password password 
             docker-email email 
             namespace k8s namespace 
             commit 
             exit 
          exit 
    

    Example:

    SMI Cluster Manager# config 
    SMI Cluster Manager(config)# clusters test2 
    SMI Cluster Manager(config-clusters-test2)# secrets docker-registry sec1 
    SMI Cluster Manager(config-docker-registry-sec1)# docker-server serv1 
    SMI Cluster Manager(config-docker-registry-sec1)# docker-username user1 
    SMI Cluster Manager(config-docker-registry-sec1)# docker-password Cisco@123 
    SMI Cluster Manager(config-docker-registry-sec1)# docker-email reg@cisco.com 
    SMI Cluster Manager(config-docker-registry-sec1)# namespace ns1 
    SMI Cluster Manager(config-docker-registry-sec1)# exit 
    SMI Cluster Manager(config-clusters-test2)# exit 
    SMI Cluster Manager(config)# 
    
  7. Run the cluster synchronization.

    clusters cluster_name actions sync run 
    

    Example:

    SMI Cluster Manager# clusters test2 actions sync run 
    

Notes:

  • software-packages download url – Specifies the software packages to be downloaded through HTTP/HTTPS.

  • software-packages list – Specifies the list of available software packages.

  • ops-centers app_name instance_name – Specifies the product Ops Center and instance. app_name is the application name. instance_name is the name of the instance.

  • repository url - Specifies the local registry URL for downloading the charts.

  • netconf-ip ipv4_address – Specifies the Ops Center netconf IPv4 address.

  • netconf-port port – Specifies the Ops Center netconf port number.

  • ssh-ip ipv4_address – Specifies the SSH IPv4 address for the Ops Center.

  • ssh-port port - Specifies the SSH port number for the Ops Center.

  • ingress-hostname <ipv4_address>.<customer_specific_domain_name> – Specifies the ingress hostname to be set to the Ops Center. <customer_specific_domain_name> specifies the customer's domain name.

  • initial-boot-parameters – Specifies the initial boot parameters for deploying the helm charts.

    • use-volume-claims true/false – Specifies the usage of persistent volumes. Set this option to True to use persistent volumes. The default value is true.

    • first-boot-password password – Specifies the first boot password for the product's Ops Center.

    • auto-deploy true/false – Auto deploys all the services of the product. Set this option to false to deploy only the product's Ops Center.

    • single-node true/false – Specifies the product deployment on a single node. Set this option to false for multi node deployments.

    • image-pull-secrets – Specifies the docker registry secret name to be used.

  • secrets docker-registry secret_name – Specifies the secret name for your docker registry.

    • docker-server server_name – Specifies the docker server name.

    • docker-username username – Specifies the docker registry user name.

    • docker-password password – Specifies the docker registry password.

    • docker-email email – Specifies the docker registry email.

    • namespace namespace – Specifies the docker registry namespace.

NOTES:

  • software cnf software_name - Specifies the Cisco's Cloud Native software. software_name is the name of the Cloud Native software.

    • url HTTP_HTTPS_File_URL - Specifies the repository URL.

    • user username - Specifies the username for HTTP/HTTPS authentication.

    • password password - Specifies the password used for downloading the software package.

    • sha256 sha256_hash - Specifies the SHA256 hash of the software download.

To deploy the product, perform the following:

  1. Login to the SMI Cluster Manager CLI using the ingress URL.

    
    https://cli.smi-cluster-manager.<IP_address>.<customer_specific_domain_name> 
    

    NOTES:

    • customer_specific_domain_name - Specifies the customer's domain name.

  2. Use the following configuration to install the CEE
    configure 
      software cnf software_name 
        url HTTP_HTTPS_File_URL 
        user username 
        password password 
        sha256 sha256_hash 
        exit 

    NOTES:

    • software cnf software_name - Specifies the Cisco's Cloud Native software. software_name is the name of the Cloud Native software.

      • url HTTP_HTTPS_File_URL - Specifies the repository URL.

      • user username - Specifies the username for HTTP/HTTPS authentication.

      • password password - Specifies the password used for downloading the software package.

      • sha256 sha256_hash - Specifies the SHA256 hash of the software download.

  3. Link the product (CEE or Network Functions) into the desired cluster in the ops-centers .
    configure 
      clusters cluster_name ops-center app_name instance_name 
      repository-local cnf_repo 
      exit 

    NOTES:

    • repository-local cnf_repo - Specifies the CNF repository.

  4. Run the cluster synchronization to deploy the CEE Ops Center and wait for the synchronization to complete.
    clusters cluster_name actions sync run 

    NOTES:

    • clusters cluster_name actions sync run - Synchronizes the committed changes to the cluster.

  5. Verify the cluster synchronization through cluster sync status or log commands.

    clusters cluster_name actions sync status 
    clusters cluster_name actions sync logs 

    NOTES:

    • clusters cluster_name actions sync status - Displays the status of the cluster synchronization.

    • clusters cluster_name actions sync logs - Displays the logs generated during the cluster synchronization process.