Description
This command moves an Oracle instance from one or more clients to a single destination client.
-
If the specified instance is found on any of the source clients, then it is deconfigured on the source client and a new instance with the same name appears on the destination client.
-
If the instance is not found on any of the source clients, or, it is found on two or more source clients, then the command fails and returns an appropriate error message. Use the -sc option multiple times for specifying more than one source client from the command line.
The qoperation move command allows you to optimize the client configuration to run a single backup job for multiple instances on a client or cluster node using RMAN scripts. This eliminates the need to configure each database separately for backups on clusters. You can also use this command to move data and backup history from an instance that has failed over on a cluster from one client to another with the same operating system. Nevertheless, RMAN log cannot be moved using this command to the destination client.
Upon successful completion, qoperation move displays the message "Move operation successful" on the command prompt. In case of an error, an error code and description are displayed as: "move: Error errorcode: errordescription"
Usage
qoperation move -sc <sourceclient> -a <iDataAgent> -i <instance> -dc <destinationclient> [-af <argsfile>] [-tf <tokenfile>] [-tk <token>] [-h]
Options
-sc |
Source client computer name |
-a |
Agent type installed on source client computer (see Argument Values - Agent Types) |
-i |
Instance name to be moved |
-dc |
Destination client name |
-af |
Reads arguments from a file |
-tf |
Reads token from a file |
-tk |
Token string |
-h |
Displays help |
Argument File
For information on creating an argument file, see Command Line - FAQ - How do I use argument files in commands.
sourceclient |
List of source client computer names |
dataagent |
Agent type installed on source client computer (see Argument Values - Agent Types) |
instance |
Instance name to be moved |
destinationclient |
Destination client computer name |
Diagnostics
Possible exit status values are:
0 - Successful completion.
1 - CLI usage failures, due to the use of an unsupported option or missing argument.
2 - Any other failure.
Example
Move an instance rman901 from source clients sc1 or sc2 to a destination client dc1.
qoperation move -sc sc1 -sc sc2 -a Q_ORACLE -i rman901 -dc dc1