Purpose

Starts, stops, or displays information about the Oracle ACFS replication background processes.

Syntax and Description

acfsutil repl bg -h
acfsutil repl bg {start | stop | info} mount_point

acfsutil repl bg -h displays help text and exits.

Table 16-30 contains the options available with the acfsutil repl bg command.

Oracle ACFS replication uses a background process on the primary cluster to transport file system changes to the standby file system. This process must be running for replication to function. When replication is started with the acfsutil repl init command, the process is started and registered with Oracle Clusterware, enabling an automatic restart after a reboot or system crash. This process is clusterwide.

To determine if the Oracle ACFS replication background process is running at the primary site, you can run the acfsutil repl bg info command on the primary cluster. For examples of the use of the command, refer to Example 16-26.

You must have system administrator privileges to run the acfsutil repl bg start or acfsutil repl bg stop commands. You must have system administrator or Oracle ASM administrator privileges to run the acfsutil repl bg info command.

Examples

Example 16-26 shows the use of the acfsutil repl bg command.

Purpose

Verifies that files have been replicated on an Oracle ACFS file system.

Syntax and Description

acfsutil repl compare -h 
acfsutil repl compare [-v] [ -a [-s] | -t { all | tagname, ...} [-s] ]           
primary_mount_point standby_mount_point

acfsutil repl compare -h displays help text and exits.

Table 16-31 contains the options available with the acfsutil repl compare command.

The acfsutil repl compare command verifies all or part of the primary mount point has been replicated to the standby mount point. The standby mount point must be mounted locally for comparison. Best results are obtained when the primary file system is changing as little as possible. The command always checks all files on the primary file system against those on the standby file system.

The -a option is typically used when no tag names were specified during the acfsutil repl init operation. The -a option compares all files on the primary file system against those on the standby file system. The -a option also enables tests for extra files on the standby file system that do not exist on the primary. When testing for extra files, the command also attempts to check extended attributes. However, if NFS is used to mount the standby file system locally, the standby cannot be checked for matching extended attributes due to limitations in the NFS protocol.

The -t option is used when tags were specified during the acfsutil repl init operation. The -t operation locates all file names on the primary file system with the specified tag names and compares them to the corresponding files on the standby. The -t option takes as arguments either all option or a comma-delimited list of tag names. If the -t option is used with the all argument, then all tag names supplied during the acfsutil repl init operation are selected. Otherwise, any specified tag names must exactly match a tag name supplied during the acfsutil repl init operation. The -t option also tests for extra files on the standby file system that do not have an associated tag name that was specified during the acfsutil repl init operation. If NFS is used to mount the standby file system locally, the standby cannot be checked for matching tag names and extended attributes due to limitations in the NFS protocol.

You can use the acfsutil repl info -c option to determine which tags were specified during the acfsutil repl init operation.

The -a and -t options cannot both be specified at that same time. When -a or -t is provided, the —s option can also be specified to skip extended attribute comparisons for symlinks. If neither the -a nor -t option is provided, a primary to standby file comparison is done without testing tag names nor extended attributes.

The -v option may be specified to output the name of each file after the file is compared.

You must have system administrator or Oracle ASM administrator privileges to run this command.

Examples

Example 16-27 shows the use of the acfsutil repl compare command.

Purpose

Displays information about replication processing on an Oracle ACFS file system.

Syntax and Description

acfsutil repl info -h 

acfsutil repl info -c [-v] mount_point                    

acfsutil repl info -c -u user [-o sshStrictKey=ynvalue] standby_host [standby_host]...]
                    primary_mount_point

acfsutil repl info -s [-v][-l] [-n number{m|h|d|w|y}] 
                   {-f eventlog | mount_point}

acfsutil repl info [-a|-e|-t] [-v][-l]
                   {-f eventlog | mount_point }

acfsutil repl info -h displays help text and exits.

Table 16-32 contains the options available with the acfsutil repl info command.

To display information about replication configuration, use acfsutil repl info with the -c option. The configuration information includes a Applied primary as of timestamp that identifies the point in time on the primary file system that the standby file system represents. You can use this timestamp to set back a database to this point in time if it is necessary to keep the data in Oracle ACFS file system synchronized with the database data replicated with Oracle Data Guard.

When specifying the —u option, the command should be run as root (or local SYSTEM) on each host of the primary cluster to confirm that ssh, as used by snapshot-based replication, can connect to all standby hosts and log in as user on each host. The user specified should be the same as the repluser specified in the acsfutil repl init command. Each standby_host string specifies a hostname or host IP address for a standby node. The specified primary_mount_point should be the active Oracle ACFS mount point in the primary cluster that is to be used for replication. If strict host-key checking was or is to be disabled for this use of acsfutil repl init primary using -o sshStrictKey=no, then the option should be specified here also to skip host-key validation. acfsutil repl info -c -u can be run at any time, whether or not replication is currently active on the primary_mount_point.

To display information about replication statistics, use acfsutil repl info with the -s option.

