Steps to change or update an already configured EMS user which has administrator privileges with a newly created one in TIBCO ActiveMatrix BPM Environment.

Steps to change or update an already configured EMS user which has administrator privileges with a newly created one in TIBCO ActiveMatrix BPM Environment.

book

Article ID: KB0071150

calendar_today

Updated On:

Products Versions
TIBCO ActiveMatrix Service Grid 3.4.0 and 3.4.1

Description

TIBCO Enterprise Message Service is used for 3 types of purposes in the ActiveMatrix BPM Environment :
A.) Messaging Bus:-
=====================
-> An Environment's Messaging Bus is the communications backbone that mediates message exchange between service consumers and providers. When a consumer makes a service request, it is the responsibility of the Messaging Bus to locate providers that offer the Service and deliver the message to a provider.

It is used in the distributed environment so that distributed applications can communicate. In the BPM environment, it is used by default.

B.) Notification Server:-
===================
-> The Notification Transport Server is the backbone of the TIBCO ActiveMatrix Enterprise and is used by all the Hosts and Nodes in the Enterprise. The Notification Server is an Enterprise Messaging Service server that performs two essential system functions within the TIBCO ActiveMatrix platform. It delivers status messages sent by hosts and nodes to the Administrator server.

 
The status messages include:
  • Task execution status
  • Runtime status of an entity (Host, Node, Application component, Resource Instance, and so on).
C.) amx.bpm.app and Custom applications (If applicable):-
===================
-> "amx.bpm.app" Application in TIBCO BPM Enterprise (formerly TIBCO ActiveMatrix BPM) and custom applications (i.e. configured to use EMS) use TIBCO Enterprise Message Services. These applications consume the Resource Template and Resource Instance to use the EMS resource.

As we know, while creating "TIBCO ActiveMatrix BPM Environment" or creating any "custom application which uses EMS in ActiveMatrix BPM Environment", a supported version of TIBCO Enterprise Message Service must be installed and configured with the appropriate EMS User. The best way is to use TIBCO Enterprise Message Service servers with the user who has administrator privileges. If our TIBCO ActiveMatrix BPM infrastructure connects to its TIBCO Enterprise Message Service servers with a user who does not have administrator privileges, then we must configure the servers to grant the minimum level of privileges to the users that will enable them to perform their tasks.

But, as per the customer's business requirements, they may need to change or update their already configured EMS User. Hence, this article lists the steps that will help us to change or update an already configured EMS User with the newly created one via TIBCO ActiveMatrix (AMX) Administrator.

Environment

All Environments.

Resolution

Use the following steps to update your already configured EMS user with the newly created one in TIBCO ActiveMatrix BPM Environment :
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
1.) Stop all BPM and AMX nodes including EMS instances.

2.) Take a reliable, full, offline backup of your environment. This includes below :
=====================================================
+ Filesystem - TIBCO_HOME  - from all servers including ActiveMatrix (AMX) Administrator / EMS. Preserve timestamps, please.
+ Filesystem - CONFIG_HOME - from all servers including AMX Administrator / EMS. Preserve timestamps, please.
+ Filesystem - SHARED_MOUNT used by AMX / BPM / EMS (as applicable). Preserve timestamps, please.
+ Database - AMX (required) / BPM (required) / EMS (as applicable)
==================================================
3.) Bring up EMS and AMX/BPM Hosts/Environment.

4.) Perform the below changes via TIBCO ActiveMatrix (AMX) Administrator UI :
=============================================================
I.) In the Messaging Bus: -
**************************
a.) Update messaging bus details in Non-System Environment (e.g. BPM Environment) :
------------------------
i.) Stop all the applications running under this environment including the "tibco.amx.platform" and "amx.bpm.app" applications. The best way to do this is by stopping the Nodes of Non-System Environment.
(NOTE: We only need to stop the nodes of the "Non-System Environment" DON'T stop the SystemNode. Please keep all applications running on the System Environment. Also, make sure that 'amx.artifacts.app' is running on the System Environment).
ii.) After stopping all the applications under this environment GoTo Infrastructure ---> Environment ----> Select Non-System Environment ----> Under Configuration Tab ----> messaging bus ---> update your EMS Username and password to the newly created username and password.
iii.) Test the connection. After a successful test click on 'save' followed by 'Yes' on the confirm screen.
iv.) Start all the applications or start the Node( if it was stopped in step 1) and check if everything is running fine or not.
------------------------
b.) Update messaging bus details in the System Environment :
------------------------
i.) Stop all running applications including "tibco.amx.platform" and "com.tibco.amx.platform.artifactserver" applications. Please note that the admin console will still be accessible even after stopping all applications under the System Environment.
ii.) Make sure all nodes associated with System Environment are running.
iii.) After stopping all the applications under this environment GoTo Infrastructure ---> Environment ----> Select System Environment ----> Under Configuration Tab ----> messaging bus ---> update your EMS Username and password to the newly created username and password.
iv.) Test the connection. After a successful test click on 'save' followed by 'Yes' on the confirm screen.
v.) Start all the applications or start the Node and check if everything is running fine or not.
------------------------
**************************

