Db2 Warehouse for Red Hat OpenShift can be upgraded from the Developer Edition by applying a new license activation
key.
About this task
The 2 licenses available for Db2 Warehouse are:
- Developer edition
- Enterprise edition
Note: You must be entitled to use a license before you can download it. Ensure that you or your
organization has purchased the required license.
Procedure
- Encode your Db2 Warehouse license to base64 by running the following
command::
LICENSE_KEY="./dashdb_c.lic"
cat ${LICENSE_KEY} | base64 | tr -d '\n'
Save the encoded output, as you will add it to your YAML file later in this
procedure.
-
Log in to your OpenShift® cluster
and use the command line interface (CLI) get the name of your
Db2uCluster
or
Db2uInstance
custom resource:
For Db2uCluster deployments:
oc get db2ucluster
For Db2uInstance deployments:
oc get db2uinstance
The following is a sample output from a successful command to get the name of your custom
resource:
NAME STATE AGE
db2u-sample Ready 1d
Set an environment variable with the name:
INSTANCE_NAME="db2u-sample"
- Edit the custom resource.
For Db2uCluster deployments:
oc edit db2ucluster ${INSTANCE_NAME}
For Db2uInstance deployments:
oc edit db2uinstance ${INSTANCE_NAME}
- In edit mode, locate the
license
key under spec
in the
YAML file and add the encoded string from step 1 as a value key, as shown below:
spec:
license:
value: <ENCODED STRING FROM STEP 1 GOES HERE>
- Save and close the YAML file. The following sample output confirms that an edit has been
made:
# oc edit db2ucluster ${INSTANCE_NAME}
db2ucluster.db2u.databases.ibm.com/db2ucluster-sample edited
- For the new license to take effect, delete the Db2® engine pods for the
Db2uCluster
or Db2uInstance
:
oc delete $(oc get po -l type=engine,formation_id=${INSTANCE_NAME} -oname)
- Once the new Db2 pod is
ready, verify the updated Db2 Warehouse
license:
oc exec -it c-${INSTANCE_NAME}-db2u-0 -- su - db2inst1 -c "db2licm -l"
What to do next
To upgrade processor speed and memory capacity for your new Db2 Warehouse server, see
Scaling up Db2.
To
apply annotations for your licensed Db2 Warehouse instance to your db2cluster instance, see
Injecting license annotations into a Db2 Warehouse on Red Hat OpenShift deployment.