Saturday, 11 October 2014

7MTT 1.4 RC1 CLI Commands Reference

An update of this post: 7MTT 1.2 CLI Commands Reference. New additions on the 7MTT 1.2 CLI are in highlighted.

7MTT 1.4 RC1 CLI Commands Reference

7-Mode Transition Tool>?

NAME
transition -- Transition 7-Mode volumes and configuration to clustered Data ONTAP by using the 7-Mode Transition Tool.

COMMANDS
transition abort - Aborts the transition session.
transition add-cluster-info - Add the cluster information to the given session.
transition add-primary-seven-mode-system - Add information about a 7-Mode primary system to a transition session.
transition add-secondary-cluster-mode-system - Add information about a clustered Data ONTAP secondary system to the session.
transition create - Create a transition session.
transition cutover - Completes the transition to clustered Data ONTAP storage system.
transition delete - Deletes a transition session.
transition job-results - View the results of a job.
transition job-status - See the status of a job.
transition jobs - This command displays the list of jobs ran or running on the given session and operation.
transition modify - Modify a transition session.
transition pause - Pause data transfers from 7-Mode to clustered Data ONTAP volumes.
transition precheck - Verify compatibility of the 7-Mode and clustered Data ONTAP systems for transition.
transition precutover - Applies the configurations to clustered Data ONTAP storage system.
transition property-get - Gets the value of a specific session property.
transition property-reset - Clears the value of a specific session property.
transition property-set - Sets value for a specific session property.
transition remove-primary-seven-mode-system - Remove a 7-Mode primary system from the session.
transition remove-secondary-cluster-mode-system - Remove a clustered Data ONTAP secondary system that has been added the session.
transition resume - Resume data transfers from the 7-Mode to clustered Data ONTAP volumes.
transition resync - The transition resync command triggers the SnapMirror resync operation between the session 7-Mode and clustered Data ONTAP volumes.
transition show - Display the list of transition sessions or display information about a given session.
transition show-primary-seven-mode-systems - Display the list of 7-Mode primary systems added to the session.
transition show-secondary-cluster-mode-systems - Display the list of clustered Data ONTAP secondary systems added to the session.
transition start - Start data copy from 7-Mode volumes to clustered Data ONTAP volumes.
transition update - Triggers the SnapMirror update operation for the clustered Data ONTAP volumes.
transition version - Display the version of 7-Mode Transition Tool.

CATEGORIES
transition credentials - Transition credentials management commands.
transition lif - LIF management commands.
transition schedule - Transition schedule commands
transition volumepair - Transition volume pair commands.

DESCRIPTION
The 7-Mode Transition Tool enables transitioning 7-Mode volumes and configurations to a new clustered Data ONTAP system. The tool provides a CLI-based wizard and commands to perform the transition.

Valid options for all commands are:
[-r] no  - Disable interactive nature of this command.

COMMANDS

7-Mode Transition Tool>transition abort ?

NAME
abort -- Aborts the transition session.

SYNOPSIS
transition abort -s {session-name} [ -r {interactive} ]

DESCRIPTION
This command stops all data transfers from the 7-Mode to the Cluster-Mode volumes, and deletes the SnapMirror relationships. Session must be in 'copy-baseline', 'copy-pause' or 'copy-update' to run this command.

Valid options are:
-s {session-name}  - Session name

7-Mode Transition Tool>transition add-cluster-info ?

NAME
add-cluster-info -- Add the cluster information to the given session.

SYNOPSIS
transition add-cluster-info -s {session-name} -h {host-name} -v {vserver-name} [ -g {aggregate} ]

DESCRIPTION
Add the cluster information to the given session.

Valid options are:-
-s {session-name} - Name of a session
-h {host-name}    - FQDN or IP address of the cluster-management LIF of the cluster
-v {vserver-name} - Vserver on the Cluster-Mode system
-g {aggregate}    - Aggregate name on which Vserver's root volume is created

7-Mode Transition Tool>transition add-primary-seven-mode-system ?

NAME
add-primary-seven-mode-system -- Add information about a 7-Mode primary system to a transition session.

SYNOPSIS
transition add-primary-seven-mode-system -s {session-name} -h {source-host} -f {management-ipaddress} -d {data-copy-ipaddress} [ -m {multipathing-ipaddress} ]

DESCRIPTION
Add information about a 7-Mode primary system to the session. This information is used by the tool to establish data-protection relationship with the 7-Mode primary volumes. This command is applicable only for 'secondary' type sessions. When transitioning a fan-in relationship, you can add information of more than one 7-Mode primary system.

Valid options are:-
-s {session-name}           - Name of a session
-h {source-host}            - FQDN or IP address of the source of data-protection relationship
-f {management-ipaddress}   - Management IP address of the source host
-d {data-copy-ipaddress}    - IP address over which data is copied
-m {multipathing-ipaddress} - Additional IP address that is used for data copy

7-Mode Transition Tool>transition add-secondary-cluster-mode-system ?

NAME
add-secondary-cluster-mode-system -- Add information about a Clustered Data ONTAP secondary system to the session.

