D Oracle Interface Configuration Tool (OIFCFG) Command Reference
The OIFCFG) command-line interface helps you to define and administer network interfaces.
You can use OIFCFG commands Oracle Clusterware environments to:
- Allocate and deallocate network interfaces to components
- Direct components to use specific network interfaces
- Retrieve component configuration information
Note:
Starting with Oracle Grid Infrastructure 23ai, Domain Services Clusters (DSC), which is part of the Oracle Cluster Domain architecture, are desupported.
Oracle Cluster Domains consist of a Domain Services Cluster (DSC) and Member Clusters. Member Clusters were deprecated in Oracle Grid Infrastructure 19c. The DSC continues to be available to provide services to production clusters. However, with most of those services no longer requiring the DSC for hosting, installation of DSCs are desupported in Oracle Database 23ai. Oracle recommends that you use any cluster or system of your choice for services previously hosted on the DSC, if applicable. Oracle will continue to support the DSC for hosting shared services, until each service can be used on alternative systems.
Starting the OIFCFG Command-Line Interface
Before you invoke OIFCFG, ensure that you have started Oracle Clusterware on at least the local node and preferably on all nodes if you intend to include the -global
option in the command syntax.
Note:
To change the global network interface, Oracle Clusterware must be running on all cluster nodes.
Run OIFCFG from the Grid_home
/bin/
directory as the user who installed the Oracle Clusterware software. For example:
$ ./oifcfg
Run the oifcfg -help
command to display online help for OIFCFG.
$ ./oifcfg -help
Summary of the OIFCFG Usage
Describes how to use Oracle Interface Configuration Tool (OIFCFG).
OIFCFG Command Format
oifcfg iflist [-p] [-n] oifcfg setif {-node nodename | -global} {if_name/subnet:if_type[,if_type]}[,...] oifcfg getif [-node nodename | -global] [ -if if_name[/subnet] [-type if_type]] oifcfg delif {{-node nodename | -global} [if_name[/subnet]] [-force] | -force} oifcfg [-help]
OIFCFG Commands
Use these commands to define and manage network interfaces.
You can enter any of the OIFCFG commands listed in Table D-1.
Table D-1 OIFCFG Commands
Command | Description |
---|---|
|
Shows the available interfaces that you can configure with
If the interface has an IPv6 network, then OIFCFG prints the IPv6 subnet on a separate line, similar to the following: eth1 fec0::80 PUBLIC 64 eth1 10.229.184.0 PUBLIC 255.255.248.0 |
|
Sets an interface type (public, cluster interconnect, or Oracle ASM) for an interface. |
|
Displays the interfaces for which an interface type has been defined with the Note: The |
|
Deletes the stored network configuration for global or node-specific interfaces. You can use the |
OIFCFG Command Parameters
This section lists the parameters for the OIFCFG
commands. Note that some parameters are optional, depending on which command you run.
-
-node node_name
: The name of the Oracle Clusterware node as listed in the output from theolsnodes
command. OLSNODES Command Reference describes theolsnodes
command. -
-global
: A network interface can be stored either as a global interface (as reported by theiflist
command) or as a node-specific interface:-
An interface is stored as a global interface when all of the nodes of an Oracle Real Application Clusters (Oracle RAC) cluster have the same interface connected to the same subnet. The global interface (and configuring all nodes with the same network interface for each public subnet and the same network interface for each private subnet) is not only the recommended configuration, but it is also the default installation configuration.
-
An interface can be stored as a node-specific (local) interface.
Note:
Oracle supports interface name wildcards for different interface names across nodes. Oracle does not support using
-node
to configure different specific interface names on different nodes.
-
-
-if if_name
: The name by which the interface is configured in the system. -
subnet
: The subnet address of the interface. -
-type if_type
: One or more comma-delimited interface types:public
,cluster_interconnect
, orasm
. -
-help
: Display online help for OIFCFG commands.
Related Topics
OIFCFG Usage Notes
-
A network interface specification takes the following form:
if_name
/subnet
:if_type
The specification uniquely identifies the network interface using the:
-
Interface name
When using the
oifcfg setif
command, you can specify interface names that contain wildcard characters, such as an asterisk (*), which matches any string. However, you must surround interface names that contain wildcards with double quotation marks (""
).Note:
Oracle recommends that you do not use wildcards in a cluster with pre-Oracle Database 11g release 2 (11.2.0.2) databases because Oracle resolves the interface name by expanding the wildcard on the local node and also issues a PRIF-0029 warning every time you run the
oifcfg getif
command.If you use wildcards with Oracle Databases that are pre-11g release 2 (11.2.0.2), then those databases must use the
CLUSTER_INTERCONNECTS
parameter, instead. -
Associated subnet
-
Interface type
The interface type indicates the purpose for which the network is configured. The supported interface types are:
-
public
: An interface that can be used for communication with components external to Oracle RAC instances, such as Oracle Net and Virtual Internet Protocol (VIP) addresses. -
cluster_interconnect
: A private interface used for the cluster interconnect to provide interinstance or Cache FusionFoot 1 communication. -
asm
: An interface that can be used for communication with Oracle ASM.
If you set the interface type to
cluster_interconnect
, then it affects instances as they start and changes do not take effect until you restart the instances. -
For example, the following specification identifies
qfe0
as a cluster interconnect located at the address 204.152.65.0:qfe0/204.152.65.0:cluster_interconnect
-
-
The Oracle Universal Installer uses OIFCFG to identify and display available interfaces.
-
The effect of changing the interface names depends on which name you are changing, and whether you are also changing the IP address. In cases where you change only the interface names, the ramifications are minor. If you change the name for the public interface that is stored in the Oracle Cluster Registry (OCR), you must modify the nodeapps for each node. Therefore, you must stop the nodeapps for this change to take effect.
-
You must restart Oracle Clusterware on all members of the cluster when you make global changes. For local changes, you need only to perform a node restart. Interconnect changes for the database occur at instance startup. However, the interconnect for Oracle Clusterware might be different.
-
Because interconnects are chosen when instances start, only issuing OIFCFG commands does not have an immediate effect on the running system. Instead, changes take effect after restarting the component that might be affected by the command.
-
Changes you make to cluster-wide network classifications with OIFCFG require all known cluster nodes to be up so that their Grid Plug and Play profiles can be updated.
OIFCFG Examples
These examples show some common uses for the OIFCFG commands.
Listing the Names of Network Interfaces
You can use OIFCFG to list the interface names and the subnets of all of the
interfaces available on the local node by running the iflist
keyword, as shown in this example:
oifcfg iflist
eth0 172.19.141.0
eth1 172.21.65.0
Retrieving Network Information
You can also retrieve specific OIFCFG information with a getif
command.
For example, after you install Oracle Clusterware, you can verify that the public and cluster interconnect have been set to the desired values by entering the following command:
$ oifcfg getif
This command returns values for global public
and global cluster_interconnect
, similar to the following:
eth0 172.19.141.0 global public
eth1 172.21.65.0 global cluster_interconnect
Storing a Global Interface
To store an interface, use the setif
keyword. For example, to store the interface eth0
, with the subnet 172.19.141.0, as a global interface (to be used as an interconnect for all of the Oracle RAC instances in your cluster and Oracle Clusterware), use the command:
oifcfg setif -global eth0/172.19.141.0:cluster_interconnect
Note:
Ensure that all nodes are running when you run the setif
command because Oracle cannot update Grid Plug and Play profiles on nodes that are not running.
Deleting the Stored Interface
Use the oifcfg delif
command to delete the stored configuration for global or node-specific interfaces. A specific node-specific or global interface can be deleted by supplying the interface name, with an optional subnet, on the command line.
Note:
If you only enter oifcfg delif
, with no other arguments given on the command line, then OIFCFG deletes all interfaces on all nodes in the cluster.
For example, the following command deletes the global interface named eth1
for the subnet 172.21.65.0:
oifcfg delif -global eth1/172.21.65.0
The following command deletes all of the global interfaces assigned with OIFCFG:
oifcfg delif -global
Footnote Legend
Footnote 1:Cache Fusion is a diskless cache coherency mechanism that provides copies of blocks directly from a holding instance's memory cache to a requesting instance's memory cache.