EDpCloud™: Synchronization Job Management Tool.
Show statistics/Status of EnduraData Content Replication
Check for Updates of your file sync and replication software from www.enduradata.com
edjob
- NAME
- SYNOPSIS
- DESCRIPTION
- OPTIONS
- FILE REPLICATION AND TRANSFER JOB MANAGEMENT EXAMPLES
- FILES
- SEE ALSO
- RETURN VALUE
- ENVIRONMENT
- SUPPORT
- AUTHOR
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