Upgrading to IBM Software Hub (Upgrading from Version 4.8 to Version 5.2)

oc get pods --namespace=${PROJECT_CPD_INST_OPERANDS} | grep elasticsea-0ac3

• If the command returns an empty response, proceed to the next step.
• If the command returns a list of pods, review Upgrades fail when global search is configured incorrectly to determine whether you have any configurations that could cause issues during upgrade.

oc get pods --namespace=${PROJECT_CPD_INST_OPERANDS} | grep catalog-api

• If the command returns an empty response, you are ready to upgrade IBM Software Hub.
• If the command returns a list of pods, review the following guidance to determine how long the catalog-api service will be down during upgrade.

When you upgrade the common core services to IBM Software Hub Version 5.2, the underlying storage for the catalog-api service is migrated to PostgreSQL.

During the final stages of the migration, the catalog-api service is offline, and services that are dependent on the service are not available. The duration of the migration depends on the number of assets and relationships that are stored in the instance. The duration of the outage depends on the number of databases (projects, catalogs, and spaces) in the instance. In a typical upgrade scenario, the outage should be significantly shorter than the overall migration.

#!/bin/bash

# Default ranges for couchdb size
SMALL=50
MEDIUM=100
LARGE=200

echo "Performing pre-migration checks"

patch_for_small()
{
  echo -e "Run the following command to increase the CPU and memory:\n"
          cat << EOF
oc patch ccs ccs-cr -n ${PROJECT_CPD_INST_OPERANDS} --type merge --patch '{"spec": {
  "catalog_api_postgres_migration_threads": 4,
  "catalog_api_migration_job_resources": { 
    "requests": {"cpu": "2", "ephemeral-storage": "10Mi", "memory": "2Gi"},
    "limits": {"cpu": "6", "ephemeral-storage": "1Gi", "memory": "6Gi"}}
}}'
EOF
    echo
    echo "The system is ready for migration. Upgrade your cluster as usual."
}

patch_for_medium()
{
    echo -e "Run the following command to increase the CPU and memory:\n"
          cat << EOF
oc patch ccs ccs-cr -n ${PROJECT_CPD_INST_OPERANDS} --type merge --patch '{"spec": {
  "catalog_api_postgres_migration_threads": 6,
  "catalog_api_migration_job_resources": { 
    "requests": {"cpu": "3", "ephemeral-storage": "10Mi", "memory": "4Gi"},
    "limits": {"cpu": "8", "ephemeral-storage": "4Gi", "memory": "8Gi"}}
}}'
EOF
    echo
    echo "The system is ready for migration. Upgrade your cluster as usual."
}

patch_for_large()
{
    echo -e "Run the following command to increase the CPU and memory:\n"
          cat << EOF
oc patch ccs ccs-cr -n ${PROJECT_CPD_INST_OPERANDS} --type merge --patch '{"spec": {
  "catalog_api_postgres_migration_threads": 8,
  "catalog_api_migration_job_resources": { 
    "requests": {"cpu": "6", "ephemeral-storage": "10Mi", "memory": "6Gi"},
    "limits": {"cpu": "10", "ephemeral-storage": "6Gi", "memory": "10Gi"}}
}}'
EOF
    echo
    echo "Before you can start the upgrade, you must prepare the system for migration."
}

check_resources(){
        scale_config=$1
        #pvc_size=$(oc get pvc -n ${PROJECT_CPD_INST_OPERANDS} database-storage-wdp-couchdb-0 --no-headers | awk '{print $4}')
        #size=$(awk '{print substr($0, 1, length($0)-2)}' <<< "$pvc_size")
        size=20

        if [[ $scale_config == "small" ]];then
          if [[ "$size" -le "$SMALL" ]];then
            echo "The system is ready for migration. Upgrade your cluster as usual."
          elif [ "$size" -ge "$SMALL" ] && [ "$size" -le "$MEDIUM" ];then
            patch_for_medium
          elif [ "$size" -ge "$MEDIUM" ] && [ "$size" -le "$LARGE" ];then
            patch_for_large
          else
            patch_for_large
          fi
        elif [[ $scale_config == "medium" ]];then
          if [[ "$size" -le "$SMALL" ]];then
            patch_for_small
          elif [ "$size" -ge "$SMALL" ] && [ "$size" -le "$MEDIUM" ];then
            echo "The system is ready for migration. Upgrade your cluster as usual."
          elif [ "$size" -ge "$MEDIUM" ] && [ "$size" -le "$LARGE" ];then
            patch_for_large
          else
            patch_for_large
          fi
        elif [[ $scale_config == "large" ]];then
          if [[ "$size" -le "$SMALL" ]];then
            patch_for_small
          elif [ "$size" -ge "$SMALL" ] && [ "$size" -le "$MEDIUM" ];then
            patch_for_medium
          elif [ "$size" -ge "$MEDIUM" ] && [ "$size" -le "$LARGE" ];then
            echo "The system is ready for migration. Upgrade your cluster as usual."
          else
            patch_for_large
          fi
        fi
}

check_upgrade_case(){     
        echo -e "Checking if automatic upgrade or semi-automatic upgrade is needed"
        #scale_config=$(oc get ccs -n ${PROJECT_CPD_INST_OPERANDS} ccs-cr -o json | jq -r '.spec.scaleConfig')
        scale_config=large

        # Default case, scale config is set to small
        if [[ -z "${scale_config}" ]];then
          scale_config=small
        fi

        check_resources $scale_config
}

check_upgrade_case

./precheck_migration.sh