This section describes the preparations necessary to do when doing a customized  production installation, using PostgreSQL as platform database instead of the the default Derby database.

Prerequisites

• In order to use PostgreSQL, the admin user and password must be defined.

PostgreSQL Database Instead of the Default Derby Database

Usage Engine supports both Derby or PostgreSQL as platform databases. Derby is the default database and requires no preparations.

PostgreSQL

If you choose to use PostgreSQL as your platform database, you must install your own instance prior to deployment. 

For further information, see https://github.com/helm/charts/tree/master/stable/postgresql.

Configure Usage Engine to Use PostgreSQL

1. Change the db type to postgresql in the values.yaml file of the usage-engine-private-edition Helm chart:
   

   usage-engine-private-edition / values.yaml:
   db:
       # derby or postgresql
       type: postgresql
       jdbcUser: mzadmin
       jdbcPassword: mz

2. Set the following values in the values.yaml file of the usage-engine-private-edition Helm chart:
   

   postgres:
     adminPassword: <admin password>       #postgres superuser password, leave blank if platform is not allowed to create database and users
     adminUsername: <admin username>       #postgres superuser, leave blank if platform is not allowed to create database and users
     mzownerPassword: <mzowner password>   #Password to owner of all tables in postgres
     db: <name of database>                #postgres DB name
     port: 5432                            #postgres DB connection port
     host: <host name>                     #postgres DB hostnam

   Note!

   The passwords In the values.yaml file: jdbcPassword, adminPassword and mzownerPassword need to be defined in clear text (and not encoded using base64) if they are going to be used. Consider using Bootstrapping System Certificates and Secrets - Private Cloud(3.0) instead.

PostgreSQL when admin user and password are not defined

The subsections describe the additional installation of PostgreSQL that is necessary when using PostgreSQL as a database and admin user and password are not defined.

• Generation of PostgreSQL Database Definition Files(3.0)
• Extract Database Definition Files for PostgreSQL(3.0)
• PostgreSQL Database Creation - Private Cloud(3.0)
• Appendix A - PostgreSQL HBA Settings(3.0)