Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

external-header-nav
keyboard_arrow_up
list Table of Contents
file_download PDF
keyboard_arrow_right

Install Contrail Tools

date_range 13-Jun-23

SUMMARY Learn how to install tools that can help your CN2 installation go more smoothly.

Contrail tools are implemented within the ContrailReadiness controller framework. The controller runs the tools and gathers and presents the results asynchronously on demand.

You'll need to set up the ContrailReadiness controller framework before you can run any tools. After the controller comes up, follow the procedure for the tool you would like to run.

Install ContrailReadiness Controller

Use this procedure to install the ContrailReadiness controller. The ContrailReadiness controller is required before you can run any tools.

You can install the ContrailReadiness controller before or after you install CN2. Installing the controller before you install CN2 allows you to run preflight checks on the cluster.

  1. Locate the contrail-tools/contrail-readiness directory from the downloaded CN2 Tools package.
  2. If you haven't already done so, ensure you've populated the tools manifests with your repository login credentials. See Configure Repository Credentials for one way to do this.
  3. Apply the ContrailReadiness custom resource definitions.
    content_copy zoom_out_map
    kubectl apply -f contrail-tools/contrail-readiness/crds
  4. Create the ConfigMap from the deployer manifest that you plan to use or have used to install this cluster. Name the ConfigMap deployer-yaml.
    content_copy zoom_out_map
    kubectl create configmap deployer-yaml --from-file=<path_to_deployer_manifest>
    
    where <path_to_deployer_manifest> is the full path to the deployer manifest that you want to apply or have applied.
  5. Patch the ConfigMap with the registry information.
    content_copy zoom_out_map
    kubectl patch configmap deployer-yaml --type merge -p '{"data":{"registry":"enterprise-hub.juniper.net/contrail-container-prod"}}'
  6. Create the ContrailReadiness controller.
    content_copy zoom_out_map
    kubectl apply -f contrail-tools/contrail-readiness/contrail-readiness-controller.yaml
    

    Check that the controller has come up.

    content_copy zoom_out_map
    kubectl get pods -n contrail-readiness
external-footer-nav