Install > Install Service Manager Collaboration > Troubleshoot the Service Manager Collaboration deployment

Troubleshoot the Service Manager Collaboration deployment

This section provides information that can assist you in troubleshooting issues that are associated with Service Manager Collaboration.

Troubleshooting - Failed to start the chat server

Description

Failed to restart the Openfire chat server.

Root cause

Some related processes still exist.

Solution

Check the openfire.exe process, the LyncAgent.exe process, and the Lync.exe process in Windows Task Manager when restarting the Openfire chat server. If these processes still exist after the Openfire service is stopped, you must end these processes manually before starting the Openfire chat server.

Note

The LyncAgent.exe process and the Lync.exe process exist only when you have integrated Collaboration with Microsoft Skype for Business.

Troubleshooting - Failed to connect to the Collaboration server

Description

When you log on to the Service Manager web client by using https, the system displays the following error:

Root cause

The Openfire service is not started, or Service Manager Collaboration lost connection to the Openfire server, or Service Manager Collaboration is not properly configured.

Solution

Perform the following tasks:

Task 1: Make sure that the Openfire Windows service is started

Go to Control Panel to check that the Openfire service (Service Manager x.xx.xxxx Chat Server) is started.

Task 2: Try to reconnect to the Openfire server

Click the Notifications button to try to reconnect to the Openfire server.

Task 3: Verify the Service Manager Collaboration configurations

Follow these steps to verify the Service Manager Collaboration configurations:

  1. Log on to Service Manager as a system administrator.
  2. Click System Administration > Ongoing Maintenance > Collaboration > Configuration.

  3. Ensure the following fields are configured correctly, as described in the following table.

    Field Value
    Chat Service Domain and Port http://training.sm-demo.com:8088
    Bosh URL /of-http-bind/
    Chat Service URL /chatservice/
    Domain Name Set it to the Openfire Domain that you set up in Task 5: Deploy the chat server. In our example steps, it is training.sm-demo.com.
    Plugin URL /of-plugins/

  4. Log out from Service Manager.
  5. To verify your Openfire configurations, go to your web browser and access https://localhost:9091. The Openfire Administration Console page opens.

  6. Log in with username admin and password SM-training. The system displays the Server Information page.

  7. On this Server Information page, verify the Server Name (domain name) of the Openfire server.

  8. To update the server name, go to the bottom of this page and click Edit Properties.

  9. Edit the Server Name as appropriate.

    Note

    The Admin Console Port field is empty on this page. Set the value to 9090 if you want to use the default value or to the value you choose.

  10. Click Save Properties.

  11. Ensure you receive a message that indicates the server properties were successfully updated.

  12. Restart the Chat Server service in Windows services.

  13. Log on to Service Manager again to check whether Collaboration works. If it does not, proceed to the next task.

Task 4: Reinstall Openfire

You may need to reinstall Openfire if you have checked all your settings but still see the following error message:

Follow these steps to reinstall Openfire:

  1. Log out from Service Manager.
  2. Stop the Windows service named Openfire.

  3. Open a DOS command prompt and change the directory to C:\Program Files (x86)\Micro Focus\Service Manager x.xx\ChatServer\bin.

  4. Run the nssm remove SmChatServer command to uninstall the Windows service. The following messages are displayed:

    Service is already stopped.
    Uninstalled service 'Openfire'.
  5. Navigate to the C:\Program Files(x86)\Micro Focus\Service Manager x.xx directory, and then remove the ChatServer directory.

  6. Log on to your Service Manager database and list the tables.

  7. Locate the tables prefixed with 'of' in the list.

    All tables prefixed with lowercase 'of' need to be dropped.

  8. Drop the tables until all tables prefixed with 'of' are removed.

  9. Reinstall the Openfire chat server. For detailed instructions, see Task 5: Deploy the chat server.

  10. Configure LW-SSO for the chat server. For details, see Task 11: Configure LW-SSO for the chat server.

  11. Log on to Service Manager again to check whether Collaboration works.