Activating and initializing REST capability

Before application programmers can create REST services, you need to activate and initialize the REST capability.

To initialize the REST capability and set up the REST server metadata, issue the following commands in the order shown:
docker exec containername /opt/ibm/dbrest/scripts/db2rest-stop.sh
docker exec containername /opt/ibm/dbrest/scripts/db2rest-setup.sh hostname dbname port isSSLConnection schema username password
docker exec containername /opt/ibm/dbrest/scripts/db2rest-start.sh sslKeystorePath sslKeystashPath
where:
Parameter Name Description
containername The name of the Db2 container.
hostname The hostname of the database.
dbname The name of the database (for example, BLUDB).
port The database listener port (for example, 50001).
isSSLConnection Whether the port identifies an TLS connection (Y) or does not (N).
schema The schema for the metadata table (for example, DB2REST).
username The username under which the metadata table will be created.
password The password to connect to the database.
sslKeystorePath The fully qualified TLS keystore path within the Db2® REST container. This parameter is optional and is only required if your TLS configuration uses certificate based authentication. For example:
 /opt/ibm/dbrest/ssl/bludb_ssl.kdb
sslKeystashPath The fully qualified TLS key stash path within the Db2 REST container. This parameter is optional and is only required if your TLS configuration uses certificate based authentication. For example:
 /opt/ibm/dbrest/ssl/bludb_ssl.sth
Alternatively, you can call the setup_metadata REST API as described in Defining a REST SQL service.
Note: Once the REST server has been started, you can view the API documentation by accessing https://<hostname>:50050/docs.