Installing Chat on a remote server - Documentation for BMC Remedy with Smart IT 1.2

Download and install the latest Openfire version from the  official site .
If Openfire is being installed at the same VM as Smart IT, ensure that the Openfire admin console uses a port other than 9090, which is reserved for the Apache Tomcat service.

Note

BMC recommends that you download and install Openfire version 3.9.3 or later, and choose the option Does not include Java JRE. The JRE bundled with Openfire might be an older version that is not compatible with BMC MyIT and Smart IT. For more information, see the system requirements for Smart IT and for BMC MyIT.

1. From the smartitInstallDirectory/Smart_IT_MyIT/Openfire/plugins folder, copy the auth-plugin-full.jar file to the openfireInstallDirectory/plugins folder.
   (The auth-plugin plugin is compatible with JRE 1.7 for Smart IT 1.2 and BMC MyIT 2.6.)

2. Start the Openfire server.
3. On the administration console, on the Server > Server Manager > System properties tab, perform the following actions:

   1. Change the value of the provider.auth.className property to org.jivesoftware.openfire.auth.HybridAuthProvider.

   2. Create the new hybridAuthProvider.primaryProvider.className property with the org.jivesoftware.openfire.auth.DefaultAuthProvider value.
   3. Create the new hybridAuthProvider.secondaryProvider.className property with the com.bmc.bsm.galileo.chat.openfire.AuthPlugin value. 
       

   4. Create the new provider.auth.authResource property with the url/rest/users/chat/ value where url is the path to the Smart IT instance (for example, ). 

      Example

   5. Create a new route.all-resources property with the value true.
      This property enables multiple application chat windows to receive the same messages.
   6. (Optional) To set up a multitenant environment, create a new galileo.multitenancy property with the value true.

1. Open the admin console and click the Plugins tab.
2. Install the Monitoring Service feature.

1. Clear the Archive one-to-one chats check box.
2. Select the Archive group chats check box.
3. Change the value of the Max Message Age field to 0.

Enable HTTP binding and Cross-Origin Resource Sharing (CORS) to allow the Smart IT JavaScript code to connect to Openfire by using HTTP protocol from the browser: 

1. On the Server > Server Settings > HTTP Binding > HTTP Bind Settings tab, select the Enabled check box and enter the Port and SSL Port field values.

2. In the Script Syntax section of the HTTP Bind Settings tab, select the Disabled check box.
3. In the Provides support for CORS (Cross-Origin Resource Sharing) section, select the Enabled check box.
    

Add the following statements to the connect.properties file in tomcatInstallDirectory/external-conf/:

chat.server.cm.host = <FQDN of openfire server>
chat.server.client.port = 5222
chat.server.admin.login = admin
chat.server.admin.password = admin
chat.server.admin.pool.size = 6
chat.server.groupChatService = conference
chat.server.domain = <same FQDN as set in chat.server.cm.host>
chat.server.boshUrl = server>:7070/http-bind/ 

Edit the value of the allow-access-from domain property in the openfire/conf/cross-domain-policy.xml file to allow access to data from a specific domain (or domains), as shown:

Add more domains on separate lines; for example:

<allow-access-from domain="domain1.com" to ports="5222,5223,7070,7443" secure="true"/>
<allow-access-from domain="domain2.com" to ports="5222,5223,7070,7443" secure="true"/> 

Warning

The default value is set to ‘*’ (asterisk), which allows access to data from any domain. BMC recommends that you change the value to allow access only from a specific domain (or domains).