To display information about all replication events, use acfsutil repl info with no options. To display information about a specific kind of event, use acfsutil repl info with the -a, -e, or -t option.

You must have system administrator or Oracle ASM administrator privileges to run this command.

Examples

Example 16-28 shows the use of the acfsutil repl info command.

Purpose

Initiates replication on all the files in an Oracle ACFS file system or only those files with a specified list of tags.

Syntax and Description

acfsutil repl init -h

acfsutil repl init standby -u repluser [-d trace_level] standby_mount_point

acfsutil repl init primary -s repluser@netname { -C | -i interval} [tagname...]
                           [-m standby_mount_point] [-d trace_level] [-z {on | off}] 
                           [-o sshCmdPath=pathname] [-o sshStrictKey=ynvalue] 
                           [-o sshCipher=ciphername]
                           primary_mount_point

acfsutil repl init -h displays help text and exits.

Table 16-33 contains the options available with the acfsutil repl init command.

The acfsutil repl init primary and standby commands initiate replication between a specified primary site and a specified standby site. The acfsutil repl init standby command must be run first. Before running the command, ensure that the file system specified is mounted on only one node of the standby cluster. When the command completes successfully, mount the specified file system on all nodes of the standby cluster. Next, run the acfsutil repl init primary command.

When the acfsutil repl init primary command completes successfully, processing begins to replicate initial copies of all specified files to the standby file system. In addition, any changes to these files and any new files subsequently created in the file system on the primary file system are captured and transported to the standby file system. However, successful completion of the command does not indicate that the specified files have been copied in full to the standby file system. To monitor the progress of the initial replication of all specified files to the standby file system, users can run the acfsutil repl info -c command.

The initial replication operation is based on a snapshot of the primary file system, which is transferred to the standby file system in its entirety. Each subsequent replication operation uses a later snapshot of the primary, and only the differences between that snapshot and the last previous snapshot are transferred to the standby.

All directories in the primary file system are always replicated to the standby, even if tags are specified.

Symbolic link files are replicated as is. If the symbolic link resolves to an absolute path name, and that path name does not exist on the standby file system, then referencing the symbolic link results in errors.

On platforms that support named sockets, character device files or block device files, these file types are not replicated.

A file system being replicated can be mounted on only one path for the primary or standby file system.

A replicated Oracle ACFS file system must be mounted on the same directory within a cluster. The file system does not have to be mounted on all of the nodes in a cluster, but if it is mounted, it must be mounted on the directory specified with the acfsutil repl init command. In addition, no other file system can be mounted on that directory on other nodes.

A single Oracle ACFS file system cannot be configured both as a primary and a standby file system. If replication is configured on the same host or within the same cluster, then the primary and standby file systems cannot use the same named mount point.

If either site hosting the primary or standby file system is running on Windows, then both sites must be running on Windows. Replication is allowed between sites running any combination of the Linux, Solaris or AIX operating systems.

You must have system administrator privileges to run this command.

Examples

Example 16-29 shows the use of the acfsutil repl init to initiate snapshot-based replication from the primary to standby site.

Purpose

Pauses replication on an Oracle ACFS file system.

Syntax and Description

acfsutil repl pause -h
acfsutil repl pause mount_point

acfsutil repl pause -h displays help text and exits.

Table 16-34 contains the options available with the acfsutil repl pause command.

The acfsutil repl pause command is issued at the primary replication site only. To continue replication operations, acfsutil repl resume should be run at a later time on the same primary site.

acfsutil repl pause stops the operation of the replication daemon temporarily. Subsequent running of acfsutil repl resume resumes the operation of the daemon.

If acfsutil repl pause is run while a replication operation is active, then the active replication operation completes regardless of the pause action. The pause operation is not effective in this case, and the command does not return, until the current data stream has been applied on the standby. After that, operations are not performed for this replication until the acfsutil repl resume is issued.

You must have system administrator or Oracle ASM administrator privileges to run this command.

Examples

Example 16-30 shows the use of the acfsutil repl pause command.

Purpose

Resumes replication on an Oracle ACFS file system where replication has been paused.

Syntax and Description

acfsutil repl resume -h
acfsutil repl resume mount_point

acfsutil repl resume -h displays help text and exits.

Table 16-35 contains the options available with the acfsutil repl resume command.

The acfsutil repl resume command resumes the replication process after the acfsutil repl pause command has been run. This command should be run on the same primary site soon after replication has been paused with the acfsutil repl pause command.

You must have system administrator or Oracle ASM administrator privileges to run this command.

Examples

Example 16-31 shows the use of the acfsutil repl resume command.

Purpose

Synchronizes primary and standby file systems.

Syntax and Description

acfsutil repl sync -h
acfsutil repl sync [apply] primary_mount_point

acfsutil repl sync -h displays help text and exits.

Table 16-36 contains the options available with the acfsutil repl sync command.

The acfsutil repl sync command can be used to synchronize the state of the primary site and the standby site. This command can only be run on the primary site. Users should first quiesce their applications and issue a sync(1) call to ensure that the synchronized state is known and meaningful to the user. Running acfsutil repl sync then ensures all outstanding replication data is shipped from the primary site to the standby site. Specifically, the command enables any in-progress replication operation to complete, and then performs replication one final time to ensure that all changes on the primary have been replicated.