SYNOPSIS
transition add-secondary-cluster-mode-system -s {session-name} -h {c-mode-host-name} -v {svm-name}

DESCRIPTION
Add information about a Clustered Data ONTAP secondary system to the session. This information is used by the tool to establish data-protection relationship with the Cluster-Mode secondary volumes. This command is applicable only for 'primary' type sessions. When transitioning a fan-out relationship, you can add information about more than one Cluster-Mode system.

Valid options are:-
-s {session-name}     - Name of the session
-h {c-mode-host-name} - FQDN or IP address of the Cluster-Mode system.
-v {svm-name}         - Name of the SVM hosting the secondary volumes.

7-Mode Transition Tool>transition create ?

NAME
create -- Create a transition session.

SYNOPSIS
transition create -s {session-name} -t {session-type} -n {7-mode-host-name} -c {data-copy-ipaddress} [ -f {vfiler} ]
[ -m {multipathing-ipaddress} ] [ -h {c-mode-host-name} ]
[ -v {c-mode-vserver-name} ] [ -g {vserver-rootvol-aggr} ]
                                     
DESCRIPTION
Create a session that is a unit of transition. It describes the 7-Mode objects and how they map to Cluster-Mode after transition.

Valid options are:-
-s {session-name}           - Name of the session
-t {session-type}           - Specifies whether the transitioning volume is the primary or secondary in a data protection relationship this session will transition. Valid values are: primary, secondary and standalone
-n {7-mode-host-name}       - FQDN or IP address of management interface of 7-Mode system
-c {data-copy-ipaddress}    - IP address over which data is copied
-f {vfiler}                 - Specifies the vFiler unit from which the volumes must be transitioned, if MultiStore is licensed on the 7-Mode system. The default value of this parameter is vfiler0.
-m {multipathing-ipaddress} - Additional IP address that will be used for data copy
-h {c-mode-host-name}       - FQDN or IP address of the cluster-management LIF of the cluster
-v {c-mode-vserver-name}    - Vserver on the Cluster-Mode system
-g {vserver-rootvol-aggr}   - Aggregate name on which Vserver's root volume is created

To ensure that the transition session is created successfully, you must add credentials of the 7-Mode and Cluster-Mode systems by using the 'credentials add' command.

7-Mode Transition Tool>transition cutover ?

NAME
cutover -- Completes the transition to clustered Data ONTAP storage system.

SYNOPSIS
transition cutover -s {session-name} [ -t {available-transfers-percentage} ]
[ -c {max-cap-concurrent-transfers} ]
[ -x {snapmirror-throttle} ] [ -r {interactive} ]

DESCRIPTION
The transition cutover command completes the transition process.
This process involves:-
* Precheck to maximize success of this operation.
* Final data copy from 7-Mode to clustered Data ONTAP volumes.
* Transitioning clustered Data ONTAP volumes.
* Taking 7-Mode volumes offline and unconfiguring the 7-Mode IP addresses selected for transition.
* Bring up the transitioned 7-Mode data LIFs on the SVM.
* Establish appropriate data Protection relationships for sessions of type primary and secondary

Valid options are:-

-s {session-name} - Name of the session

-t {available-transfers-percentage} - Percentage of the available volume SnapMirror transfers that should be used for data copy. The available volume SnapMirror transfers is calculated at run time.

-c {max-cap-concurrent-transfers} - Maximum number of concurrent volume SnapMirror transfers that can run during this operation. Value -1 indicates use of all available concurrent volume SnapMirror transfers. If no value is provided, the default -1 is used.
Example: 20 - At any point in time, a maximum of 20 concurrent SnapMirror transfers will be done.

-x {snapmirror-throttle} - Maximum throttle limit (in MBps) for this operation that will be shared by the active SnapMirror transfers in this operation. If no value is specified, the default value 'unlimited' will be used for the SnapMirror transfers. The values -1 and 0 represent unlimited throttle. The maximum value allowed is
4194303. For example, if the throttle limit is specified as 100 and the concurrent SnapMirror replication transfers count is 10, each SnapMirror transfer uses a bandwidth of 10 MBps.
                                                                
If both max-cap-concurrent-transfers and available-transfers-percentage options are provided, the lowest value is used as the number of concurrent volume SnapMirror transfers that should be used for data copy.

The following example illustrates how the number of concurrent SnapMirror transfers are derived if the available-transfers-percentage option is set to 50% and the max-cap-concurrent-transfers option is set to 25. Consider that the platform supports a maximum of 100 concurrent volume SnapMirror transfers and only 60 are currently  available. The maximum number of concurrent transfers based on the value of the available-transfers-percentage option is 30 (50% of 60). In this case, the maximum number of concurrent volume SnapMirror transfers used is 25 because the max-cap-concurrent-transfers option is set to 25, which is the lowest of the two values.

You ensure that all the necessary manual steps are performed prior to invoking this command. After successfully completing this operation, carefully review the messages for any manual steps that might be required to be performed before enabling client access to the transitioned volumes.

