How to configure Enterprise Message Service Central Administration (EMS CA)client and server initially after installation?

How to configure Enterprise Message Service Central Administration (EMS CA)client and server initially after installation?

book

Article ID: KB0085172

calendar_today

Updated On:

Products Versions
TIBCO Enterprise Message Service -
Not Applicable -

Description

Resolution:
Description:
= = = = = =
After installing the EMS CA Server on a Linux box and the EMS CA client on a Windows box, it is very confusing to configure them appropriately simply by following the documentation.

Environment:
= = = = = = =
Linux 2.6 kernel or higher for EMS CA server
Any Windows machine for EMS CA client
EMS Central Administration Server software
EMS Central Administration Client Software

Resolution:

1). The EMS CA server software needs to be installed on a Linux box with kernel version 2.6 or higher. This package has not been tested on machines having 2.4 kernels and httpd startup issues have been seen when the software is installed on Linux machines with 2.4 kernels.

2). The httpd.conf file located in $TIBCO_HOME/ems/ca/1.0/httpd/conf needs to be modified as follows:

&ltLocation /svn>
    DAV svn
    SVNPath $TIBCO_HOME/ems/ca/1.0/repos
</Location>

If not already set, point the SVNPath to the repos directory of your current EMS CA installation.

For LDAP based authentication, the &ltLocation> section of the file needs to be modified as follows:

&ltLocation />
    Order allow,deny
    Allow from 127.0.0.1/255.0.0.0
#
    AuthUserFile /dev/null
    AuthType Basic
    AuthName "TIBCO EMS Central Administration"
    AuthBasicProvider file ldap
    AuthzLDAPAuthoritative off

#     windows directory server
     AuthLDAPURL "ldap://10.105.70.170:389/DC=test,DC=na,DC=tibco,DC=com?cn?sub?(objectClass=*)"
     AuthLDAPBindDN "CN=Administrator,CN=Users,DC=test,DC=na,DC=tibco,DC=com"
    AuthLDAPBindPassword Tibco123

    Require valid-user
    Satisfy Any
</Location>

For file based authentication, the &ltLocation> section of the file needs to be modified as follows:

&ltLocation />
    Order allow,deny
    Allow from 127.0.0.1/255.0.0.0
#
    AuthUserFile /home2/corp/foo/tibco_linux/ems/ca/user_auth.txt
    AuthType Basic
    AuthName "TIBCO EMS Central Administration"
    AuthBasicProvider file
    AuthzLDAPAuthoritative off

#     windows directory server
#     AuthLDAPURL "ldap://10.105.70.170:389/DC=test,DC=na,DC=tibco,DC=com?cn?sub?(objectClass=*)"
#    AuthLDAPBindDN "CN=Administrator,CN=Users,DC=test,DC=na,DC=tibco,DC=com"
#    AuthLDAPBindPassword Tibco123

    Require valid-user
    Satisfy Any
</Location>


3). A sample user “foo”, whose password is set to “foo” should be created in all EMS servers that are to be monitored.

4). Use the command “grant admin user=foo all” for all EMS servers.

5). Use the command “add member $admin foo” for all EMS servers.

6). Now download the “htpasswd” utility from the Internet onto your Linux box, if you do not have this already.

7). Use the command “htpasswd –c /home2/corp/foo/tibco_linux/ems/ca/user_auth.txt foo”.

8). When prompted for new password and retype the password, entering “foo”.

9). The “pre-commit.perms” file located at $TIBCO_HOME/ems/ca/1.0/repos/conf needs to be modified in order to include the user “foo” in a new line.

10). Modify the “svnserve.conf” file in $TIBCO_HOME/ems/ca/1.0/repos/conf to un-comment the following lines:

anon-access = read
auth-access = write
password-db = passwd
authz-db = authz

11). The authz file at $TIBCO_HOME/ems/ca/1.0/repos/conf needs to be modified in order to include the following line:

foo = rw

12) .The passwd file at $TIBCO_HOME/ems/ca/1.0/repos/conf needs to be modified in order to include the following line:

foo=foo

13). Go to $TIBCO_HOME/ems/ca/1.0/bin and run the “setenv” script.

14). Now start the CA server as “emsca start”.

15). Create a new deployment server as “emsca server create bar-lnx1”. “bar-lnx1” is the name of the box where the CA server is running. This name is the name of the deployment server.

16. Do a “emsca server restart bar-lnx1”. This will start the deployment server.

17. Create an agent for each EMS server you want to monitor. In this example, we have created two agents to monitor two EMS servers running on a desktop and a laptop respectively. Both will be using the same deployment server bar-lnx1.

emsca agent create bar-lnx1 name=FOO-DESKTOP path= TIBCO_HOME/ems/ca/FOO-DESKTOP.emsserver  url=tcp://foo-dt:7222

emsca agent create bar-lnx1 name=FOO-LAPTOP path= TIBCO_HOME/ems/ca/FOO-LAPTOP.emsserver  url=tcp://foo-t400:7222


18. Now install the EMS CA client on a Windows box.

19. Start the EMSCA Eclipse environment. It will ask you to provide a workspace directory.

20. Do a File-&gtNew-&gtTIBCO EMS Central Administration Project. It will ask you for the host name, where the CA server is running and the port number. The port number is 9011 by default. If it asks you for the username/password, use “foo/foo”.

After this, the documentation is very straight forward on how to sync the configs and how to save configurations to a repository.

Issue/Introduction

How to configure Enterprise Message Service Central Administration (EMS CA)client and server initially after installation?