The list-generations
task lists information about the generations that are currently in a Record Store instance.
The syntax for this task is:
recordstore-cmd list-generations -a RecordStoreInstanceName [-h Hostname] [-l true|false] [-p PortNumber]
where:
-a (or --instanceName) specifies the name of a Record Store instance. Required.
-h (or --host) specifies the host where the CAS Service is running. If the flag is omitted, the default is the value of the
com.endeca.itl.cas.server.host
property incommandline.properties
. If the property is not set, the value then defaults to localhost. Optional.-l (or --isPortSsl) specifies whether to communicate with the service using an HTTPS connection. A value of true uses HTTPS and treats the
com.endeca.itl.cas.server.port
property as an SSL port. A value of false uses HTTP and treatscom.endeca.itl.cas.server.port
as a non-SSL port. Specify false if you enabled redirects from a non-SSL port to an SSL port. Optional.-p (or --port) specifies the port of the CAS Service. If the flag is omitted, the default is the value of the
com.endeca.itl.cas.server.port
property incommandline.properties
. If the property is not set, the value then defaults to 8500. Optional.
The task output consists of these fields:
STATUS
- the status of the generation, which is STARTED (the generation is being written to the Record Store instance), COMPLETED (the generation has been written and committed to the Record Store instance), or BEING_CLEANED (the cleaner is currently cleaning the generation).CREATION TIME
- the date (in YYYYMMDD format) and time (in UTC format) that the generation was created. This value is based on the clock of the machine running the CAS Service.
If no generations have been written, this message displays:
There are no generations in the record store
Example 36. Example of listing generations
If there are generations in the Record Store instance, the output of this command:
recordstore-cmd list-generations -a RS1
is similar to this example:
ID STATUS CREATION TIME 1 COMPLETED 2008-05-21T14:35:16.326Z 2 COMPLETED 2008-05-21T17:32:30.658Z
The sample output shows that there are two committed generations in the Record Store instance.