7-Mode Transition Tool>transition delete ?

NAME
delete -- Deletes a transition session.

SYNOPSIS
transition delete -s {session-name}

DESCRIPTION
This command deletes the specified transition session.

Valid options are:-

-s {session-name} - Name of a session

7-Mode Transition Tool>transition job-results ?

NAME
job-results -- View the results of a job.

SYNOPSIS
transition job-results -j {job-id} [ -r {interactive} ]

DESCRIPTION
This command is used to retrieve results of a given job.

Valid options are:-
-j {job-id}  - Specifies the job ID

7-Mode Transition Tool>transition job-status ?

NAME
job-status -- See the status of a job.

SYNOPSIS
transition job-status -j {job-id}

DESCRIPTION
This command is used to monitor the progress of a given job.

Valid options are:-
-j {job-id} - Specifies the job ID

Job status can be one of the possible values: running, completed, rejected or aborted.

7-Mode Transition Tool>transition jobs ?

NAME
jobs -- This command displays the list of jobs ran or running on the given session and operation.

Valid options are:-
-s {session-name}    - Name of the session
-o {operation-name}  - Name of the operation.

SYNOPSIS
transition jobs -s {session-name} [ -o {operation-name} ]

DESCRIPTION
Displays the jobs information

7-Mode Transition Tool>transition modify ?

NAME
modify -- Modify a transition session.

SYNOPSIS
transition modify -s {session-name} [ -c {data-copy-ipaddress} ]
[ -m {multipathing-ipaddress} ] [ -v {svm-name} ]
[ -h {c-mode-host-name} ] [ -g {svm-rootvol-aggr} ]

DESCRIPTION
This command can be used to modify composition of a transition session.

Valid options are:-
-s {session-name}           - Name of the session
-c {data-copy-ipaddress}    - IP address over which data is copied
-m {multipathing-ipaddress} - Additional IP address that will be used for data copy
-v {svm-name}               - SVM on the Clustered Data ONTAP system
-h {c-mode-host-name}       - FQDN or IP address of cluster-management LIF of the cluster
-g {svm-rootvol-aggr}       - Aggregate name on which SVM's root volume is created

7-Mode Transition Tool>transition pause ?

NAME
pause -- Pause data transfers from 7-Mode to Clustered Data ONTAP volumes.

SYNOPSIS
transition pause -s {session-name} [ -r {interactive} ]

DESCRIPTION
This command pauses data transfers from the 7-Mode volumes to the Clustered Data ONTAP volumes. Session must be in 'copy-baseline' or 'copy-update' to run this command.

Valid options are:-
-s {session-name}  - Session name

7-Mode Transition Tool>transition precheck ?

NAME
precheck -- Verify compatibility of the 7-Mode and Clustered Data ONTAP systems for transition.

SYNOPSIS
transition precheck -s {session-name} [ -p  ] [ -r {interactive} ]

DESCRIPTION
This command performs all the necessary validations to verify whether transition is possible with the objects provided in the session.

Valid options are:-
-s {session-name} - Name of the session
[-p]              - Verify 7-Mode configuration only. If this parameter is not specified, the compatibility between the 7-Mode and Clustered Data ONTAP system for transition is also verified.

The command returns a detailed report of all the validations performed on the 7-Mode and Clustered Data ONTAP systems. Each entry in the report is classified in one of the following categories:-

Error        : Feature or functionality that is not supported in Clustered Data ONTAP. For example traditional volumes.

Warning      : Feature or functionality that is not supported in Clustered Data ONTAP or some incompatible configuration between 7-Mode and Clustered Data ONTAP or feature or functionality that can be configured manually post transition.

Notification : Incompatibilities or restrictions that might cause some inconveniences post transition.

Informational: Successful validation performed as part of this operation.

7-Mode Transition Tool>transition precutover ?

NAME
precutover -- Applies the configurations to clustered Data ONTAP storage system.

SYNOPSIS
transition precutover -s {session-name} -m {mode}
[ -t {available-transfers-percentage} ]
[ -c {max-cap-concurrent-transfers} ]
[ -b {snapmirror-throttle} ]
[ -h {ad-server-host-name} ]
[ -i {ad-server-ip-address} ]
[ -u {ad-server-admin-user-name} ]
[ -p {ad-server-password} ]
[ -x {kdc-server-ip-address} ]
[ -y {kdc-server-admin-user-name} ]
[ -z {kdc-server-password} ] [ -r {interactive} ]

DESCRIPTION
The transition precutover command applies the configurations to the
clustered Data ONTAP storage system.
This process involves:-
* Precheck to maximize success of this operation.
* Final data copy from 7-Mode to clustered Data ONTAP volumes.
* Transitioning configuration from 7-Mode to clustered Data ONTAP storage system.
* Creating the 7-Mode LIFs selected for the transition on the SVM in down state.
* Creating new LIFs selected for the transition on the SVM in up state.

Valid options are:-

-s {session-name} - Name of the session

