filesync

Last Updated : May 20, 2019 |

Syntax

filesync  [-w] [-s | -f | -t | -i | -d | -e | -v] [-Q <TYPE> [NUM]] [-r <TYPE>] [-a <TYPE> <ipaddr>] [-q | -H <TYPE>] [ filegroup ]

Description

Use filesync to request synchronization of files from active to standby server(s). You can:

  • Specify all files or sets of files.

  • Define the type of synchronization.

  • Enable, disable, or temporarily inhibit file synchronization.

  • Report synchronization status and history.

File synchronization sends translations to a duplicate server, a standby server, or a survivable remote server. File synchronization may take place because of survivable remote server registration or with the following commands:

  • filesync trans (sends translations to the standby server or the survivable remote servers)

  • loaddisplang (sends unicode files to the standby server and the survivable remote servers)

  • loadlicense (sends the license file to the standby server).

  • loadpwd (in this instance, sends the password files to the standby server and the survivable remote servers).

  • save_trans (sends translations to the standby server).

  • save_trans lsp (sends translations to the standby server and the survivable remote servers).

  • server -i (sends all synchronized files to the standby server before the interchange).

filesync command options

Option

Option description

-w filegroup

Wait for results. Specify filegroup, or all for all groups.

-s filegroup

Run the file synchronization silently. The exit status is the only indication of success or failure. Specify filegroup, or all for all groups.

-t filegroup

Timestamp-based synchronization for the specified filegroup to the duplicate server. Verify the timestamps on all files in the specified sets, and synchronize the file/remote server when:

  • the file's timestamp is more recent than the last synchronization.

  • the last synchronization attempt for the set failed.

-t is more efficient on the active server. It ensures that if the file is changed locally, it will be synchronized to the other server(s). filesync -t will not correct a corrupted file on the other server. Specify filegroup, or all for all groups.

-i
Inhibit file synchronization temporarily. This command will not exit if given this option, so it should be run in the background as follows: 
filesync -i&
fs=$!
***other processing ***
kill-HUP $fs

-d

Disable file synchronization. No files will be synchronized to or from this server until an enable is given. The disable state persists across Communication Manager restarts and Linux reloads.

-e

Enable or re-enable file synchronization.

-v

Turn on verbose mode. Use with -Q queries.

-q filegroup

Query the status and receive a summary of the most recent synchronization, and synchronize the requested filegroup. Implies -w, wait for a response before returning. Specify filegroup, or all for all groups.

-a <TYPE> <ipaddr> filegroup

Send files to a server of <TYPE> ESS or LSP at the specified IP address. Specify filegroup, or all for all groups.

-Q <TYPE> [NUM]

Query the status of the translation synchronization number [NUM] to the specified servers of type <TYPE>. Display the status for save trans, filesync trans, or nightly maintenance. The default synchronization number is the most recent synchronization. Server <TYPE> may be dup, ess, lsp, or all.

-H <TYPE>

Show the history of the last 25 translation synchronizations to specified server types. Displays the history for save trans, filesync trans, or nightly maintenance. Server <TYPE> may be dup, ess, lsp, or all.

-r <TYPE>

Send files to the duplicate server and remote servers of a specified type. Server <TYPE> may be dup, ess, lsp, or all.

filesync exit codes

If an error occurs, an explanation of the error is sent to stdout. If the command is successfully sent and any response is received, a description of the status is displayed.

Exit Code

Explanation

0

Successful

2

Synchronization is in progress.

3

Synchronization is currently inhibited or disabled.

4

Pre-script execution returned non-zero status.

5

Post-script execution returned non-zero status.

6

Request was invalid (such as an invalid set name).

7

File error in file set.

8

Duplex server is out of service.

9

An error occurred during file synchronization.

10

A local error occurred.