Deprecated SRVCTL Subprograms or Commands
Oracle recommends that you use alternatives for several SRVCTL commands and parameters deprecated.
Single Character Parameters Deprecated for all SRVCTL Commands
Single-character parameters are deprecated. Use the full keyword for each parameter. Refer to the information here to understand how to update scripts using single-character parameters.
Oracle recommends that you use the full keyword for each SRVCTL parameter. To support older tools and scripts that still use single-character parameters, the current version of SRVCTL continues to support both single-character parameters and full keyword parameters. However, deprecated functionality can be desupported in a future release.
The command reference topics for SRVCTL show the keywords for each SRVCTL command. The following table lists the deprecated single-character parameters.
Table: Deprecated Single-Character Parameters for SRVCTL Commands
| Single Letter | Long Form | Values | Description | Related Commands |
|---|---|---|---|---|
A | address | { VIP_name | IP }/ netmask / [ if1 [| if2 ...]] | VIP address specification for node applications | Node applications, VIP, network, Listener, SCAN VIP, and SCAN listener commands |
a | all | none | All resources of that kind |
Common |
a | diskgroup | diskgroup_list | Comma-delimited list of Oracle ASM disk groups | Database, instance, Oracle ASM, disk group, and file system commands |
a | detail | None | Print detailed configuration information | Common |
a | available | available_list | A comma-delimited list of available instances | Service commands |
a | abort | None | Stop failed online relocation | Relocate database |
a | viponly | None | Display VIP configuration | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
B | rlbgoal | {NONE| SERVICE_TIME| THROUGHPUT} | The runtime load balancing goal of a service | Service commands |
c | currentnode | current_node | Node name from which to relocate the service | Service commands |
c | cardinality | {UNIFORM| SINGLETON} | Whether the service should run on every active server (UNIFORM) or only one server (SINGLETON) | Service commands |
c | dbtype | type | Type of database: Oracle RAC One Node, Oracle RAC, or single instance | Database, instance, Oracle ASM, disk group, and file system commands |
d | db or database | db_unique_name | Database unique name | Common |
d | device | volume_device | Volume device path | Database, instance, Oracle ASM, disk group, and file system commands |
d | domain | None | Display subdomain served by GNS | OC4J, home, CVU, and GNS commands |
e | emport | em_port_number | Local listen port for Oracle Enterprise Manager | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
e | failovertype | {NONE|SESSION BASIC|TRANSACTION} | The failover type for a service | Service commands |
e | server | server_list | Candidate server list for Oracle RAC One Node database | Database, instance, Oracle ASM, disk group, and file system commands |
f | force | None | Force remove | Common |
g | diskgroup | diskgroup_name | Disk group name | File system, Diskgroup commands |
h | help | None | None | Common |
i | instance | instance_name instance_list | Instance name prefix for administrator-managed Oracle RAC One Node database A comma-delimited list of instance names | Database, instance, Oracle ASM, disk group, and file system commands |
I | ip | ip_address | VIP address on which GNS is to listen | OC4J, home, CVU, and GNS commands |
i | oldinst | instance_name | The old instance name | Service commands |
i | scannumber | scan_ordinal _number | Ordinal number of the IP address for the SCAN | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
i | vip | vip_name or " vip_name _list " | VIP names | Node applications, GNS, VIP, network, listener, SCAN VIP, and SCAN listener commands |
j | acfspath | acfs_path_list | Comma-delimited list of Oracle ACFS paths where the dependency on the database will be set | Database, instance, Oracle ASM, disk group, and file system commands |
j | clbgoal | {SHORT|LONG} | The connection load balancing goal for a service | Service commands |
k | netnum | network_number | The network number | Service commands Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands OC4J, home, CVU, and GNS commands |
l | list | List all records in GNS | OC4J, home, CVU, and GNS commands | |
l | listener | listener_name | The name of a listener | ASM commands |
l | loglevel | log_level | Specify the level (0-6) of logging that GNS should run with | OC4J, home, CVU, and GNS commands |
l | onslocalport | port_number | Oracle Notification Service listening port for local client connections | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
l | role | service_role | Comma-delimited list of server roles within double quotation marks ( "" ), where each role is one of PRIMARY, PHYSICAL_STANDBY, LOGICAL_STANDBY, or SNAPSHOT_STANDBY | Service commands |
m | domain | domain_name | The domain for the database | Database, instance, Oracle ASM, disk group, and file system commands |
m | failovermethod | {NONE|BASIC} | The failover method of a service | Service commands |
m | multicastpost | The port on which the GNS daemon is listening for multicast requests | OC4J, home, CVU, and GNS commands | |
m | path | mountpoint_path | Mountpoint path | Database, instance, Oracle ASM, disk group, and file system commands |
n | name | Advertise a name through GNS using the given address | OC4J, home, CVU, and GNS commands | |
n | node | node_name | The name of a specific node | Common |
n | nodes | node_list | A comma-delimited list of node names | File system commands |
n | dbname | database_name | The database name (DB_NAME), if different from the unique name specified by the -db parameter | Database, instance, Oracle ASM, disk group, and file system commands |
n | scanname | scan_name | Fully-qualified SCAN name (includes the domain) | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
n | servers | server_list | A comma-delimited list of candidate server names | Service commands |
n | targetnode | node_name | Node name to which to relocate the service | Service commands |
o | oraclehome | oracle_home | $ORACLE_HOME path | Database commands |
p | endpoints | [TCP:] port _number [/IPC: key ][/NMP: pipe _name ][/TCPS: s_port ][/SDP: port ] | SCAN listener endpoints | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
p | port | The port which the GNS daemon uses to communicate with the DNS server | OC4J, home, CVU, and GNS commands | |
p | rmiport | port_number | OC4J RMI port number | OC4J, home, CVU, and GNS commands |
P | tafpolicy | {NONE|BASIC} | TAF policy specification | Service commands |
p | spfile | spfile_location | Server parameter file path | Database, instance, Oracle ASM, disk group, and file system commands |
q | notification | {TRUE|FALSE} | Whether FAN is enabled for OCI connections | Service commands |
q | query | Query GNS for the records belonging to a name | OC4J, home, CVU, and GNS commands | |
r | preferred | preferred_list | A comma-delimited list of preferred instances | Service commands |
r | onsremoteport | port_number | Oracle Notification Service listening port for connections from remote hosts | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
r | relocate | Relocate the VIP | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands | |
r | revert | None | Remove target node of failed online relocation request from the candidate server list of administrator-managed Oracle RAC One Node database | Relocate database |
r | role | role_type | Role of the standby database: PRIMARY, PHYSICAL_STANDBY, LOGICAL_STANDBY, or SNAPSHOT_STANDBY | Database, instance, Oracle ASM, disk group, and file system commands |
s | onsonly | Display Oracle Notification Service daemon configuration | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands | |
s | skip | None | Skip checking the ports | Listener, SCAN, and SCAN listener. |
s | statefile | file_name | The file path of the state_file created by a previously run srvctl stop home command | OC4J, home, CVU, and GNS commands |
s | status | Display the status of GNS | OC4J, home, CVU, and GNS commands | |
S | subnet | subnet / net _mask /[ if1 [| if2 ...]] | Network address specification for a network | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
s | service | service_name service_name _list | The name of a service A comma-delimited list of service names | Service commands |
s | startoption | start_options | Startup options for the database (mount, open, read only) | Database, instance, Oracle ASM, disk group, and file system commands |
t | checkinterval | time_interval | Interval in minutes between checks | OC4J, home, CVU, and GNS commands |
t | edition | edition_name | The initial session edition of a service | Service commands |
t | envs | " name_list " | A list of environment variables | Common |
t | namevals | " name = value ,..." | Names and values of environment variables | Common |
T | nameval | " name = value " | Name and value of a single environment variable | Common |
t | update | instance_name | The new instance name | Service commands |
t | remoteservers | host_name [: port_number ] [, host_name [: port_number ]...] | List of remote host name and port number pairs for Oracle Notification Service daemons outside this cluster | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
t | stopoption | stop_options | Stop options for the database ( NORMAL, TRANSACTIONAL, IMMEDITATE, or ABORT ) | Database, instance, Oracle ASM, disk group, and file system commands |
t | toversion | target_version | Version to which you are downgrading | Database, instance, Oracle ASM, disk group, and file system commands |
u | nettype | network_type | The network server type, which can be STATIC, DHCP, or MIXED | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
u | newinst | None | Add a new instance to the service configuration | Service commands |
u | update | Update SCAN listeners to match the number of SCAN VIPs | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands | |
u | user | oracle_user | Oracle user or other authorized user to mount and unmount file systems | Database, instance, Oracle ASM, disk group, and file system commands |
v | verbose | Verbose output | Common | |
v | volume | volume_name | Name of a volume | Database, instance, Oracle ASM, disk group, and file system commands |
V | versions | Common | ||
w | failoverdelay | number | Failover delay | Service commands |
w | nettype | network_type | The network server type, which can be STATIC, DHCP, or MIXED | Node applications, VIP, network, listener, SCAN VIP, and SCAN listener commands |
w | timeout | timeout | Online relocation timeout in minutes | Database, instance, Oracle ASM, disk group, and file system commands |
x | dtp | {TRUE | FALSE} | Whether to enable distributed transaction processing | Service commands |
x | node | node_name | Node name (use this parameter only with noncluster databases) | Common |
y | noprompt | Suppress the confirmation prompt | Common | |
y | policy | {AUTOMATIC | MANUAL} | Management policy for the resource | Database, instance, Oracle ASM, disk group, file system, and service commands |
z | failoverretry | number | Number of failover retries | Service commands |
z | rmdepondisk | To remove a database's dependency upon disk groups | Database, instance, Oracle ASM, disk group, and file system commands |
Miscellaneous SRVCTL Commands and Parameters
If you have scripts dating from Oracle Database 12.2 or earlier releases, then Oracle recommends that you review the deprecated parameters and update your usage to current forms.
The following command parameters are deprecated:
Table: Deprecated Commands and Parameters for SRVCTL
| Command | Deprecated Parameters |
|---|---|
srvctl modify asm | -node node_name |
srvctl modify instance |
Instead, use the |
srvctl modify gns |
Use the |
srvctl * oc4j | The oc4j noun has been deprecated. SRVCTL still accepts the oc4j noun until it is desupported. |
srvctl add service | The PRECONNECT option with the -tafpolicy parameter is deprecated. |
srvctl modify service | The The |