-m {mode} - Run precutover operation in one of the modes: no_test, ro_test, rw_test. In 'no_test' and 'ro_test' modes, the SnapMirror relationships are kept intact after the end of the operation whereas in 'rw_test' mode the relationships are kept in broken-off state, so that the clustered Data ONTAP volumes can be used for RW testing.

-t {available-transfers-percentage} - Percentage of the available volume SnapMirror transfers that should be used for data copy. The available volume SnapMirror transfers is calculated at run time.

-c {max-cap-concurrent-transfers} - Maximum number of concurrent volume SnapMirror transfers that can run during this operation. Value -1 indicates use of all available concurrent volume SnapMirror transfers. If no value is provided, the default -1 is used. Example: 20 - At any point in time, a maximum of 20 concurrent SnapMirror transfers will be done.

-b {snapmirror-throttle} - Maximum throttle limit (in MBps) for this operation that will be shared by the active SnapMirror transfers in this operation. If no value is specified, the default value 'unlimited' will be used for the SnapMirror transfers. The values -1 and 0 represent unlimited throttle. The maximum value allowed is 4194303. For example, if the throttle limit is specified as 100 and the concurrent SnapMirror transfers count is 10, each SnapMirror transfer uses a bandwidth of 10 MBps.

-h {ad-server-host-name} - Active Directory server FQDN

-i {ad-server-ip-address} - Active Directory server IP address

-u {ad-server-admin-user-name} - Administrative user name of Active Directory server

-p {ad-server-password} - Password of the administrative user of the Active Directory server

-x {kdc-server-ip-address} - UNIX KDC server IP address

-y {kdc-server-admin-user-name} - Administrative user name of UNIX KDC Server

-z {kdc-server-password} - Password of the UNIX KDC Server's administrative user

If both max-cap-concurrent-transfers and available-transfers-percentage options are provided, the lowest value is used as the number of concurrent volume SnapMirror transfers that should be used for data copy.

The following example illustrates how the number of concurrent SnapMirror transfers are derived if the available-transfers-percentage option is set to 50% and the max-cap-concurrent-transfers option is set to 25. Consider that the platform supports a maximum of 100 concurrent volume SnapMirror transfers and only 60 are currently  available. The maximum number of concurrent transfers based on the value of the available-transfers-percentage option is 30 (50% of 60). In this case, the maximum number of concurrent volume SnapMirror transfers used is 25 because the max-cap-concurrent-transfers option is set to 25, which is the lowest of the two values.

You must ensure that all the necessary manual steps are performed prior to invoking this command. After successfully completing this operation, carefully review the messages for any manual steps that might be required to be performed.

7-Mode Transition Tool>transition property-get ?

NAME
property-get -- Gets the value of a specific session property.

SYNOPSIS
transition property-get -s {session-name} -p {property-name}

DESCRIPTION
Gets the value of a specific session property. Currently, only one property (cluster-audit-saveas-path) is valid, which represents the path for the SVM audit logs.

Valid options for all commands are:
[-s] - Session name
[-p] - Property name

7-Mode Transition Tool>transition property-reset ?

NAME
property-reset -- Clears the value of a specific session property.

SYNOPSIS
transition property-reset -s {session-name} -p {property-name}

DESCRIPTION
Clears the value of a specific session property. Currently, only one property (cluster-audit-saveas-path) is valid, which represents the path for the SVM audit logs.

Valid options for all commands are:
[-s] - Session name
[-p] - Property name

7-Mode Transition Tool>transition property-set ?

NAME
property-set -- Sets value for a specific session property.

SYNOPSIS
transition property-set -s {session-name} -p {property-name} -v {property-value}

DESCRIPTION
Sets value for the session properties. Currently, only one property (cluster-audit-saveas-path) is valid, which represents the path for the SVM audit logs.

Valid options for all commands are:
[-s] - Session name
[-p] - Property name
[-V] - Property value

7-Mode Transition Tool>transition remove-primary-seven-mode-system ?

NAME
remove-primary-seven-mode-system -- Remove a 7-Mode primary system from the session.

SYNOPSIS
transition remove-primary-seven-mode-system -s {session-name} -h {source-host}

DESCRIPTION
This command removes a 7-Mode primary system from the transition session. This command is applicable only for 'secondary' type sessions.

7-Mode Transition Tool>transition remove-secondary-cluster-mode-system ?

NAME
remove-secondary-cluster-mode-system -- Remove a Clustered Data ONTAP secondary system that has been added the session.

SYNOPSIS
transition remove-secondary-cluster-mode-system -s {session-name} -v {secondary-svm}

DESCRIPTION
This command removes a Clustered Data ONTAP secondary system from the transition session. This command is applicable only for 'primary' type sessions.

7-Mode Transition Tool>transition resume ?

NAME
resume -- Resume data transfers from the 7-Mode to Clustered Data ONTAP volumes.

SYNOPSIS
transition resume -s {session-name} [ -r {interactive} ]

DESCRIPTION
This command resumes data transfers from the 7-Mode volumes to Clustered Data ONTAP volumes. Session state must be in 'copy-pause' to run this command.

