This documentation supports the 3.3 version of BMC Digital Workplace. To view the latest version, select the version from the Product version menu.

Installing BMC Digital Workplace and Smart IT in server group

This topic describes the process to install BMC Digital Workplace  and Smart IT in a cluster. Other options are described in Performing the Smart IT and BMC Digital Workplace installation.

Before you begin

Complete the steps described in Preparing for installation of BMC Digital Workplace and Smart IT. In addition to steps that are required for all installations, some steps are required for high availability.

To install BMC Digital Workplace and Smart IT in server group

If you are planning to use the chat features of Smart IT and have installed Openfire in server group, specify the Use external installation of Openfire option during installation. See, BMC Digital Workplace and Smart IT installation worksheets.

  1. Install BMC Digital Workplace and Smart IT on the primary server.
    To use the GUI wizard, see, Installing BMC Digital Workplace and Smart IT on a single server. To use the silent installer, see Installing BMC Digital Workplace and Smart IT using silent mode.
    Specify the with In a New Cluster option during installation. See, BMC Digital Workplace and Smart IT installation worksheets.

  2. Install BMC Digital Workplace and Smart IT on the secondary server. 
    Specify the with In an Existing Cluster option during installation. See,  BMC Digital Workplace and Smart IT installation worksheets .

  3. Create your MyIT administrator account, as described in Setting up administrator authentication.
  4. Change the AR System server references to the load balancer for the AR System server group, as illustrated in the video that follows and the accompanying steps.
  5. If the BMC Digital Workplace and Smart IT cluster is running  with a load balancer, point the AR System server to the BMC Digital Workplace and Smart IT load balancer.

    1. Log on to the AR System server via the Mid-Tier.

    2. Open the SHR:SHR_KeyStore open form by typing form name in URL directly or opening it from the object list.

    3. On the Settings form, replace host name with  the load balancer host name and port number, and then click Save.

  6. In the secondary server, replace the API and secret value in the connect.properties  file located at <install_dir>\Apache Software Foundation\Tomcat7.0\external-conf\ with the same API and secret as that of the first BMC Digital Workplace and Smart IT server. See  Sample connection properties file
    api.token.<Token value available at SHR:SHR_KeyStore> = <Secret value available at SHR:SHR_KeyStore>

    Note

    Perform this step on each BMC Digital Workplace and Smart IT server in the cluster.

  7. Start SmartITMyIT Tomcat service for all BMC Digital Workplace and Smart IT servers in the cluster.

To change the AR system server reference in BMC Digital Workplace and Smart IT

Use this procedure to change the AR System server reference from a single server to the load balancer for the AR System server group.The following video (4:42) explains how to change AR server references stored in the BMC IT Service Management persistent data store, and in the BMC Digital Workplace and Smart IT database.

Note

The following video shows an older version of BMC Digital Workplace. The previous product name was MyIT. Although there might be minor changes in the user interface, the overall functionality remains the same.


https://youtu.be/Zq-1RLq_wZs

The preceding video illustrates the following steps.

  1. Open Digital Workplace Admin console and modify primary AR Server entry in the persistent data store by renaming primary AR server name with AR load balancer name and replace port number with AR load balancer port number, and then click Save.

  2. In the Applications tab, verify whether data store value is replaced with AR load balancer name. If it is not, select a data store type by selecting a newly added data store, and click Save.

  3. Stop the SmartITMyIT Tomcat service and update the CONFIGURATION_PARAMETER table under the System tables with the following entries to point to the AR load balancer:

    connect.arsystem.hostName = <AR load balancer name> port = <AR load balancer port number>

    Note

    Perform this step on each BMC Digital Workplace and Smart IT instance, and do not start the SmartITMyIT Tomcat service after update.

  4. Run the following SQL queries on the BMC Digital Workplace and SmartIT database to update the Provider setting:

    Select * from SmartIT_System.CONFIGURATION_PARAMETER where NAME ='connect.arsystem.hostName' and VALUE = <Primary AR server name>
    update SmartIT_System.CONFIGURATION_PARAMETER SET VALUE = <AR LB Name> where NAME ='connect.arsystem.hostName' and VALUE = <Primary AR server name>
    Select * from SmartIT_System.CONFIGURATION_PARAMETER where NAME ='connect.arsystem.port' and VALUE = <Primary AR Server Port>
    update SmartIT_System.CONFIGURATION_PARAMETER SET VALUE = <AR LB Port Number> where NAME ='connect.arsystem.port' and VALUE = <Primary AR Port>
    Select * from SmartIT_System.CONFIGURATION_PARAMETER where NAME ='connect.arsystem.password' and VALUE = <password>
    update SmartIT_System.CONFIGURATION_PARAMETER SET VALUE = <new password> where NAME ='connect.arsystem.password' and VALUE = <password>

    Ensure that you encrypt your password using the BMC Digital Workplace and Smart IT Maintenance Tool.

Where to go from here

Verifying the BMC Digital Workplace and Smart IT server installation

Was this page helpful? Yes No Submitting... Thank you

Comments