Load balancer configuration

You can use Cloud Controller to configure the load balancer parameters. The commands for configuration of the most important parameters are listed below.

The variable <loadbalancer_x> used below can have the values loadbalancer_s, loadbalancer_m, or loadbalancer_l depending on the memory model used for the installation. Refer to the PPM Installation documentation for details.

Stop the load balancer (Cloud Controller command stop <loadbalancer_x>) before changing any settings and start it again after finishing (Cloud Controller command start <loadbalancer_x>).

Configuration of the HTTP port

Change the http port (<port number>) using the HTTPD.port parameter. To do this, run the following command in Cloud Controller:
reconfigure <loadbalancer_x> +HTTPD.port=<port number>

If you want to use HTTPS as the default communication protocol for the load balancer, run the following commands in Cloud Controller:

reconfigure loadbalancer_m +zookeeper.application.instance.port=4443

reconfigure loadbalancer_m +zookeeper.application.instance.scheme=https

Configuration of the HTTPS port

By default, the HTTPS port is not enabled in an initial PPM installation. To enable or change the HTTPS port use the HTTPD.ssl.port parameter. In order to do this, run the following command in Cloud Controller:
reconfigure <loadbalancer_x> +HTTPD.ssl.port=<port number>

To enable HTTPS protocol in the load balancer, you need a valid certificate and key pair.

Configuration of the certificate

In order to use the HTTPS protocol in the load balancer, you need a valid certificate and key. Both files can be stored in a ZIP file. The files need to be named server.crt and server.key within the package. To import the SSL certificate required for HTTPS protocol run the following command in Cloud Controller:

enhance loadbalancer_x with sslCertificate local file <Certificate file>.zip

More information on how to create a certificate file can be found in chapter Generate and sign an SSL keystore.

Configuration of the FQDN (full qualified domain name)

The load balancer checks the computer name and sends a redirect if the computer name does not match the FQDN. To change the FQDN, you have to enter the following two commands in Cloud Controller:
reconfigure <loadbalancer_x> +zookeeper.application.instance.host=<New FQDN>

reconfigure <loadbalancer_x> +HTTPD.servername=<New FQDN>

Disable HTTPS

To disable HTTPS in the load balancer, run the following command in Cloud Controller.

reconfigure loadbalancer_m +HTTPD.ssl.port=0

In case HTTPS was set as the default communication protocol, you need to run the following commands in Cloud Controller:

reconfigure loadbalancer_m +zookeeper.application.instance.port=4080

reconfigure loadbalancer_m +zookeeper.application.instance.scheme=http

reconfigure <loadbalancer_x> +zookeeper.application.instance.scheme=http