TIBCO EMS Tutorial : Useful commands in EMS
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. ----------------------------------------------------------------------