Select Page
< All Topics
Print

Installing PowerSync on WebSphere

Posted
Updated

Creating the Web Application Server

  1. In the left column of the WebSphere console, select Servers -> Server Types -> WebSphere application servers
  2. Click the “New…” button
  3. Step 1: Select a node and name your server (e.g. PSServer). Click the “Next” button

  4. Step 2: Select the default template. Click the “Next” button
  5. Step 3: Check the “Generate Unique Ports” box. Click the “Next” button
  6. Step 4: Confirm and click the “Finish” button
  7. At the top of the application servers page, select “Save directly to the master configuration”

Increasing Server Memory (optional, recommended)

  1. In the left column of the WebSphere console, select Servers -> Server Types -> WebSphere application servers
  2. Select the web application server you just created (e.g. PSServer)
  3. Under Server Infrastructure, expand Java and Process Management, then select Process definition
  4. Under Additional Properties on the right side, select Java Virtual Machine
  5. Enter 2048 MB for Initial heap size, and 4096 MB for Maximum heap size
  6. Click “OK” at the bottom of the page
  7. At the top of the Process definition page, select “Save directly to the master configuration”

Creating the Virtual Host

  1. In the left column of the WebSphere console, select Servers -> Server Types -> WebSphere application servers
  2. Select the web application server you just created (e.g. PSServer)
  3. Under Communications, select Ports and make note of the port for “WC_defaulthost” (e.g. 9081), and “WC_defaulthost_secure” (e.g. 9444)
  4. In the left column of the WebSphere console, select Environment -> Virutal hosts
  5. Click the “New…” button.
  6. Name your virtual host (e.g. powersync_host). Click the “OK” button.
  7. At the top of the virtual hosts page, select “Save directly to the master configuration”
  8. In the virtual hosts page, select your new virtual host
  9. Under Additional Properties, select Host Aliases
  10. Click the “New…” button
  11. Name your host “*” (w/o quotes) and put the port number you found for “WC_defaulthost” in step 3 (e.g. 9081). Select the “OK” button.
  12. Repeat step 11, but use the port found for “WC_defaulthost_secure” (e.g. 9444). This will be the port used for https access.
  13. At the top of the virtual hosts page, select “Save directly to the master configuration”

Creating the WebSphere Application

  1. In the left column of the WebSphere console, select Applications -> Application Types -> WebSphere enterprise applications
  2. Click the “Install” button.
  3. Select the “Local file system” option and choose the WAR file you built earlier. Click the “Next” button.
  4. Select the Fast Path option. Click the “Next” button.
  5. Step 1: Keep the default settings. Click the “Next” button.
  6. Step 2: Select the powersync.war module, then under the Clusters and Servers list select the server you created earlier (e.g. PSServer). Click the “Apply” button. Click the “Next” button.
  7. Step 3: Select the powersync.war module, then under the Virtual host list select the host you created earlier (e.g. powersync_host). Click the “Next” button.
  8. Step 4: Under Context Root, type “/powersync” (w/o quotes) Click the “Next” button.
  9. Step 5: Leave the default settings, click the “Next” button.
  10. Step 6: Confirm and click the “Finish” button
  11. Be patient as the install finishes. Click the “Save directly to the master configuration” button.
  12. In the left column of the WebSphere console, select Servers -> Server Types -> WebSphere application servers
  13. Select the server you created earlier (e.g. PSServer) and click the “Restart” button.
  14. If successful, PowerSync can be reached at:

http:

http://<serverURL>:<WC_defaulthost port>/powersync

(e.g. http://10.0.0.14:9081/powersync)

https:

https://<serverURL>:<WC_defaulthost_secure port >/powersync

(e.g. https://10.0.0.14:9444/powersync)

Using Secure GIS Services

In order to use GIS services w/ https with PowerSync hosted on WebSphere, you must access PowerSync through the https URL and port, as well as provide a certificate for the GIS server to WebSphere. To add a certificate to WebSphere:

  1. In the left column of the WebSphere console, select Security -> SSL certificate and key management
  2. Under Related Items, select Key stores and certificates
  3. Edit CellDefaultTrustStore by selecting the name.
  4. Under Additional Properties, select Signer certificates
  5. Select the “Add” button
  6. Give the certificate an Alias of your choice and put the full path to the certificate on the server. Click the “OK” button.
  7. Click the “Save directly to the master configuration” button.
  8. In the left column of the WebSphere console, select Servers -> Server Types -> WebSphere application servers
  9. Select the server you created earlier (e.g. PSServer) and click the “Restart” button.

If successful, using the https PowerSync URL you should be able to connect to secure GIS services.

 

 

 

 

Table of Contents