Running the VisiTelcoLog Service

The VisiTelcoLog Service is implemented as a C++ service. VisiBroker for C++ is pre-requisite for running VisiTelcoLog Service. To run the service make sure that VisiBroker Smart Agent (osagent executable) is running in the network. To start the VisiTelcoLog Service in the background use the following command:

UNIX:

prompt> visitelcolog &

Windows:

prompt> start visitelcolog.exe

By default the service starts at port 14200. The port can be changed using the property vbroker.dslog.listener.port. Once started, the service prints the following message to the console:

Telco Log service is ready

VisiTelcoLog Service creates a directory called visidslog.dir to store all of its persistent data. By default it creates this directory in the current directory. The location for the data store directory can be changed using the vbroker.dslog.dir property. This directory also contains the log back end.

Also note that for the sake of convenience the compiled stub and skeleton code of the OMG Telecom Log Service IDLs are provided as a static library. Please see the examples on how to use it. The generated skeletons are for POA.

Getting entry references

VisiTelcoLog starts up by default at port 14200. This port can be changed using the vbroker.dslog.listener.port property.

Applications trying to bind to BasicLogService, EventLogService, NotifyLogService, TypedEventLogService or TypedNotifyLogService can use corbaloc to resolve initial reference to the service.

Applications can use the following ORB property:

-ORBInitRef corbaloc::<host>:<port>/BasicLogService
-ORBInitRef corbaloc::<host>:<port>/EventLogService
-ORBInitRef corbaloc::<host>:<port>/NotifyLogService
-ORBInitRef corbaloc::<host>:<port>/TypedEventLogService
-ORBInitRef corbaloc::<host>:<port>/TypedNotifyLogService

Properties

 

Property	Default	Description
vbroker.dslog.listener.port	14200	Specifies the listener port for the service. Valid values include any legal port value in the port range.
vbroker.dslog.console	true	When true, prints to the console when the service starts up. For daemon processes, this should be set to false.
vbroker.dslog.dir	./visidslog.dir	The service stores all of its persistent data in the specified directory. If the directory is not valid or does not have the right permissions, the service will fail to start up. Valid values include any valid directory location.
vbroker.dslog.getRecListMax	1000	The number of LogRecords that need to be matched in the query for an iterator to be returned.
vbroker.dslog.scheduleByServerLocalTime	false	When set to true, calls tzset() for scheduler time.
vbroker.dslog.waitForLogAvailable	20	Waiting period (in seconds) for the pull supplier for space to be available to log a pulled event. Valid values include any non-zero wait duration in seconds.
vbroker.dslog.basicLogFactory.name	VisiBasicLogFactory	The name with which the BasicLog factory is activated. Valid values include any object name.
vbroker.dslog.basicLogFactory.iorFile	null	The name of the file where the BasicLog factory object's IOR will be written. Valid values include any valid file name.
vbroker.dslog.eventLogFactory.name	VisiEventLogFactory	The name with which the event log factory is activated. Valid values include any object name.
vbroker.dslog.eventLogFactory.iorFile	null	The name of the file where the event log factory object's IOR will be written. Valid values include any valid file name.
vbroker.dslog.notifyLogFactory.name	VisiNotifyLogFactory	The name with which the notify log factory is activated. Valid values include any object name.
vbroker.dslog.notifyLogFactory.iorFile	null	The name of the file where the notify log factory object's IOR will be written. Valid values include any valid file name.
vbroker.dslog.backend.garbageCollectorInterval	60	The time interval (in minutes) for the log record garbage collector thread to run. When the thread runs, it garbage collects all expired log records. The thread runs only when the record life for the log is specified. Otherwise, it does not run. Valid values fall in the range of 1 to 180 minutes.
vbroker.dslog.backend.file.fragmentationLimit	75%	Percentage of fragmentation that triggers automatic defragmentation. Automatic defragmentation happens only when deleting. Valid values fall in the range of 10% to 80%.
vbroker.dslog.backend.file.dir	null	The directory location for back-end database and support files. The directory path must be valid and must have the necessary permissions. Note that the performance of the service depends on this directory.
vbroker.log.enable	false	To see the debug log statements from this service, set this property to true. For the various source names options for debug log filtering, see Debug Logging properties in the VisiBroker for C++ Developer's Guide.