Software AG Products 10.7 | Integrating On-Premises and Cloud Applications | Universal Messaging | Universal Messaging Enterprise Manager | Realm Administration | Connecting to Multiple Realms
 
Connecting to Multiple Realms
An Enterprise Manager can connect to multiple Universal Messaging realms at the same time. These realms can be standalone or clustered, so developers and administrators can now manage and monitor the whole Universal Messaging enterprise infrastructure from a single instance of the Enterprise Manager. After you connect to a set of Universal Messaging realms, you can save the connection information, so that the Enterprise Manager automatically connects to all those realms each time it starts.
A bootstrap RNAME environment variable is needed the first time you run the Enterprise Manager or if your connection info file is empty. If you use the shortcut / link created by the installation process, this will be automatically set to point to the locally installed realm's bootstrap interface, so you do not need to take any additional action. If, however, you open a client command prompt and you want to initially connect to a realm other than the local one, you must change your RNAME environment variable.
For more information about how to set the RNAME variable, see the section Communication Protocols and RNAMEs in the Developer Guide.
Note that after your realm connection information is saved, the RNAME environment variable is ignored.
To connect to a realm server in the Enterprise Manager:
1. Select Connections > Connect To Realm.
2. In the RNAME field of the Connect to a realm dialog box, specify the RNAME that points to the interface of the Universal Messaging realm to which you want to connect. Click OK.
If the connection is successful, a new realm node is rendered on the tree with the unique name of that realm. You can manage and monitor the new realm by selecting the newly rendered tree node. The name displayed for the realm uses the syntax: realmname(host:port), for example realm1(MyHost:11010).
When you connect to a realm server that is part of a cluster or zone, the Enterprise Manager automatically connects to and displays the other realms in the cluster or zone.
If you enter an incorrect RNAME, if the realm to which you want to connect is not running, or if the realm is running but the particular interface is not started, the connection will fail.
To make this connection get attempted each time you start the Enterprise Manager, you must save your connection information.