162 XAG-00001 to XAG-01104

XAG-00001: invalid verb 'string' specified on command line

Cause: The agctl command was issued with an unknown verb arguement.

Action: Use agctl with the --help option to display all valid verbs and make sure that a valid verb is specified.

XAG-00002: invalid object 'string' specified on command line

Cause: The object specified on the command line was not recognized.

Action: Use agctl with the --help option to display valid verbs, objects, and options. Ensure that a valid combination of verb and object is specified.

XAG-00201: missing mandatory option 'string'

Cause: The specified mandatory command option was missing.

Action: Supply the required option.

XAG-00202: Directory or file 'string' does not exist.

Cause: The directory or file specified on the command line does not exist.

Action: Specify a directory path or file that exists.

XAG-00203: Path 'string' is not a directory.

Cause: The specified file system path is not a directory.

Action: Specify a file system directory.

XAG-00204: File 'string' is not readable, (error: string).

Cause: An attempt to open the indicated file for read access failed.

Action: Ensure that the user has read permission on the indicated file.

XAG-00205: File 'string' is not writable.

Cause: An attempt to open the indicated file for write access failed.

Action: Ensure that the user has write permission on the indicated file.

XAG-00206: invalid or unexpected text 'string'

Cause: Text on the command line was neither an option nor part of a value.

Action: Refer to 'agctl --help' for information on command syntax and arguments.

XAG-00207: invalid instance name 'string'

Cause: The specified instance name contained illegal characters.

Action: Ensure the instance name doesn't contain special characters '[].@#$%^&*()+='. Reissue the command with a valid instance name.

XAG-00208: Missing mandatory instance name.

Cause: The mandatory instance name was missing.

Action: Ensure an instance name is specified and reissue the command.

XAG-00209: Invalid number 'string' for option string.

Cause: A value specified on the command line option is not numeric.

Action: Ensure the value contains only decimal digits 0-9.

XAG-00210: Option 'string' must be followed by a value.

Cause: An option that requires a value was specified without one.

Action: Specify the option with a value. Refer to 'agctl --help' for additional information.

XAG-00211: The 'string' and 'string' options cannot both be supplied.

Cause: Conflicting options were specified on the command.

Action: Reissue the command specifying only one of the two options. Refer to 'agctl --help' for additional information.

XAG-00212: Instance 'string' is not yet registered.

Cause: The instance name specified on the command line was not registered to Oracle Clusterware.

Action: Use 'agctl add' command to register an instance to Oracle Clusterware.

XAG-00213: Web server 'string' does not exist.

Cause: The web server specified on the command line is not registered to Oracle Clusterware.

Action: Use 'agctl add webserver' command to register a web server to Oracle Clusterware first and then reissue the command.

XAG-00214: Instance 'string' was already enabled.

Cause: The enable command failed because the instance is already enabled.

Action: If this is the expected state then this is not an error. If it is not then an instance can be disabled with the 'agctl disable' command.

XAG-00215: Instance 'string' was already disabled.

Cause: The disable command failed because the instance is already disabled.

Action: If this is the expected state then this is not an error. If it is not then an instance can be enabled with the 'agctl enable' command.

XAG-00216: Instance 'string' is already running.

Cause: The start command failed because the instance is already running.

Action: If this is the expected state then this is not an error. If it is not then an instance can be stopped with the 'agctl stop' command.

XAG-00217: failed to add type 'string'

Cause: An error occured while creating a new resource type in Oracle Clusterware.

Action: Correct the problem indicated in the accompanying messages and then retry.

XAG-00218: invalid option 'string'

Cause: The text specified on the command line was not a known option.

Action: Use agctl with the --help option to display all valid options, and make sure that a valid option is specified.

XAG-00219: Instance 'string' is not running.

Cause: The stop command failed because the instance is not running.

Action: If this is the expected state then this is not an error. If it is not then an instance can be started with the 'agctl start' command.

XAG-00220: Instance 'string' was already registered.

Cause: The instance name specified on the command line is already registered to Oracle Clusterware.

Action: If this is the expected state then this is not an error. If it is not then an instance can be removed with the 'agctl remove' command.

XAG-00221: No option was specified for 'modify string' operation.

Cause: An attempt was made to modify an instance, but no option is specified on the command line.

Action: Use 'agctl modify --help' command to display all valid options for modify command and make sure that a valid option is specified.

XAG-00222: User doesn't have root privilege to create VIP resource.

Cause: The network/ip/user VIP resource is to be created in Oracle Clusterware, but the user does not have root privilege to create the VIP resource.

Action: Ensure that user have root privilege to create VIP resource and then reissue the command.

XAG-00223: User doesn't have root privilege to remove VIP resource.

