Configuring a Non-Default Web Server Port in the Process Apps

If you want to run the Serena Common Web server on a port other than 9095, you must change the port numbers in the Serena Release Manager process apps that have RESTgrid widgets. After you change the process apps, you need to redeploy them.

Changing the Port Number in the Forms

You must find the RESTgrid widgets in the forms, and update each occurrence of the default port number, 9095, to the port number for your Web server installation.

To change and redeploy the process apps:

  1. Open the process app you want to change in SBM Composer. For example, open Release Package from the Application Repository.

  2. Display the Visual Design view.

  3. Under Forms, select one of the forms. For example, select createRelPackage. For a list of forms that you should update, see Forms with RESTgrid Widgets.

    The selected form displays.

  4. Verify that the form is checked out. If the message "This item is not checked out. Click here to check it out." displays at the top, click to check it out.

  5. Scroll until you see a control that contains a RESTgrid widget and select it. For example, you’ll see the RESTgrid widgets icon and the name of the control, such as:

    rlm_rest_widget_control.png

     

  6. Update the control as follows:

    1. In the Property Editor view, select the General tab.  

    2. Click the Configure URL button.

    3. In the URL displayed at the top, change the port value of 9095 to the non-default port number you specified during your common Tomcat installation. For example, your modified URL would look something like this:

      http://localhost:8088/rlm/services/ReleaseRequestService/getRequestProjects

      You should leave the host name pointing to localhost, since all Web services communication goes through localhost and Serena Release Manager uses configuration files to resolve the host names for integrating systems.

    4. Click Update outputs.

       

       

      NOTE  If you receive the error "Unable to Configure Service", you may need to change designMode to true and then retry.

    5. Click OK.

  7. Save and check in your changes.

  8. Continue for each RESTgrid widget control in each process app. See Forms with RESTgrid Widgets for the list of default controls to change.

  9. Continue with the next checklist item in Checklist for Changing the Port Number.

Forms with RESTgrid Widgets

The form controls in which you need to update the Web server port number are shown in the following table. This list is based on the default implementation of Serena Release Manager and may not be an exhaustive list in your implementation, so it is good practice to look at each form to see if it uses RESTgrid widgets.

Process App

Forms

Controls

Release Package

addDCRProjects

listDCRProjects

addDepUnit

listDimCMBaseline, listZMFPackages

addDevChgRequest

listRequests

addDimCM_Projects

listDimCMProjects

addZMF_Projects

listZMFProjects

createRelPackage,

createRPfromAR

listDCRProjects, listDimCMProjects,

listZMFProjects

Application Release

addBusinessChangeRequest

RESTGridWidget

Release Train

addRFC

listRfcRequests

Deployment

newAutomationTask,

newAutomationTemplate,

editAutomationTask,

editAutomationTemplate

gridApps, gridEnv, gridProc

newVaultDimDeployTask,

editVaultDimDeployTask

gridDepUnits, gridDepStages, gridDepAreas

newVaultZMFDeployTask,

editVaultZMFDeployTask

gridDepUnits, gridDeploymentSites, gridPromotionAreas

newVaultZMFApprovalTask,

editVaultZMFApprovalTask

gridDepUnits, gridApprovers