II.) In Notification Server: -
**************************
i.) Make sure that all hosts/nodes are running before proceeding with changing notification server details.
ii.) Goto Admin Configuration ---> Admin Server----> Transport Configuration Tab and update your EMS Username and password to the newly created username and password.
iii.) Test the connection. After a successful test click on the save button.
iv.) Goto Host and check the Action history it should be "Update notify transport configuration Successfully".
**************************

III.) For amx.bpm.app and Custom applications (If applicable): -
**************************
a) JNDI Connection Configuration :
------------------------
i.) Goto Shared Object ---> From the type drop list, select JDNI Connection Configuration to filter RT and make the scope as global and environment and application drop as *.
ii.) Change the EMS Username and password to the newly created username and password in Each RT display in the table one by one.
Select the RT --> General tab --> Make the changes in the username and password fields.
iii.) After changes have been completed, click on the save button and then one pop-up will come up, click cancel.
iv.) Goto the resource instance tab and install the resource instance.
------------------------

b) JMS Connection Factory :
------------------------
i.) Goto Shared Object ---> From the type drop list, select JMS Connection Factory to filter RT and make the scope as global and environment and application drop as *.
ii.) Change the EMS Username and password to the newly created username and password in Each RT display in the table one by one.
Select the RT --> General tab --> Make the changes in the username and password fields.
iii.) After changes have been completed, click on the save button and then one pop-up will come up, click cancel.
iv.) Goto resource instance tab install the resource instance.
------------------------

C) JMS Connection Factory Configuration :
------------------------
i.) Goto Shared Object ---> For the type drop list, select JMS Connection Factory Configuration to filter RT and make the scope global and environment and application drop as *.
ii.) Change the EMS Username and password to the newly created username and password in Each RT display in the table one by one.
Select the RT --> General tab --> Make the changes in the username and password fields.
iii.) After changes have been completed, click on the save button and then one pop-up will come up, click cancel.
iv.) Goto resource instance tab install the resource instance.
------------------------
**************************
=============================================================

5.) After performing the above steps, please restart the complete environment with clearCache option
<CONFIG_HOME>/tibcohost/<hostName>/host/bin/tibcohost stop
./tibcohost start -clearCache &

6) Perform some basic lifecycle tests and business sanity tests to make sure it works fine.

 

PLEASE NOTE :
============================================
Perform these steps in a lower environment before proceeding to Production.

Issue/Introduction

The scope of this article is to detail the steps to follow in order to change or update an already configured EMS user with the newly created one via TIBCO ActiveMatrix (AMX) Administrator.

Additional Information

1) Messaging Bus details:-
=====================================
https://docs.tibco.com/pub/amsg/3.4.1/doc/html/GUID-6BC113D6-58EC-410B-A475-8D2211F1BFBD.html

2) Notification Server details:-
=====================================
https://docs.tibco.com/pub/amsg/3.4.1/doc/html/GUID-400AC71E-F376-49B7-AFBE-6189A2E24C7A.html

3) Enterprise Message Server:-
=====================================
https://docs.tibco.com/pub/amsg/3.4.1/doc/html/GUID-D178CF26-2332-445F-B977-C8F73F12E145.html
https://docs.tibco.com/pub/amsg/3.4.1/doc/html/GUID-0A883735-14CE-4124-B48D-63264035C181.html?scroll=GUID-0A883735-14CE-4124-B48D-63264035C181
https://docs.tibco.com/pub/amx-bpm/4.3.0/doc/html/install/GUID-B18F3A26-4032-45CC-84C3-A63949782ED2.html