The command returns success when all of the changes have been successfully applied to the file system on the standby site. At this point, unless an unmount of the last node on the primary site cluster is about to occur, applications may be restarted.

Successfully unmounting a replicated file system on the primary site does not guarantee that all file system changes made prior to the unmount have been successfully sent to the standby site or applied to the standby file system. If the primary file system is unmounted on one primary site node but remains mounted on one or more primary site nodes, changes to the file system made before the unmount continue to be transported to the standby site from the other nodes after the unmount. However, if you are in the process of unmounting the primary file system on the last primary site node where it is mounted, and if you want to know that all file system changes on the primary file system up to that point have been successfully applied to the standby file system, then you should perform the following operations to ensure that the standby file system is up to date.

• Quiesce applications on the primary site which modify the file system.

• Run acfsutil repl sync.

Next, run acfsutil repl bg stop to stop the replication background process, which always must be run before unmounting a replicated file system. After the background process has been stopped, then unmount the file system.

You must have system administrator or Oracle ASM administrator privileges to run this command.

Examples

Example 16-32 shows the use of the acfsutil repl sync command.

Purpose

Stops all replication activity on the Oracle ACFS file system at the site where it is run.

Syntax and Description

acfsutil repl terminate -h
acfsutil repl terminate primary [-d trace_level] mount_point
acfsutil repl terminate standby [immediate] [-k] [-d trace_level] mount_point

acfsutil repl terminate -h displays help text and exits.

Table 16-37 contains the options available with the acfsutil repl terminate command.

The acfsutil repl terminate command stops all replication processing. When terminating replication, you should terminate replication for the primary file system first, and then the standby file system. If you want to ensure all changes are sent to the standby file system before terminating the primary site, ensure that all applications are quiesced and run the acfsutil repl sync command. The terminate command must be run on both sites if both sites hosting the file systems are available.

After acfsutil repl terminate standby has been run, you can use the standby file system in read-write mode. If you want to restart replication after running acfsutil repl terminate, then you must restart replication from the beginning with the acfsutil repl init command.

The repl terminate standby command waits until replication data at the standby file system has been applied. If you want to terminate replication immediately without applying all the replication data, use the immediate option. However, this option can leave some files at the standby file system in an indeterminate state.

To momentarily stop Oracle ACFS replication, you can use the acfsutil repl pause command, followed soon after by the acfsutil repl resume command.

You must have system administrator privileges to run this command.

Examples

Example 16-33 shows the use of the acfsutil repl terminate command.

Purpose

Sets the replication trace level for gathering trace information on an Oracle ACFS file system.

Syntax and Description

acfsutil repl trace -h
acfsutil repl trace level mount_point

acfsutil repl trace -h displays help text and exits.

Table 16-39 contains the options available with the acfsutil repl trace command.

Increasing the trace level can have a performance impact and should be done at the recommendation of Oracle support services.

Trace files for Oracle ACFS replication are stored in the following location:

GRID_HOME/diag/crs/hostname/crs/trace

You must have system administrator or Oracle ASM administrator privileges to run this command.

Examples

Example 16-34 shows the use of the acfsutil repl trace command.

Purpose

Updates replication information after replication has started and is running on an Oracle ACFS file system.

Syntax and Description

acfsutil repl update -h

acfsutil repl update  [-s repluser@netname] [-C | -i interval] 
                      [-d trace_level] [-z {on | off}] 
                      [-o sshCmdPath=pathname] [-o sshStrictKey=ynvalue] [-o sshCipher=ciphername]
                      primary_mount_point

acfsutil repl update [-u repluser] [-d trace_level] standby_mount_point

acfsutil repl update -h displays help text and exits.

Table 16-39 contains the options available with the acfsutil repl update command.

The acfsutil repl update command updates replication information and configuration after replication has been started. For example, a system administrator can change the network interface that is currently being used by replication to connect to the remote site. Issuing the acfsutil repl update command to update the configuration in this situation enables replication to continue running uninterrupted.

If acfsutil repl update is run on the primary site, the command can be used to alter the use rname and network interface name (hostname or VIP name) that is used to connect to the standby site. The command can also be used to change the replication interval or tracing level, change the cipher used by or the pathname used for ssh, and turn compression on or off.

If acfsutil repl update is run on the standby site, the command can be used to alter either the tracing level or the user name used by the primary site to connect to the standby site.

At least one of the options must be specified when issuing this command; the command cannot be run with only the required mount point.

The acfsutil repl update command returns success when the updated information has been accepted on the local site. To change the user name, the command must be run on both the primary and the standby sites. If the replication interval is changed with the -C or -i option, a replication operation occurs at the point when acfsutil repl update is run. The next replication operation occurs based on the newly-specified interval.

You must have system administrator privileges to run this command.

Examples

Example 16-35 shows the use of the acfsutil repl update command.