Valid options are:-
-s {session-name} - Session name

7-Mode Transition Tool>transition resync ?

NAME
resync -- The transition resync command triggers the SnapMirror resync operation between the session 7-Mode and clustered Data ONTAP volumes.

SYNOPSIS
transition resync -s {session-name} [ -r {interactive} ]

DESCRIPTION
The transition resync command triggers the SnapMirror resync operation between the session 7-Mode and clustered Data ONTAP volumes.

7-Mode Transition Tool>transition show ?

NAME
show -- Display the list of transition sessions or display information about a given session.

SYNOPSIS
transition show [ -s {session-name} ] [ -r {interactive} ]

DESCRIPTION
Display information about a given session such as session name, 7-Mode storage system, SVM, session and status.

Valid options are:-
-s {session-name} - Display detailed information about a session

7-Mode Transition Tool>transition show-primary-seven-mode-systems ?

NAME
show-primary-seven-mode-systems -- Display the list of 7-Mode primary systems added to the session.

SYNOPSIS
transition show-primary-seven-mode-systems -s {session-name}

DESCRIPTION
This command displays the list of 7-Mode primary systems added to the session. This command is applicable only for 'secondary' type sessions.

7-Mode Transition Tool>transition show-secondary-cluster-mode-systems ?

NAME
show-secondary-cluster-mode-systems -- Display the list of Clustered Data ONTAP secondary systems added to the session.

SYNOPSIS
transition show-secondary-cluster-mode-systems -s {session-name}

DESCRIPTION
This command displays the list of Cluster-Mode secondary system added to the session. This command is applicable only for 'primary' type sessions.

7-Mode Transition Tool>transition start ?

NAME
start -- Start data copy from 7-Mode volumes to Cluster Data ONTAP volumes.

SYNOPSIS
transition start -s {session-name} [ -n  ] [ -r {interactive} ]

DESCRIPTION
This command starts the transition process. This process involves the following steps:
* Validating compatibility of 7-Mode system against Clustered Data ONTAP system
* Creating SVM and volumes on Clustered Data ONTAP system, if required
* Start data copy from 7-Mode to Clustered Data ONTAP volumes

The Clustered Data ONTAP volumes are periodically updated according to the schedule specified in the session.

Valid options are:-
-s {session-name} - Name of the session
[-n]              - Skip precheck operation if no errors were reported in the last precheck operation.

Note that:-
* If the precheck operation reports any error, start operation fails. In this case, fix the errors reported before invoking this command again.
* Data copy operation can still fail after a successful start. Refer to relevant documentation for diagnostic and troubleshooting details.
* Monitor the progress of data copy process by using the "transition show" command.
* Data copy can be paused by using the "transition pause" command and resumed by using the "transition resume" command.

7-Mode Transition Tool>transition update ?

NAME
update -- Triggers the SnapMirror update operation for the clustered Data ONTAP volumes.

SYNOPSIS
transition update -s [ -t {available-transfers-percentage} ]
[ -c {max-cap-concurrent-transfers} ]
[ -x {snapmirror-throttle} ] [ -r {interactive} ]

DESCRIPTION
The transition update command triggers the SnapMirror update operation for the clustered Data ONTAP volumes.

Valid options are:-

-s - Name of the session

-t {available-transfers-percentage} - Percentage of the available volume SnapMirror transfers that should be used for data copy. The available volume SnapMirror transfers is calculated at run time.

-c {max-cap-concurrent-transfers} - Maximum number of concurrent volume SnapMirror transfers that can run during this operation. Value -1 indicates use of all available concurrent volume SnapMirror transfers. If no value is provided, the default -1 is used. Example: 20 - At any point in time, a maximum of 20 concurrent SnapMirror transfers will be done.

-x {snapmirror-throttle} - Maximum throttle limit (in MBps) for this operation that will be shared by the active SnapMirror transfers in this operation. If no value is specified, the default value 'unlimited' will be used for the SnapMirror transfers. The values -1 and 0 represent unlimited throttle. The maximum value allowed is 4194303. For example, if the throttle limit is specified as 100 and the concurrent SnapMirror transfers count is 10, each SnapMirror transfer uses a bandwidth of 10 MBps.

If both max-cap-concurrent-transfers and available-transfers-percentage options are provided, the lowest value is used as the number of concurrent volume SnapMirror transfers that should be used for data copy.

The following example illustrates how the number of concurrent SnapMirror transfers are derived if the available-transfers-percentage option is set to 50% and the max-cap-concurrent-transfers option is set to 25. Consider that the platform supports a maximum of 100 concurrent volume SnapMirror transfers and only 60 are currently  available. The maximum number of concurrent transfers based on the value of the available-transfers-percentage option is 30 (50% of 60). In this case, the maximum number of concurrent volume SnapMirror transfers used is 25 because the max-cap-concurrent-transfers option is set to 25, which is the lowest of the two values.

7-Mode Transition Tool>transition version ?

