Setting up your environment

Download the Guardium Insights CASE file and set up your environment for dependencies.

About this task

After you install Guardium Insights, you must download the CASE file and set up your environment.

Procedure

  1. Export environment variables and create local directories.
    For GuardiumĀ® Insights 3.2.10 and later:
    export CASE_NAME=ibm-guardium-insights
    export CASE_VERSION=<CASE VERSION>
    export LOCAL_CASE_DIR=$HOME/.ibm-pak/data/cases/$CASE_NAME/$CASE_VERSION
    
    Specify the CASE_VERSION that is correct for the version of Guardium Insights you are deploying. For example, Guardium Insights 3.2.10 requires CASE_VERSION 2.2.10. For more information, see Container Application Software for Enterprises (CASE) version support.
    For Guardium Insights 3.2.8 and earlier:
    1. Create a local directory for the installation:
      export LOCAL_INSTALL_DIR=$HOME/guardium-insights
      mkdir $LOCAL_INSTALL_DIR
    2. Create a local directory for the CASE bundle:
      export LOCAL_CASE_DIR=$LOCAL_INSTALL_DIR/local_case
      mkdir $LOCAL_CASE_DIR
    3. Specify the CASE_VERSION that is correct for the version of Guardium Insights you are deploying. For example, Guardium Insights 3.2.0 requires CASE_VERSION 2.2.0. For more information, see Container Application Software for Enterprises (CASE) version support.
      export CASE_VERSION=<CASE_VERSION>
      export CASE_ARCHIVE=ibm-guardium-insights-$CASE_VERSION.tgz

      Where the CASE version (<CASE_VERSION>) is the new version for your Guardium Insights deployment and <CASE_ARCHIVE> is the CASE file name with the new CASE version included. CASE versions are explained in Container Application Software for Enterprises (CASE) version support.

  2. Save the CASE bundle locally.
    For Guardium Insights 3.2.10 and later:
    oc ibm-pak get $CASE_NAME \
    --version $CASE_VERSION \
    --skip-verify
    
    For Guardium Insights 3.2.8 and earlier:
    cloudctl case save \
      --case https://github.com/IBM/cloud-pak/raw/master/repo/case/ibm-guardium-insights/$CASE_VERSION/$CASE_ARCHIVE \
      --outputdir $LOCAL_CASE_DIR --tolerance 1
    Note: If you encounter an error similar to this:
    No Case registries found for case ibm-cert-manager->=1.3.0 <1.3.1.tgz with the given repository URL information
    FAILED
    You may be experiencing a temporary communication problem with the remote repository. Wait a few minutes and try again.
  3. Extract the CASE bundle to your local directory. This step is only required if you will be using the all-in-one script to install Guardium Insights (this step is not required if you will perform a manual installation).
    tar -xvf $LOCAL_CASE_DIR/$CASE_ARCHIVE --dir $LOCAL_CASE_DIR

What to do next

Edit the values configuration file.