Cause: The network/ip/user VIP resource is to be removed from Oracle Clusterware, but the user does not have root privilege to remove the VIP resource.

Action: Ensure that user have root privilege to remove VIP resource and then reissue the command.

XAG-00224: User doesn't have root privilege to modify VIP resource.

Cause: The network/ip/user VIP resource is to be modified in Oracle Clusterware, but the user does not have root privilege to modified the VIP resource.

Action: Ensure that user have root privilege to modify VIP resource and then reissue the command.

XAG-00225: Server pool 'string' does not exist.

Cause: The server pool specified on the command line is not registered to Oracle Clusterware.

Action: Ensure that server pool exists in Oracle Clusterware and then reissue the command.

XAG-00226: Instance 'string' was already enabled at node 'string'.

Cause: The enable command with node option failed because the instance is already enabled on specified node.

Action: If this is the expected state then this is not an error. If it is not then an instance can be disabled with the 'agctl disable' command.

XAG-00227: Instance 'string' was already disabled at node 'string'.

Cause: The disable command with node option failed because the instance is already disabled on specified node.

Action: If this is the expected state then this is not an error. If it is not then an instance can be enabled with the 'agctl enable' command.

XAG-00228: VIP name 'string' does not exist.

Cause: The VIP name specified on the command line is not registered to Oracle Clusterware.

Action: Ensure that VIP name exists in Oracle Clusterware and then reissue the command.

XAG-00229: Removing running resource 'string' requires the --force option.

Cause: An attempt was made to remove resource that is still running.

Action: Use the --force option with the remove command.

XAG-00230: Failed to stop running instance 'string'.

Cause: An attempt was made to stop an instance that is still running.

Action: Correct the problem indicated in the accompanying messages, and then retry.

XAG-00231: The string instance does not exist.

Cause: An attempt to add the an instance specified in the message failed because the instance did not exist.

Action: Use 'agctl add' command to register an instance to Oracle Clusterware and then reissue the command.

XAG-00233: Database 'string' does not exist or is not registered.

Cause: The specified Oracle database does not exist or is not registed to Oracle Clusterware.

Action: Add the database to Oracle Clusterware using 'srvctl add database'.

XAG-00234: Invalid database name 'string'.

Cause: The specified database name is not confirming to Oracle database name standards.

Action: Correct the database name.

XAG-00235: Incorrect qualifier 'string' specified for database.

Cause: An incorrect qualifier was specified for a database. The only acceptable value is: 'global'

Action: Correct the qualifier.

XAG-00236: Database service 'string' does not exist or is not registered.

Cause: The specified Oracle database service does not exist or is not registered to Oracle Clusterware.

Action: Add the database service to Oracle Clusterware using 'srvctl using service'.

XAG-00237: File system resource 'string' does not exist or is not registered.

Cause: The specified file system resource is not registered to Oracle Clusterware.

Action: Add the file system resource to Oracle Clusterware using Clusterware administrative tools.

XAG-00238: The IP address is already registered to Oracle Clusterware with string resource.

Cause: The specified IP address is already registered to Oracle Clusterware with another resource.

Action: Use an IP address that is not associated with another Oracle Clusterware.

XAG-00239: duplicate options string 'string' specified

Cause: A command line option was specified more than once.

Action: Omit one option or the other; refer to 'agctl --help' for additional information.

XAG-00240: Siebel instance 'string' already registered with Siebel Enterprise name 'string' and Siebel Server name 'string'

Cause: The Siebel instance with Enterprise name and Server name was already registered to Oracle Clusterware.

Action: Use 'agctl add siebel_server' command to register an instance with a different Enterprise name or Server name.

XAG-00241: PeopleSoft Application Server instance 'string' is already registered with PeopleSoft Server Domain name 'string'.

Cause: The PeopleSoft Application Server instance with Server Domain name was already registered with Oracle Clusterware.

Action: Reissue the 'agctl' command to register an instance with a different Server Domain name.

XAG-00242: PeopleSoft Batch Server instance 'string' is already registered with PeopleSoft Scheduler Database name 'string'.

Cause: The PeopleSoft Batch Server instance with Scheduler Database name was already registered with Oracle Clusterware.

Action: Reissue the 'agctl' command to register an instance with a different Scheduler Database name.

XAG-00243: PeopleSoft Web PIA Server instance 'string' is already registered with PeopleSoft Server Domain name 'string'.

Cause: The PeopleSoft Web PIA Server instance with Server Domain name was already registered with Oracle Clusterware.

Action: Reissue the 'agctl' command to register an instance with a different Server Domain name.

XAG-00244: 'uniform' is not a valid 'instance_count' without the 'server_pool' option.

Cause: An attempt to register an instance using the 'agctl' command failed because 'uniform' was specified as the 'instance_count' option, but the 'server_pool' option was not included.