NetApp Release 7-Mode Transition Tool 1.4RC1: Tue Sep 16 08:55:01 BST 2014

CATEGORIES: transition credentials

7-Mode Transition Tool>transition credentials ?

NAME
credentials -- Transition credentials management commands.

COMMANDS
transition credentials add    - Caches the credentials of a host in the transition server.
transition credentials get    - Retrieve the cached user name of a host.
transition credentials modify - Modifies the cached username and password of host.
transition credentials remove - Delete the cached entry of username and password of a host.

DESCRIPTION
Transition credentials management commands.

7-Mode Transition Tool>transition credentials add ?

NAME
add -- Caches the credentials of a host in the transition server.

SYNOPSIS
transition credentials add -h {host-name} -u {username}

DESCRIPTION
This command enables the tool to cache user name and password of any host, which is used in the work flow of transition.

Valid options are:-
-h {host-name} - FQDN or IP address of a host
-u {username}  - Administrative user name

7-Mode Transition Tool>transition credentials get ?

NAME
get -- Retrieve the cached user name of a host.

SYNOPSIS
transition credentials get -h {host-name}

DESCRIPTION
This command retrieves the cached user name of the specified host.

Valid options are:-
-h {host-name} - FQDN or IP address of a host

7-Mode Transition Tool>transition credentials modify ?

NAME
modify -- Modifies the cached username and password of host.

SYNOPSIS
transition credentials modify -h {host-name} -u {username}

DESCRIPTION
This command modifies the cached username and password of the specified host.

Valid options are:-
-h {host-name} - FQDN or IP address of a host
-u {username}  - Administrative user name

7-Mode Transition Tool>transition credentials remove ?

NAME
remove -- Delete the cached entry of username and password of a host.

SYNOPSIS
transition credentials remove -h {host-name}

DESCRIPTION
This command deletes the cached entry of username and password of the specified host.

Valid options are:-
-h {host-name}  - FQDN or IP address of a host

CATEGORIES: transition lif

7-Mode Transition Tool>transition lif ?

NAME
lif -- LIF management commands.

COMMANDS
transition lif add    - Adds a SVM data LIF to given session.
transition lif modify - Modifies a SVM data LIF of a session.
transition lif remove - Removes an IP addresses from a session.
transition lif show   - Lists all the IP addresses in a session.

DESCRIPTION
LIF management commands

7-Mode Transition Tool>transition lif add ?

NAME
add -- Adds an SVM data LIF to given session.

SYNOPSIS
transition lif add -s {session-name} -i {ip-address} [ -m {netmask} ] [ -g {default-gateway} ] [ -p {home-port} ] [ -n {home-node} ]

DESCRIPTION
This command adds a SVM data LIF to a specified session.

Valid options are:-
-s {session-name}    - Name of the session
-i {ip-address}      - IP address of the LIF
-m {netmask}         - Netmask
-g {default-gateway} - Default gateway
-p {home-port}       - LIF's home port
-n {home-node}       - LIF's home node

7-Mode Transition Tool>transition lif modify ?

NAME
modify -- Modifies an SVM data LIF of a session.

SYNOPSIS
transition lif modify -s {session-name} -i {ip-address} [ -m {netmask} ] [ -g {default-gateway} ] [ -p {home-port} ] [ -n {home-node} ]

DESCRIPTION
This command modifies an SVM data LIF of a given session.

Valid options are:-
-s {session-name}    - Name of the session
-i {ip-address}      - IP address of the LIF
-m {netmask}         - Netmask
-g {default-gateway} - Default gateway
-p {home-port}       - LIF's home port or interface group
-n {home-node}       - LIF's home node

7-Mode Transition Tool>transition lif remove ?

NAME
remove -- Removes an IP addresses from a session.

SYNOPSIS
transition lif remove -s {session-name} -i {ip-address}

DESCRIPTION
This command removes an IP addresses from a specified session.

Valid options are:-
-s {session-name} - Name of the session
-i {ip-address}   - IP address of the LIF

7-Mode Transition Tool>transition lif show ?

NAME
show -- Lists all the IP addresses in a session.

SYNOPSIS
transition lif show -s {session-name} [ -i {ip-address} ]

DESCRIPTION
This command lists all the IP addresses of a specified session.

Valid options are:-
-s {session-name} - Name of the session
-i {ip-address}   - IP address of the LIF

CATEGORIES: transition schedule

7-Mode Transition Tool>transition schedule ?

NAME
schedule -- Transition schedule commands

COMMANDS
transition schedule add    - Adds a SnapMirror schedule to a session
transition schedule modify - Modify a SnapMirror schedule of the session.
transition schedule remove - Removes the SnapMirror schedules from the session.
transition schedule show   - Lists all the SnapMirror schedules in a session.

DESCRIPTION
Transition schedule management commands

7-Mode Transition Tool>transition schedule add ?

NAME
add -- Adds a SnapMirror schedule to a session

SYNOPSIS
transition schedule add -s {session-name} -n {schedule-name} -d {days-range} -b {start-time} -e {duration}
[ -u {update-frequency} ]
[ -t {available-transfers-percentage} ]
[ -c {max-cap-concurrent-transfers} ]
[ -x {session-snapmirror-throttle} ]

