How to create a Web Engine (webengine) and Object Manager (domsrvr) pair in CA Service Desk Manager using the CA Service Desk Manager web interface

Document ID : KB000046050
Last Modified Date : 23/10/2018
Show Technical Document Details
Question:

As a best practice, additional Web Engines (webengine) and Object Managers (domsrvr) should be created in pairs.  What are the steps to achieve this using the CA Service Desk Manager web browser interface?

Answer:
In CA Service Desk Manager 12.9 and later, the web browser interface can be used to create new webengines and domsrvrs for each CA Service Desk Manager server that is defined in the environment.
Here are the steps, with screenshots from a CA Service Desk Manager 14.1.03 test environment:
  1. Log into CA Service Desk Manager with a user, such as "ServiceDesk", that has a role allowing access to the Administration tab and set the role accordingly.Screen shot 1
  2. Click on the "Administration" tab and open the "System" folder and then click on "Configurations". 
    The Configuration List is displayed.
    Screenshot-2-Configurations.png

     
  3. Click on "Create New" and enter the Configuration Name and the Host Name. 
    "Create New Configuration" is displayed.

    Screenshot-3-NewConfiguration.png
  4. Click on "Save".
    "Configuration Detail" is displayed.

    Screenshot-4-ConfigurationDetail.png
  5. Click on "Edit".
    "Update Configuration" is displayed.

    Screenshot-5-UpdateConfiguration.png
  6. Click on "Add Object Manager".
    "Create New Object Manager" is displayed.

    Screenshot-6-CreateNewObjectManager.png
  7. Click "Save".  Then click "Search" in the "Object Managers" tab of the "Update Configuration" form that is displayed.
    After clicking "Search", the Object Manager List is refreshed and lists the newly created Object Manager, "domsrvr:02".

    Screenshot-7-SearchAfterAddObjectManager.png
  8. Click on the tab named "2. Web Engines/Web Directors".

    Screenshot-8-WebEnginesTab.png
  9. Click on "Add Web Engine/Web Director".

    Screenshot-9-CreateNewWebengine.png
  10. Click on the dropdown under the "Object Managers *" form field title and select "Choose...".

    Screenshot-10-ChooseObject Manager.png
  11. Click "Update Object Managers" in the Object Managers tab.
    "Object Manager Search" is displayed.

    Screenshot-11-UpdateObjectManagers.png
  12. Click "Search".
    "Affected Object Managers - Update" is displayed.

    Screenshot-12-AffectedObjectManagers.png
  13. Click on the object manager, in the "Available Object Managers" list on the left, that had been created in Step #6 ("primary:02") so that it is highlighted, and then click ">>".
    The selected object manager is added to the list of "Affected Object Managers" on the right.

    Screenshot-13-AffectedObjectManagers.png
  14. Click "OK".
    "Create New Webengine/Web Director"  is displayed with the new message "This record has 1 accepted update(s) pending - press Save or Cancel as desired".

    Screenshot-14-UpdateAccepted.png
  15. Be sure that the "CGI Name" is unique. Click "Save".

    Screenshot-15a-WebEngineCreated.png

    If you receive "AHD65322:A duplicate record was encountered with the same CGI name for the server. Insert or Update failed.", then change the "CGI Name" to an unused name such as, in this case, "pdmweb1.exe".  Then click "Save" again.

    Screenshot-15b-AHD65322.png
  16. Click "Close Window".
  17. Click "Save" in the "Update Configuration" window.

    Screenshot-17b-ConfigurationUpdated.png

    If you click "Close Window" before you click "Save", you will get a popup message asking you if you are sure that you want to cancel the change.
    Click "Cancel" to cancel the closure of the window.  Then click "Save" in the "Update Configuration" window.

    Screenshot-17a-PendingUpdates.png
  18. Click "Close Window".
  19. In the "Configuration List", the new configuration should be listed.
    If not, be sure the "Record Status" of the Filter is set to "Active" and then click "Search">
    Noted that the value of "Current Configuration" for the new configuration item is "NO".
  20. In order to use the new configuration, you must run the Configuration tool (pdm_configure). 

    Screenshot-20-ConfigurationTool.png
  21. During the "Config Options" step, select the new Configuration from the dropdown list.  Then click "Finish".

    Screenshot-21-ServerConfiguration.png
Additional Information:
For more information, search the CA Service Management 14.1 Wiki for "webengine pairs".  For example, one result that refers to the number of domsrvr/webengine pairs is the page that describes the "Hardware and Software Requirements for the Install" (https://docops.ca.com/ca-service-management/14-1/en/implementing/implementing-ca-service-management-14-1/step-4-install-or-upgrade/implementing-ca-service-desk-manager/how-to-install-ca-sdm/step-1-plan-your-ca-sdm-installation/hardware-and-software-requirements-for-the-install)