Updating Workflow and Process Manager URLs when using Custom HTTP/HTTPS Ports

Products

• IT Management Suite

Issue/Introduction

After installing or upgrading Symantec Workflow (WF) and Process Manager (PM), users may find that the application does not automatically redirect to the custom HTTP or HTTPS ports specified during the installation process. Specifically, even if "Use SSL" is enabled and a custom port (e.g., 777) is assigned in IIS, the application may default back to standard ports or the first available binding, causing connection failures or "Page Not Found" errors

Environment

 

IT Management Suite (ITMS) / Symantec Workflow 8.x (including 8.8.1) and all previous versions.

 

Cause

This issue occurs because the Workflow installer does not always propagate custom port configurations to all necessary configuration fields within the Workflow Server and the Process Manager portal. While the installer takes the first available binding it finds in IIS, the internal "Root URL" and "Master Settings" often require manual updates to ensure the application logic points to the correct custom port and protocol.

The Workflow installer logic primarily identifies the first available HTTP or HTTPS binding in the IIS Web Site. It does not offer a specific UI selection to choose between multiple ports during the setup phase, nor does it consistently update the internal database references for the Portal URL when non-standard ports (ports other than 80 or 443) are utilized.

Resolution

If you are using a custom port (e.g., HTTP:77 or HTTPS:777), you must manually update the URLs in the following two primary locations:

Step 1: Update Workflow Server Settings

1. On the Workflow Server, locate the Workflow Tray icon in the system taskbar.

2. Right-click the icon and select Settings.
   
   
    

3. In the Workflow Server Setup window, locate the Workflow Server Setup field and click the [...] button. 
   
   
   

4. In the Root URL field, manually update the port to match your custom configuration (e.g., https://[ServerName]:777/).
   
   
   

5. Locate the Manual Setup Info field and click the [...] button.

6. Click the Edit button.

7. In the URL field for .../ProcessManager/Userman/Userman.asmx, ensure the custom port is specified in the string. 
   
   
   

8. Click OK on all dialogs.

   Note: Allow the Workflow Server extensions to restart when prompted.

    

    

Step 2: Update Process Manager Portal Settings

1. Open your browser and navigate to the Process Manager portal page.

2. Navigate to Admin > Portal > Master Settings.

3. Locate the Base URL (or appropriate URL field) and update it with the correct protocol (HTTP/HTTPS) and the custom port number. 
   
   
   

4. Click Save Changes at the bottom of the page.

    

    

Validation Steps

• Restart the IIS site and the Workflow Server services.

• Open the Process Manager portal using the new custom URL (e.g., https://servername:777/ProcessManager).

• Verify that clicking internal links or submitting forms does not revert the URL to a default port.