Text User Interface client for CORBA Telecom Log Service.
Project description
Telecom Log Service Client (tlscli) is a Python command-line client for CORBA Telecom Log Service.
Using it you can:
create a new log
query a log
add or remove log records
- For more information on the TelecomLogService, see:
- The project is hosted on Launchpad:
Example
Here’s an example session, assuming a Telecom Log Service is running:
me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` list me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` create 0 me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` list 0 me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` info 0 id: 0 QoS: none max-record-life: infinite max-size: unlimited current-size: 56 bytes records: 1 log-full-action: wrap administrative-state: unlocked forwarding-state: on operational-state: enabled interval: now - forever availability-status: { off-duty: False; full: False } capacity-alarm-thresholds: [100] week-mask: ------------------------------------------------------------------------------ me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` write 'Hello world!' to 0 me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` info 0 id: 0 QoS: none max-record-life: infinite max-size: unlimited current-size: 57 bytes records: 1 log-full-action: wrap administrative-state: unlocked forwarding-state: on operational-state: enabled interval: now - forever availability-status: { off-duty: False; full: False } capacity-alarm-thresholds: [100] week-mask: ------------------------------------------------------------------------------ me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` retrieve 10 after `date +%Y%m%d` from 0 id: 1 time: Sat Dec 25 17:11:57 2010 attributes: [] info: Hello world! ------------------------------------------------------------------------------
This creates a new log with id 0, then write a new log record to it with text Hello world.
Prerequisites
- To install tlscli, you need:
a working installation of omniORBpy. Indeed CORBA stubs are generated at install time.
To proceed to installation, run the following command from where you unpacked tlscli:
me@mymachine$ python setup.py install --user
This will automatically compile stubs, and install everything into your $HOME/.local (tlscli itself will be in $HOME/.local/bin).
To run tlscli, you need a Telecom Log Service running somewhere. tlscli is known to work with the following implementations:
Running
When invoking tlscli you need to specify how to connect to the LogMgr. The LogMgr is the object to use to access (or create) logs.
This is achieved by specifying an initial reference for the LogMgr, using one of the three following methods:
add -ORBInitRef LogMgr=corbaname:iiop:1.2@MACHINE:PORT#NAME
add -ORBInitRef LogMgr=corbaloc:iiop:1.2@MACHINE:PORT/NAME
add -ORBInitRef LogMgr=IOR:IOR
where MACHINE:PORT specify where to find a Telecom Log Service (or a Name Service for corbaname), and NAME is the name to use for the service (or the Name Service for corbaname).
Please read The corbaloc and corbaname URLs chapter in the great online free book CORBA Explained Simply.
Commands
Creating a new log
To create a new log, use tlscli create. This will return the id of the newly created log.
Querying an existing log
list will return the id of all logs available from the given LogMgr. This is the default command if none is specified
info will return information about an existing log, such as size, record count and current status
query can be used to search for log records matching a given constraint
retrieve retrieves a given count of log records before or after the specified date
Modifying an existing log
write adds a new log record to an existing log
delete removes log records matching a given constraint from an existing log
For more information on commands, use tlscli --help.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.