After you install EDB
Postgres, you must create at least
one EDB
Postgres service instance in the operands project. If you are a
IBM® Software
Hub user, you can use the web client to create
service instances. The web client guides you through the process of creating service
instances.
- Who needs to complete this task?
- To create a service instance from the web client, you must have the Create service
instances permission in IBM Software
Hub.
- When do you need to complete this task?
- Complete this task only if you want to create a service instance from the web client.
Alternative methods for creating a service instance
Before you begin
This task assumes that the following prerequisites are met:
| Prerequisite |
Where to find more information |
| EDB
Postgres is installed. |
If this task is not complete, see Installing EDB Postgres. |
Procedure
To create a service instance:
-
From the Cloud Pak for Data services catalog, select
EDB Postgres.
- Click New Instance.
- Enter a name for the instance and then select the namespace where you want to deploy the
database.
Click Next.
- Specify the following options for EDB
Postgres on the OpenShift®
Container Platform cluster:
- Number of nodes. Use this option to specify the number of EDB
Postgres database instances you want to deploy.
- Cores per node
- Memory per node. You can allocate a minimum of 4 GiB of memory per
database instance.
- Version
- Custom TLS Server Cert Secret and Custom TLS Client Cert
Secret. If you generate custom TLS server and client certificates, use these options to
set the respective secrets.
The
EDB
Postgres database provides self-signed TLS
certificates by default. If you want to use your own custom client and server TLS certificates, make
sure that the generated secrets contain the following parameters:
- Type. Depending on the EDB
Postgres distribution you use, set the
type to Standard or Enterprise. Use the Add custom credentials (Optional)
option to set a custom username and password to access your database instance. For more information,
see Creating a custom EDB Postgres user name and password.
- From the storage classes that are available on the cluster, specify the size and unit for
the storage class. For a list of the storage classes that are compatible with EDB
Postgres,
see EDB
Postgres storage requirements.
Click Next.
- Confirm the information provided on the review page.
Click
Create. It might take up to five minutes for the instance to be
ready.
- Run the following command to check the status of the instance:
oc describe CPDEdbInstance <EDBInstanceName> -n ${PROJECT_CPD_INST_OPERANDS}
where the namespace is the OpenShift
operands project where Cloud Pak for Data is installed.
The status result will be similar to the following example:
Status:
Conditions:
Last Transition Time: 2021-06-14T17:41:38Z
Message: Running reconciliation
Reason: Running
Status: True
Type: Running
Edb Status: In Progress
The instance is ready for use when Edb Status changes from In
Progress to Completed.
What to do next
EDB
Postgres is ready to use. To get started with EDB
Postgres, see Administering EDB Postgres service and Working with EDB Postgres databases.