Action: Reissue the 'agctl' command and include the 'server_pool' option to register the instance with 'instance_count' specified as 'uniform'.

XAG-00245: The value of 'instance_count' option is invalid.

Cause: An attempt to register an instance using the 'agctl' command failed because the specified 'instance_count' option was invalid. The 'instance_count' option must be either 'uniform' or a number greater than zero.

Action: Reissue the 'agctl' command specifying the value of the 'instance_count' option as either 'uniform' or a number greater than zero.

XAG-00250: Node 'string' duplicated in the node list.

Cause: An attempt to register an instance using the 'agctl' command failed because a node name appears more than once in the node list.

Action: Reissue the 'agctl' command specifying a node list without duplicates.

XAG-00251: Node 'string' is not a member of the cluster.

Cause: The specified node was not a member of the cluster.

Action: Reissue the 'agctl' command specifying only nodes that are in the cluster.

XAG-00252: Clusterware internal VIP 'string' cannot be used by applications.

Cause: The application could not be registered because a VIP reserved for CRS was specified when registering.

Action: Create an application-specific VIP resource using appvipcfg and specify it when registering the application.

XAG-00253: Parameter 'string' value is not valid, must be one of 'string'.

Cause: A wrong parameter value was passed to agctl.

Action: Pass a valid value from list of permissible values.

XAG-00254: The value of 'mysql_type' option is invalid.

Cause: An attempt to register an instance using the 'agctl' command failed because the specified 'mysql_type' option was invalid. The 'mysql_type' option must be either 'MYSQL' or 'MONITOR'.

Action: Reissue the 'agctl' command specifying the value of the 'mysql_option' option as either 'MYSQL' or 'MONITOR'.

XAG-00255: The 'monitor_agent' option is invalid for MySQL type of 'MONITOR'.

Cause: An attempt to register an instance using the 'agctl' command failed because the 'monitor_agent' option was specified for MySQL type of 'MONITOR'.

Action: Reissue the 'agctl' command without specifying the 'monitor_agent' option.

XAG-00256: Monitor Agent 'string' does not exist.

Cause: The MySQL Enterprise Monitor Agent specified on the command line is not registered to Oracle Clusterware.

Action: Use 'agctl add mysql_server' command with mysql_type of 'MONITOR' to register a MySQL Enterprise Monitor Agent to Oracle Clusterware.

XAG-00257: The Monitor Agent 'string' specified is invalid.

Cause: The Monitor Agent specified on the command line is not a valid MYSQL_TYPE. The Monitor Agent must be a 'MONITOR' MYSQL_TYPE.

Action: Reissue the 'agctl' command specifying the Monitor Agent with a 'MONITOR' MYSQL_TYPE.

XAG-00258: The Oracle GoldenGate OGG_HOME directory 'string' is already registered with 'string' Oracle GoldenGate instance.

Cause: An attempt to add or modify an Oracle GoldenGate resource to Oracle Clusterware was rejected because another Oracle GoldenGate resource with the same OGG_HOME directory was already registered.

Action: Rerun the command 'agctl add or modify goldengate' to register an instance with a different Oracle GoldenGate OGG_HOME directory.

XAG-00259: The --use_local_services option was supplied without --db_services option.

Cause: An attempt to use the --use_local_services option was rejected because that option required also supplying the --db_services option, which was not specified.

Action: Reissue the command without the --use_local_services option, or with both the --db_services option and the --use_local_services option.

XAG-00260: The option 'string' is invalid for this Goldengate installation type.

Cause: An option provided to agctl does not apply to the configured GoldenGate installation.

Action: Reissue the command by omitting the reported option.

XAG-00261: Goldengate installation type cannot be modified.

Cause: The option --service_manager cannot be specified for 'agctl modify'

Action: Reissue the command by omitting the '--service_manager' option.

XAG-00262: The user does not have root privileges to create Goldengate credentials.

Cause: The agctl command to register the GoldenGate instance with CRS was executed as a non-root user.

Action: Reissue the command as 'root'.

XAG-00263: The GoldenGate home directory 'string' cannot be registered with Oracle Clusterware.

Cause: The specified GoldenGate installation directory does not contain the required files for integration with CRS.

Action: Reissue the command by specifying the correct GoldenGate location

XAG-00264: This Grid Infrastructure version is not supported for GoldenGate MicroServices Architecture.

Cause: An attempt to register a GoldenGate instance failed because the Oracle Grid Infrastructure version was older than 12.1.0.2.0.

Action: Reissue the command after upgrading to version 12.1.0.2.0 or higher.

XAG-00265: missing mandatory option : --user

Cause: An attempt to register a resource failed because the agctl command was run as superuser, but the --user option was not specified.

