TIBCO EMS Tutorial : Useful commands in EMS

Bytechieswiki

  SEP 29, 2018  Administration EMS Commands, EMS, TIBCO

There are so many commands in Tibco EMS which can be used to perform different tasks in EMS administration. But we may not use all these commands frequently. In this post, I am sharing some commonly used commands in Tibco EMS administration.

I

If you type ‘I’ in the administration tool, you will get an overview details of the EMS server.

tcp://EMS01:7020> I
 Server:                   EMS01 (version: 8.4.0 V14)
 Hostname:                 D631RV
 Process Id:               2751
 State:                    active
 Runtime Module Path:      /opt/tibco/ems/8.4/bin/lib/64:/opt/tibco/ems/8.4/lib/64
 Topics:                   5 (0 dynamic, 0 temporary)
 Queues:                   16 (0 dynamic, 2 temporary)
 Client Connections:       0 of 2500 maximum
 Admin Connections:        2
 Sessions:                 2
 Producers:                2
 Consumers:                2
 Durables:                 0
 Log File Size:            26.2 MB out of 250MB
 Pending Messages:         1850
 Pending Message Size:     745.4 Kb
 Message Memory Usage:     615.5 Kb out of 4GB
 Message Memory Pooled:    626.0 Kb
 Synchronous Storage:      1.0 GB
 Asynchronous Storage:     1.0 GB
 Fsync for Sync Storage:   disabled
 Inbound Message Rate:     0 msgs/sec,  0.0 Kb per second
 Outbound Message Rate:    0 msgs/sec,  0.0 Kb per second
 Storage Read Rate:        0 reads/sec,  0.0 Kb per second
 Storage Write Rate:       0 writes/sec, 0.0 Kb per second
 Uptime:                   22 days 9 hours 43 minutes

Create

This command is used to create EMS objects and configurations. See below for the full list of creating command.

Create a User:

create user         <name> [<description>] 
                           [password=<password>]

tcp://EMS01:7020> create user user1 "Test User" password=password
User 'user1' has been created

Create a Group:

create group        <name> [<description>]

tcp://EMS01:7020> create group group1 "Sample Group"
Group 'group1' has been created

Create a Topic or Queue:

create topic        <name> [<properties>]

tcp://EMS01:7020>create topic SAMPLE.TOPIC secure

create queue        <name> [<properties>] 

tcp://EMS01:7020>create queue SAMPLE.QUEUE secure

Note: for queues and topic we have different destination properties and secure is one of them. Please read Destination properties in Tibco EMS to know more.

Create a route & Durable:

create route        <name> url=<url> [zone_name=<zone-name>]
                                     [zone_type=<zone-type>] 
                                     [<properties>]

tcp://EMS01:7201>create route EMS02 url=tcp://EMS02:7201 zone_name=Z1 zone_type=1hop

create durable      <topic> <name> [<properties>]

tcp://EMS01:7201>create durable SAMPLE.TOPIC EMS02 route

We need some pre-configuration to make a route between the EMS server. Read How to create a route between the EMS server to know the full steps.

Create a Bridge :

create bridge       source=<type>:<name> 
                    target=<type>:<name>
                    [selector=<selector>]

tcp://EMS01:7020>create bridge source=topic:TECH.TOPIC 
                               target=queue:TECH.QUEUE 
                               Selector="JMSCorrelationID='SAM'"

Read What is Tibco EMS bridge and how to use it to know more

Permissions

grant topic <topic-name> <[group=]group-name>|<[user=]user-name>
                          <permissions>

grant queue <queue-name> <[group=]group-name>|<[user=]user-name>
                          <permissions>


tcp://EMS01:7020>grant topic TECH.TOPIC user=user1


revoke topic <topic-name> <[group=]group-name>|<[user=]user-name>

tcp://EMS01:7020>revoke queue TECH.QUEUE user=user1

Modify Properties

//add properties for destinations, routes and factories

addprop topic   <topic-name>   property1[,property2...]
addprop queue   <queue-name>   property1[,property2...]

//remove properties of destinations, routes and factories

removeprop topic   <topic-name>   <properties>
removeprop queue   <queue-name>   <properties>

help

‘help’ command as it will give you all that you need. In fact, if you know this command you don’t need to worry about any other commands in EMS.

tcp://EMS01:7020> help
----------------------------------------------------------------------
Commands:
   add             addprop         autocommit      commit
   compact         connect         create          delete
   disconnect      echo            exit            grant
   help            info            jaci            purge
   remove          removeprop      resume          revoke
   rotatelog       set             setprop         show
   showacl         shutdown        suspend         time
   timeout         transaction     updatecrl       whoami
----------------------------------------------------------------------
Type 'help commands' for commands summary
Type 'help <command>' to receive help on specified command
Type 'help ssl' for help on SSL parameters for factories and routes.
Type 'help ciphers' for help on cipher names and cipher list syntax.
Type 'help permissions' for help on user and administrative permissions.
----------------------------------------------------------------------