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
Comments
Post a Comment