DESCRIPTION
This command adds a SnapMirror schedule to the specified session.

Valid options are:-

-s {session-name} - Name of the session

-n {schedule-name} - Name of the schedule

-d {days-range} - Days of the week for the schedule. 0 represents Sunday and 6 represents Saturday. Value * or -1 represents all days of the week. Examples: 1) 1,4 - Monday and Thursday. 2) 0-6 - All days of the week. 3) 1-5 - Monday to Friday. 4) 0-2,5 - Sun, Mon, Tue and Fri. 5) 6-1 - Sat, Sun and Mon.

-b {start-time} - Start time of the schedule in the format {hours}:{minutes}. Valid values are from 0:0 to 23:30. Minutes should be either 0 or 30. Example: 8:30 - Schedule starts at 8 hours and 30 minutes of the day.

-e {duration} - Duration of the schedule in the format {hours}:{minutes}. Minutes should be either 0 or 30. For example, if 20:30 is specified, SnapMirror operations run for next 20 hours and 30 minutes from the start time.

-t {available-transfers-percentage} - Percentage of the available volume SnapMirror transfers that should be used for data copy. The available volume SnapMirror transfers is calculated at run time.

-c {max-cap-concurrent-transfers} - Maximum number of concurrent volume SnapMirror transfers that can run during this schedule. Value -1 indicates use of all available concurrent volume SnapMirror transfers. If no value is provided, the default -1 is used. Example: 20 - At any point in time, a maximum of 20 concurrent SnapMirror transfers will be done.

-x {session-snapmirror-throttle} - Maximum throttle limit (in MBps) for the session that will be shared by the active SnapMirror transfers in the session.If no value is specified, the default value 'unlimited' will be used for the SnapMirror transfers. Values -1 or 0 will represent 'unlimited' throttle. Maximum allowed input value is 4194303. Example: 100 - 100MBps will be shared equally by all the SnapMirror transfers in the session.

-u {update-frequency} - Frequency with which the updates for the SnapMirror relationships in the session must be done during this schedule duration in the format {hours}:{minutes}. If no value is specified, SnapMirror updates will run every 30 minutes. Example: 1:30 - Updates for the SnapMirror relationships in the session will be done every 1 hour and 30 minutes.

If both max-cap-concurrent-transfers and available-transfers-percentage options are provided, the lowest value is used as the number of concurrent volume SnapMirror transfers that should be used for data copy.

The following example illustrates how the number of concurrent SnapMirror transfers are derived if the available-transfers-percentage option is set to 50% and the max-cap-concurrent-transfers option is set to 25. Consider that the platform supports a maximum of 100 concurrent volume SnapMirror transfers and only 60 are currently  available. The maximum number of concurrent transfers based on the value of the available-transfers-percentage option is 30 (50% of 60). In this case, the maximum number of concurrent volume SnapMirror transfers used is 25 because the max-cap-concurrent-transfers option is set to 25, which is the lowest of the two values.

Default schedule parameters - transition schedule add -s {session-name} -n {schedule-name} -d -1 -b 0:0 -e 24:0 -t 50 -c -1

7-Mode Transition Tool>transition schedule modify ?

NAME
modify -- Modify a SnapMirror schedule of the session.

SYNOPSIS
transition schedule modify -s -n
[ -d ] [ -b ]
[ -e ] [ -u ]
[ -t ]
[ -c ]
[ -x ]

DESCRIPTION
This command modifies the SnapMirror schedule of the session.

Valid options are:-

-s {session-name} - Name of the session

-n {schedule-name} - Name of the schedule

-d {days-range} - Days of the week for the schedule. 0 represents Sunday and 6 represents Saturday. Value * or -1 represents all days of the week. Examples: 1) 1,4 - Monday and Thursday. 2) 0-6 - All days of the week. 3) 1-5 - Monday to Friday. 4) 0-2,5 - Sun, Mon, Tue and Fri. 5) 6-1 - Sat, Sun and Mon.

-b {start-time} - Start time of the schedule in the format {hours}:{minutes}. Valid values are from 0:0 to 23:30. Minutes should be either 0 or 30. Example: 8:30 - Schedule starts at 8 hours and 30 minutes of the day.

-e {duration} - Duration of the schedule in the format {hours}:{minutes}. Minutes should be either 0 or 30. For example, if 20:30 is specified, SnapMirror operations run for the next 20 hours and 30 minutes from the start time.

-t {available-transfers-percentage} - Percentage of the available volume SnapMirror transfers that should be used for data copy. The available volume SnapMirror transfers is calculated at run time.
                                                                
-c {max-cap-concurrent-transfers} - Maximum number of concurrent volume SnapMirror transfers that can run during this schedule. Value -1 indicates use of all available concurrent volume SnapMirror transfers. If no value is provided, the default -1 is used. Example: 20 - At any point in time, a maximum of 20 concurrent SnapMirror transfers will be done.
                                                                
