Accessing dashboard on HTTPS using Secure HTTP Server Adapter

Technote (troubleshooting)


Problem(Abstract)

Accessing dashboard on HTTPS using Secure HTTP Server Adapter

Symptom

404 error displayed in browser by following the instructions in the documentation


Resolving the problem

To switch from HTTP to HTTPS mode:

  1. Create a new HTTP Server adapter instance with SSL enabled. You must configure the following parameters as specified:
    • User Authentication Required is set to No
    • Use SSL is set to Must
  2. Deploy required WAR files to the HTTP Server adapter instance with SSL enabled.

Note: All WAR files must be picked up from the /install_dir/install/noapp/deploy directory when configuring the HTTP Server Adapter instance.

Additionally, the context name of the admin web application must match the ADMIN_CONTEXT_PATH parameter in /install_dir/install/properties/sandbox.cfg file. Note that ADMIN_CONTEXT_PATH in sandbox.cfg is set to ws. This value should not be modified.

For all the other web applications, the context name should be the name of the war file without the ".war" extension.

This is necessary so that any changes made via a patch or hotfix are automatically reflected in the HTTP Server adapter deployment.

The required WAR files include:

  • admin.war
  • dashboard.war
  • gbm.war
  • myaft.war
  • portlets.war


Additional WAR files may be required to support new functionality added by you to your Dashboard.

Deploy the war files on HTTP Server Adapter with following values, where <install_dir> is the Sterling Integrator installation directory:

URI WAR File PATH
/ws /install_dir/install/ noapp/deploy/admin.war
/dashboard /install_dir/install/ noapp/deploy/dashboard.war
/gbm /install_dir/install/noapp/deploy/gbm.war
/myaft /install_dir/install/noapp/deploy/myaft.war
/portlets /install_dir/install/ noapp/deploy/portlets.war

3. Open the sandbox.cfg file.

Modify the following parameters:

WEBAPP_PROTOCOL=https
WEBAPP_LIST_PORT=<secure_http_server_adapter_port>
These parameters are used by the GPM for communication with the server.

4. (Optional, Recommended) If you want to turn off the deployment of the Dashboard and GPM Web applications on the base port, navigate to /install_dir/install/properties and specify the following parameters in a customer_overrides.properties file:

## Identifies the war files to be skipped during deployment on the base port.
## Use comma-separated list to specify multiple wars
noapp.SKIP_BASEPORT_DEPLOYMENT_WARS=admin,dashboard,gpm,communitymanagement,myaft,portlets
## Identifies wars for auto-redirect to the https port.
## Use comma-separated list to specify multiple wars
noapp.HTTPS_REDIRECT_WARS=admin,dashboard,gpm,communitymanagement,myaft,portlets
## Identifies the https port for the redirected wars.
## If specified, this should match the WEBAPP_LIST_PORT in sandbox.cfg
noapp.HTTPS_LIST_PORT=<secure_http_server_adapter_port>

5. (Optional) If you want to send cookies from the browser using a secure protocol like HTTPS, navigate to /install_dir/install/properties and specify the following parameter in a customer_overrides.properties file:

## sending cookies as secure over https
http.useSecureCookie=true

6. Navigate to /install_dir/install/bin.

7. Stop Sterling B2B Integrator.

8. Apply the configuration changes. Enter ./setupfiles.sh.

9. Deploy the new configuration. Enter ./deployer.sh.

10. Start Sterling B2B Integrator.

11. Verify the Dashboard Web application is accessible via the HTTP Server adapter by accessing https://host: /dashboard.

12. Verify the GPM Web application is accessible via the secure HTTP Server adapter by accessing https://host: /gpm/pmodeler/ProcessModeler.jnlp.

13. If you turned off the deployment of the Dashboard and GPM Web applications on the base port (Step 9), verify the following:

  • Dashboard Web application access on http://host:baseport/dashboard is redirected to https://host: /dashboard automatically.
  • GPM Web application access on http://host:baseport/gpm/pmodeler/ProcessModeler.jnlp is redirected to https://host: /gpm/pmodeler/ProcessModeler.jnlp automatically.

Rate this page:

(0 users)Average rating

Document information


More support for:

Sterling B2B Integrator
Adapters

Software version:

5.2.3, 5.2.4, 5.2.4.1

Operating system(s):

All

Software edition:

All Editions

Reference #:

1625574

Modified date:

2013-08-08

Translate my page

Machine Translation

Content navigation