Show statistics/Status of EnduraData Content Replication


Check for Updates of your file sync and replication software from www.enduradata.com

edjob



NAME

edjob - Display File Transfer and Replication Job Information and History

SYNOPSIS

edjob [-l linkname] [-r receiver] [-s source_node ] [-p port ] [-w password] [-W] [-L] [-n 0|1] [-d 0|1] [-h 0|1] [-t throttlems] ([-j jobid] || ( [-m minjobid] [-M MaxJobid ])) [ ACTION ]

edjob [-l linkname] [-r receiver] [-s source_node ] [-p port ] [-w password] [-C -m minrowid -M Maxrowid ])

edjob [-l linkname] [-r receiver] [-s source_node ] [-p port ] [-w password] [-F -m minrowid -M Maxrowid ])

edjob [-l linkname] [-r receiver] [-s source_node ] [-p port ] [-w password] [-C -N filename_to_cancel])

edjob [-l linkname] [-r receiver] [-s source_node ] [-p port ] [-w password] [-F -N filename_to_redo])

ACTION IS ONE OF:

[-a] To get a listing of pending file transfer jobs(active jobs).

[-c] To cancel a job with the job id given by -j jobid or a range of jobs given by -m min and -M max

[-C] To cancel files in the journal with the rowid between -m minrowid and -M maxrowid

[-F] To redo files in journal with the rowid between -m minrowid and -M maxrowid

[-N] Filename to cancel or redo

[-i] To get information about a file replication job. This is the default.

[-f value] To reset failure values for one or more jobs.

[-t value] Throttle data stream to remote receiver. Value is in milliseconds.

[-T value] To reset the priority of one or more jobs. Priority numbers range from 0 (default) to 10.

[-P] To pause one or more jobs.

[-R] To resume one or more jobs.

[-z failurelimit] To delete files from the replication journal if the number of failures has reached the failurelimit value or above.

If no action is given we default to listing all file replication jobs history.

OPTIONAL HEADERS OUTPUT:

[-W] To turn off the output of all header info. Simply lists job row info.

[-L] To sort jobs from low to high rather than high to low(default).

[-n 0] To turn off the output of min/max job ids

[-n 1] To turn on the output of min/max job ids

[-d 0] To turn off the output of the title with the date in it

[-d 1] To turn on the output of the title with the date in it

[-h 0] To turn off the adorning of the header output

[-h 1] To turn on the adorning of the header output

DESCRIPTION

edjob is the command line interface for viewing replication job history and managing jobs.

edjob allows you to obtain the status of the file transfers to various remote sites.

OPTIONS

No options specified

Will dump the information about all file transfer and replication jobs in the datatabase.

-i

Will dump information about pending and past replication jobs.

-T priority

This is sets the priority of data transfer. This is a number. The higher the priority value is the more precedence is given for the job.

-z failurelimit

This is a high watermark for the number of times a file transfer is allowed to fail to reach a remote node. Under normal circumstances all files are kept in the journal until they are synchronized to the remote node. Administrators can delete the files from the journal to prevent the system from retrying to send them using the -z command. Any file with a number of failures equal to or exceeding failurelimit will be removed from the file transfer journal.

-f failurelevel

This is sets the failurelevel of data transfer. The higher the failure level, the lower is the precedence. In rare circumstances users need to alter the failurelevel or priority level. It is better to let the system manage the failure level. But users may want to alter priority levels depending on their work flow or on the urgency of data transmissions.

-c

This cancels the file replication job specified by jobid or the entire range specified by [minjobid, maxjobid].

-w password

This is the password for the replication source node or the Graphical User Interface. This will be verified against what is in $ED_BASE_DIR/etc/edpasswd on the replication source node.

The format of the password file is "hostnamepattern:password". The password file is a text file and the password is in clear text. Therefore the password file must be read only by the owner or system administrator.

If no password is specified and the edpasswd file is not found, the wild card "*" will be used as a password.

-s source_node

This is the source node that distributes the content. The default is the localhost. The source node is also referred to as the manager node.

-l linkname

This is the name of the file replication link we are controlling. If no "-l" options is specified, the default is "every" file transfer link in the configuration. You can use regular expressions for this parameter.

-r receiver

receiver is the hostname or IP of the remote receiver. This is identified by the hname="hostname" or hostname="nodename" in the receiver section of the configuration.

if no "-r" is specified, the default is all receivers in the configuration. You can use regular expressions for this parameter.

The parameter specified by -r must match what you have in the hname="parameter" or hostname="parameter" entry of your receiver entry in the configuration file eddist.cfg.

[-p port]

This is the port on which the manager node (source node) is listening for control commands.

[-Z]

Use ssl certificates

FILE REPLICATION AND TRANSFER JOB MANAGEMENT EXAMPLES

edjob

This will dump the state of the content distribution for all links and all receivers in a link.

edjob -l link1

This will the history of for jobs for all receivers in link1.

edjob -c -m 1 -M 16

This will cancel all jobs in the range 1 to 16 for all links and receivers

edjob -T 16 -m 12

This will set the priority of job 12 to 16.

edjob -z 5

This will remove any file (from the journal) if our attempt to send it to the remote note has failed 5 times or more.

FILES

$ED_BASE_DIR/etc/eddist.cfg

$ED_BASE_DIR/etc/edpasswd

SEE ALSO

edintro(8)

edresume(8)

edpause(8)

edstat(8)

edq(8)

eddist.cfg(5)

RETURN VALUE

The status is 0 on success.

ENVIRONMENT

ED_BASE_DIR: This is the name of the top directory where the content distribution software is installed. This directory will also contain various configuration, journals and log files.

ED_COLLECTOR_PORT: This environment variable is set to the port on which EnduraData eddist server listens to management commands. Set this environment variable to the port on which to listen for commands.

ED_DISTRIBUTION_PORT: This environment variable is set to the port on which EnduraData eddist server listens to data distribution services. Set this environment variable to the port on which to listen for data distribution connections.

SUPPORT

For more information about how to configure or manage your file replication and transfer contact <support@enduradata.com>

AUTHOR

A. A. El Haddi, elhaddi@ieee.org
S. Dimitri, sdimitri@enduradata.com
A. Taouil ataouil@enduradata.com