Action: Reissue the command by specifying the --user option.

XAG-00266: The resource cannot be registered with Oracle Clusterware using Standalone Agents.

Cause: An attempt to register a resource failed because an existing XAG resource was already registered to Oracle Clusterware with Bundled Agents.

Action: Use the 'agctl add' command from the Oracle Clusterware home or remove the existing XAG resource and then reissue the command.

XAG-00267: The resource cannot be registered with Oracle Clusterware using Bundled Agents.

Cause: An attempt to register a resource failed because an existing XAG resource was already registered to Oracle Clusterware with Standalone Agents.

Action: Use the 'agctl add' command from the Standalone Agents or remove the existing XAG resource and then reissue the command.

XAG-00268: The Oracle Grid Infrastructure Standalone Agents cannot be upgraded.

Cause: An attempt to upgrade a resource failed because an existing XAG resource was already registered to Oracle Clusterware with Bundled Agents.

Action: Remove the existing XAG resource from the Oracle Clusterware home and then reissue the command.

XAG-00269: The Oracle Grid Infrastructure Bundled Agents cannot be upgraded.

Cause: An attempt to upgrade a resource failed because an existing XAG resource was already registered to Oracle Clusterware with Standalone Agents.

Action: Remove the existing XAG resource from the Standalone Agents and then reissue the command.

XAG-00270: The Oracle GoldenGate container 'string' specified is invalid.

Cause: The Oracle GoldenGate container specified on the command line was not a valid container.

Action: Reissue the 'agctl' command specifying a valid Oracle GoldenGate container.

XAG-00271: The --filesystems_always option was supplied without --filesystems option.

Cause: An attempt to use the --filesystems_always option was rejected because that option requires also supplying the --filesystems option, which was not specified.

Action: Reissue the command without the --filesystems_always option, or specify both the --filesystems option and the --filesystems_always option.

XAG-00272: The Oracle GoldenGate OGG_VAR_HOME directory 'string' is already registered with 'string' Oracle GoldenGate instance.

Cause: An attempt to add or modify an Oracle GoldenGate resource to Oracle Clusterware was rejected because another Oracle GoldenGate resource with the same OGG_VAR_HOME directory was already registered.

Action: Rerun the command 'agctl add or modify goldengate' to register an instance with a different Oracle GoldenGate OGG_VAR_HOME directory.

XAG-01001: failed to copy file 'string' to 'string' (error: string)

Cause: An error occurred while copying the specified file.

Action: If this occurs on an 'agctl remove' request, correct the indicated problem and then reissue the request. If it occurs on an 'agctl add' request, the instance has been registered so the request cannot be reissued. In this case, contact Oracle Support Services.

XAG-01002: Could not set ownership on 'string' (error: string)

Cause: failed to set ownership on the specified file or directory

Action: If this occurs on an 'agctl remove' request, correct the indicated problem and then reissue the request. If it occurs on an 'agctl add' request, the instance has been registered so the request cannot be reissued. In this case, contact Oracle Support Services.

XAG-01003: failed to create directory 'string'

Cause: An error occurred while creating trace log directory.

Action: Ensure the directory path exists and the user has write access to it, and reissue the command.

XAG-01004: failed to open trace file 'string' for writing

Cause: An error occurred while opening trace log file for writing.

Action: Ensure the user has write access to the directory and file and reissue the command.

XAG-01100: The E-Business Suite Concurrent Manager is already registered with Oracle Clusterware.

Cause: An attempt to register an E-Business Suite Concurrent Manager instance with Oracle Clusterware was rejected because a Concurrent Manager instance was already registered.

Action: None

XAG-01101: The user does not have root privilege to create E-Business Suite Credentials.

Cause: An attempt to create E-Business Suite Credentials in Oracle Clusterware was rejected because the user did not have root privileges.

Action: Retry the operation logged in as the root user.

XAG-01102: E-Business Suite is not supported on this version of Clusterware.

Cause: An attempt to create an E-Business Suite Concurrent Manager (EBSCM) Clusterware resource was rejected because EBSCM was not supported for Clusterware versions older than 12.1.0.1.

Action: Install E-Business Suite Concurrent Manager in a Cluster that is at version 12.1.0.1 or later.

XAG-01103: The user does not have root privilege to manage the MySQL systemd service.

Cause: An attempt to create a MySQL resource with systemd was rejected because the user did not have sudo access.

Action: Reissue the command after root privileges to manage the MySQL service with systemd have been granted.

XAG-01104: The service name 'string' is not registered to systemd.

Cause: An attempt to create a MySQL resource with systemd was rejected because the service name specified on the command line was not registered to systemd.

Action: Reissue the command after the service name has been registered to systemd.