-x {session-snapmirror-throttle} - Maximum throttle limit (in MBps) for the session that will be shared by the active SnapMirror transfers in the session.If no value is specified, the default value 'unlimited' will be used for the SnapMirror transfers. Values -1 or 0 will represent 'unlimited' throttle. Maximum allowed input value is 4194303. Example: 100 - 100MBps will be shared equally by all the SnapMirror transfers in the session.
                                                                
-u {update-frequency} - Frequency with which the updates for the SnapMirror relationships in the session must be done during this schedule duration in the format :. If no value is specified, SnapMirror updates will run every 30 minutes. Example: 1:30 - Updates for the SnapMirror relationships in the session will be done every 1 hour and 30 minutes.
                                                                
If both max-cap-concurrent-transfers and available-transfers-percentage options are provided, the lowest value is used as the number of concurrent volume SnapMirror transfers that should be used for data copy.

The following example illustrates how the number of concurrent SnapMirror transfers are derived if the available-transfers-percentage option is set to 50% and the max-cap-concurrent-transfers option is set to 25. Consider that the platform supports a maximum of 100 concurrent volume SnapMirror transfers and only 60 are currently  available. The maximum number of concurrent transfers based on the value of the available-transfers-percentage option is 30 (50% of 60). In this case, the maximum number of concurrent volume SnapMirror transfers used is 25 because the max-cap-concurrent-transfers option is set to 25, which is the lowest of the two values.

7-Mode Transition Tool>transition schedule remove ?

NAME
remove -- Removes the SnapMirror schedules from the session.

SYNOPSIS
transition schedule remove -s -n

DESCRIPTION
This command removes the schedules from the transition session.

Valid options are:-
-s {session-name}            - Name of the session
-n {schedule-name}           - Name of the schedule

7-Mode Transition Tool>transition schedule show ?

NAME
show -- Lists all the SnapMirror schedules in a session.

SYNOPSIS
transition schedule show -s {session-name} [ -n {schedule-name} ] [ -r {interactive} ]

DESCRIPTION
This command displays all the schedules in a session.

Valid options are:-
-s {session-name}  - Name of the session
-n {schedule-name} - Name of the schedule. If the schedule is not specified, details of all the schedules are displayed.

CATEGORIES: transition volumepair

7-Mode Transition Tool>transition volumepair ?

NAME
volumepair -- Transition volume pair commands.

COMMANDS
transition volumepair add    - Adds 7-Mode and Clustered Data ONTAP volume pair to a session.
transition volumepair modify - Modifies the Clustered Data ONTAP volume in the volume pair of the session.
transition volumepair remove - Removes the volume pairs from the session.
transition volumepair show   - Lists all the volume pairs in a session.

DESCRIPTION
Transition volume pair management commands.

7-Mode Transition Tool>transition volumepair add ?

NAME
add -- Adds 7-Mode and Clustered Data ONTAP volume pair to a session.

SYNOPSIS
transition volumepair add -s {session-name} -v {volume-name-7-mode} [ -c {volume-name-c-mode} ] [ -g {aggregate-name} ]

DESCRIPTION
This command adds 7-Mode and Clustered Data ONTAP volume pair to the specified session.

Valid options are:-
-s {session-name}       - Name of the session
-v {volume-name-7-mode} - 7-Mode volume name
-c {volume-name-c-mode} - Clustered Data ONTAP volume name
-g {aggregate-name}     - Aggregate name that hosts the Clustered Data ONTAP volume

7-Mode Transition Tool>transition volumepair modify ?

NAME
modify -- Modifies the Cluster-Mode volume in the volume pair of the session.

SYNOPSIS
transition volumepair modify -s {session-name} -v {volume-name-7-mode} [ -c {volume-name-c-mode} ] [ -g {aggregate-name} ]

DESCRIPTION
This command modifies the Clustered Data ONTAP volume in the volume pair of the session.

Valid options are:-
-s {session-name}       - Name of the session
-v {volume-name-7-mode} - 7-Mode volume name
-c {volume-name-c-mode} - Clustered Data ONTAP volume name
-g {aggregate-name}     - Aggregate name which hosts the Clustered Data ONTAP volume

7-Mode Transition Tool>transition volumepair remove ?

NAME
remove -- Removes the volume pairs from the session.

SYNOPSIS
transition volumepair remove -s {session-name} -v {volume-name-7-mode}

DESCRIPTION
This command removes the volume pairs the transition session.

Valid options are:-
-s {session-name}       - Name of the session
-v {volume-name-7-mode} - 7-Mode volume name

7-Mode Transition Tool>transition volumepair show ?

NAME
show -- Lists all the volume pairs in a session.

SYNOPSIS
transition volumepair show -s {session-name} [ -v {volume-name-7-mode} ] [ -r {interactive} ]

DESCRIPTION
This command displays all the volume pairs in a session.

Valid options are:-
-s {session-name}       - Name of the session
-v {volume-name-7-mode} - 7-Mode volume name


No comments:

Post a Comment