The PowerHA web interface is configured automatically with the following settings:
Run on non-secure HTTP port 2098
Automatically start when the *HTTP server is started
The web interface can be reached by going to the following URL in a web browser: http://<system-name>:2098
We recommend you configure the PowerHA webserver for secure HTTPS traffic. This ensures all information sent over the network is encrypted.
Starting and Ending the PowerHA Web Interface
The PowerHA web interface can be started by starting the QHAWEBSVR instance with the following command: STRTCPSVR SERVER(*HTTP) HTTPSVR(QHAWEBSVR)
To end the PowerHA web interface, use ENDTCPSVR SERVER(*HTTP) HTTPSVR(QHAWEBSVR).
If the PowerHA web interface is configured to start with the *HTTP server, the web interface will start when TCP is started or with STRTCPSVR SERVER(*AUTOSTART).
Changing the PowerHA Web Interface Configuration
The Change PowerHA Webserver (CHGHAWEB) command enables easy configuration changes of the PowerHA web interface. When using F4 to prompt on the command, existing configuration values will be shown on the command.
Enabling secure HTTPS for the PowerHA Web Interface
Secure HTTPS traffic for the PowerHA web interface requires a digital certificate. A digital certificate provides two functions:
Providing a way to encrypt communication between the web browser and the server
Verifying the identity of the server to prevent a man-in-the-middle attack.
Depending on the type of digital certificate you configure, the digital certificate will help with either encrypting communication or with both encrypting communication and verifying the identity of the server.
Before you begin
This step requires the following:
IBM 5770SS1 Option 34 - Digital Certificate Manager is installed
The *SYSTEM certificate store is created
To create the *SYSTEM certificate store, use the following steps:
Procedure
In a web browser, enter http://mysystem:2001/dcm, where mysystem is the host name or IP address of the system. This opens IBM Digital Certificate Manager for i.
Log in with an IBM i profile with sufficient authority.
Click on Create Certificate Store on the left-hand navigation menu
On the right-hand side of the page select *SYSTEM.
Note: If the *SYSTEM option is not available in the list, it indicates that there is a *SYSTEM store already created on this system, and these steps have already been performed.
5. Create a password for the *SYSTEM store and click Create.
Note: The password is case-sensitive. It is recommended not to use special characters. This password is not attached to a user profile and it will not lock you out of the system after too many attempts.
Result
The *SYSTEM certificate store is created on the node.
Procedure
After the *SYSTEM certificate store is created, the procedure consists of the following steps:
Choose a type of certificate to use by following one of the following options
Creating a Self-Signed Certificate
Importing a Signed Certificate
Assigning the certificate to the PowerHA Webserver
Enabling the secure HTTPS server
Restarting the PowerHA Webserver
1a. Creating a Self-Signed Certificate
A self-signed certificate provides a way to encrypt communication between the web browser and server. However, because the certificate is self-signed, the identity of the server cannot be verified. While a self-signed certificate is still much more secure than non-secured HTTP traffic, it does not protect against a man-in-the-middle attack.
To create a self-signed certificate, use the following steps:
Create a Local Certificate Authority (if one does not already exist)
Create a Certificate Authority (CA) Certificate (if one does not already exist)
Use the Local Certificate Authority to create a self-signed certificate
Procedure
In a web browser, enter http://mysystem:2001/dcm, where mysystem is the host name or IP address of the system. This opens IBM Digital Certificate Manager for i.
Log in with an IBM i profile with sufficient authority.
Click on Create Certificate Store on the left-hand navigation menu.
On the right-hand side of the page select Local CA.
Note: If the Local CA option is not available in the list, it indicates that there is already a local certificate authority on this system, and these steps have already been performed.
5. Create a password for the Local CA store and click Create.
Note: The password is case-sensitive. It is recommended not to use special characters. This password is not attached to a user profile and it will not lock you out of the system after too many attempts.
Result
The *SYSTEM certificate store is created on the node.
Procedure
In a web browser, enter http://mysystem:2001/dcm, where mysystem is the host name or IP address of the system. This opens IBM Digital Certificate Manager for i.
Log in with an IBM i profile with sufficient authority.
In the left-hand menu, select Local CA
If Local CA is not in the left-hand menu, open it by doing the following:
Select Open Certificate Store.
Enter the password for the local certificate authority, and click open.
The Local CA will now automatically be selected in the left-hand menu.
Under Certificate Authority (CA) Certificates, create one if one does not exist by selecting Create.
Fill in the required fields. At a minimum:
Common name: Provide a unique common name for this. For example: MyCompany MySystem CA
Organization Name: Provide the name of your company
State or Province: Provide the state or province of the system
Country or Region: Provide the two character country code
Click Create.
Result
The CA Certificate is created on the node.
Procedure
In a web browser, enter http://mysystem:2001/dcm, where mysystem is the host name or IP address of the system. This opens IBM Digital Certificate Manager for i.
Log in with an IBM i profile with sufficient authority.
In the left-hand menu, select the *SYSTEM certificate store.
If the *SYSTEM certificate store is not in the left-hand menu, open the certificate store:
Select Open Certificate Store in the left-hand menu.
Select *SYSTEM on the right-hand side of the screen.
Enter the password for the *SYSTEM certificate store.
Click Open.
Under certificates on the right-hand side, select Create.
For type, select Local CA
Fill in the required fields. At a minimum:
Label: Provide a unique common name for this. For example: MyCompany MySystem PowerHA Web Interface
Organization Name: Provide the name of your company
State or Province: Provide the state or province of the system
Country or Region: Provide the two character country code
Click Create.
Result
The self-signed certificate is created on the node.
1.b Importing a Trusted Certificate
To import a trusted certificate, follow the instructions in the IBM Documentation for Digital Certificate Manager.
2. Assigning the Certificate to the PowerHA Webserver
Procedure
In a web browser, enter http://mysystem:2001/dcm, where mysystem is the host name or IP address of the system. This opens IBM Digital Certificate Manager for i.
Log in with an IBM i profile with sufficient authority.
In the left-hand menu, select the *SYSTEM certificate store.
If the *SYSTEM certificate store is not in the left-hand menu, open the certificate store:
Select Open Certificate Store in the left-hand menu.
Select *SYSTEM on the right-hand side of the screen.
Enter the password for the *SYSTEM certificate store.
Click Open.
Select Manage Application Definitions.
Search for QIBM_QHASM_WEB.
Click on the + symbol at the lower-right of the QIBM_QHASM_WEB box.
Click on Assign Certificates.
Check the box for the certificate you wish to assign, and click Assign.
Result
The certificate is now assigned to the PowerHA web interface
3. Enabling the secure HTTPS server
Enable the secure HTTPS server by using the HTTPS(*ON *SAME) parameter on the CHGHAWEB command. If no other configuration options have changed, by default PowerHA is equivalent to the following command:CHGHAWEB HTTP(*AUTO 2098) HTTPS(*ON 2099)
This command enables the non-secured HTTP server on port 2098, configured to automatically redirect users to the secured HTTPS server on port 2099.
Alternatively, the non-secured server can be disabled by using the following command:CHGHAWEB HTTP(*OFF *SAME) HTTPS(*ON 2099)
4. Restarting the PowerHA Web Interface
Restart the PowerHA webserver for the new changes to take effect.
Run the ENDTCPSVR command, to end the QHAWEBSVR instance:
ENDTCPSVR SERVER(*HTTP) HTTPSVR(QHAWEBSVR)Wait for all of the QHAWEBSVR jobs to end. This can be checked by using the
WRKACTJOB JOB(QHAWEBSVR)command, which should show No active jobs to display.
Use the STRTCPSVR command, to start the QHAWEBSVR instance:
STRTCPSVR SERVER(*HTTP) HTTPSVR(QHAWEBSVR)
After enabling the HTTPS server, use the following format to reach the PowerHA web interface https://<system-name>:<https-port>. For example, with the default port configuration the URL would be: https://<system-name>:2099.
Changing the default port
Use the Change PowerHA Webserver (CHGHAWEB) command to specify the port numbers used for the HTTP server and the HTTPS server. The port number is ignored if a particular server is *OFF. The following example changes the secure HTTPS server port to 12345:
CHGHAWEB HTTPS(*SAME 12345)
Note: The PowerHA HTTP server instance must be restarted after changing the port number.
Changing the server to no longer automatically start
CHGHAWEB AUTOSTART(*NO)
This command changes the web interface so that it no longer starts with the *HTTP server during STRTCPSVR SERVER(*AUTOSTART) or during system IPL.