Pause/Suspend EnduraData Data Replication.


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

edpause



NAME

edpause - Pause/Suspend File Synchronization, Replication and File Transfer Software

SYNOPSIS

edpause [ -F ] [-l linkname] [-L *|linkname] [-r receiver] [-s source_node ] [-p port ] [-w password]

DESCRIPTION

edpause is the command line interface for suspending or pausing file synchronization, content distribution and data replication.

edpause allows you to temporarily suspend file synchronization and file distribution. If you are running realtime file replication module, the file changes will continue to be journaled and will be replicated when you resume file replication. You will need to invoke edresume to resume replication and distribution of data(at a later time) to the remote site.

You can continue adding content to the queue while a node is in pause mode. The added content will be journaled but will not be distributed while replication is paused.

edpause is used in conjunction with edresume in a schedule to control when data is delivered, backed up or to reduce bandwidth utilization during certain peak demand times of the day.

OPTIONS

-F

This option alone will pause the file system change monitor from queuing data changes for replication. Run this before restarting the data synchronization manager. This type of pause will be brief and should only last a few minutes to allow you to restart eddist safely without losing any changes. When the file system monitor is paused, it continues to monitor the file system for changes but it does does not relay them to the replication manager for journaling. They are kept in memory (Hence the need to resume after a few minutes before you run out of resources). To resume run edresume -F.

-w password

This is the password for the source node or the Graphical User Interface. This will be verified against what is in $ED_BASE_DIR/etc/edpasswd on the 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. Content distribution will be paused from the specified source node for the specified link and receiver.

-L linkname or -L *

Pause the link given in linkname or all the links on this receiver (*) where edpause is executed. This takes the replication receiver offline. The receiver continues to run but it will not accept any connections from edpcloud until edresume is run. A paused receiver will not accept any connections from the sender until edresume -L * | edresume -L linkname is executed on the receiver. This is useful if you want to isolate this receiver from receiving data updates. Use this command in a schedule to shield this receiver from receiving remote data updates between intervals of times. Note that '*' must be in single or double quotes.

-l linkname

This is the name of the link we are controlling.

The receiver or destination host and directories are identified by a linkname and a hostname. Link names are unique across a configuration. The wild card ".*" indicates that the command will be applied to all links. You can also use regular expressions. For instance, you can use -l "casa.*" to match all links that start with the word casa. If no link is specified, the default is to pause replication for the specified receivers for all links (.*) in a configuration.

-r receiver

receiver is the hostname or IP of the remote receiver. This is identified by the hname="nodename" or hostname="nodename" in the receiver section of the configuration. The wild card ".*" indicates that the command will be applied to all receivers which is the default. You can also use regular expressions for the receiver name. For example, you can use -r *.noaa.gov to match all receivers on the noaa network or 192.168.* to match nodes with IP's in the range 192.168.0.1 to 192.168.254.254

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

EXAMPLES

edpause

This will pause content distribution to all links and all receivers. If a password file exists we will use the password from it, otherwise we will assume that this is not password protected.

edpause -l tokyo -r backups.enduradata.com -w secretword

This causes the local host to pause content distribution for link tokyo to receiver backups.enduradata.com. The password used is secretword.

edpause -l link1 -r bridge2 -s www.enduradata.com -w mypassword

This will pause data replication and data distribution from www.enduradata.com to link1 and receiver bridge2, using password mypassword.

edpause -r *.nasa.gov -s nasa1.nws.gov

This will pause content distribution from nasa1.nws.gov to all links and registered receivers in the nasa.gov domain.

Example of a crontab entry for Linux/Mac/Unix users

This entry in crontab shows how replication for link casablanca and receiver paris.enduradata.com will be paused at 16:30 and resumed at 21:00 every day of the year. Windows users can also use the at command or the job scheduler console for this.

30 16 * * * edpause -l casablanca -r paris.enduradata.com
0 21 * * * edresume -l casablanca -r paris.enduradata.com

FILES

$ED_BASE_DIR/etc/eddist.cfg

$ED_BASE_DIR/etc/edpasswd

SEE ALSO

edintro(8)

edresume(8)

edq(8)

edjob(8)

edstat(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 contact <support@enduradata.com>

AUTHOR

A. A. El Haddi, elhaddi@ieee.org