Reconfiguring the Network Environment

From the Network Environment list of the Service Web UI, an administrator can edit the network environment information provided during initial system setup. Carefully plan any changes you make in this area, as these parameters provide the connections from your data center to the Private Cloud Appliance and can potentially disrupt system operations.

Editing Routing Information

Caution:

It is not supported to change your routing information for your dynamic or static network topology.

Editing Management Node Information

This section explains how to edit IP and hostname information for your management nodes.

Caution:

Changing management node parameters can cause system disruption.

Using the Service Web UI

  1. In the navigation menu, click Network Environment.

  2. In the Network Environment Information page, click the Management Nodes tab.

    The Management Nodes details appear.

  3. In the top-right corner of the page, click Edit.

  4. Click Next to navigate to the page you want to edit, then update the appropriate fields.

    For field descriptions, see the Initial Installation Checklist section in the Oracle Private Cloud Appliance Installation Guide.

  5. Click Save Changes.

Using the Service CLI

  1. Display the current network configuration information using the show NetworkConfig command.

    PCA-ADMIN> show NetworkConfig
    Command: show NetworkConfig
    Status: Success
    Time: 2021-09-28 17:31:33,990 UTC
    Data:
      Uplink Port Speed = 100
      Uplink Port Count = 2
      Uplink Vlan Mtu = 9216
      Spine1 Ip = 10.n.n.12
      Spine2 Ip = 10.n.n.13
      Uplink Netmask = 255.255.255.0
      Management VIP Hostname = ukpca01mn
      Management VIP 100g = 10.n.n.8
      NTP Server(s) = 100.n.n.254
      Uplink Port Fec = auto
      Public Ip range/list = 10.n.n.2/32,10.n.n.3/32,10.n.n.4/32,10.n.n.5/32,10.n.n.6/32,10.n.n.7/32
      DNS Address1 = 206.n.n.1
      DNS Address2 = 206.n.n.2
      DNS Address3 = 10.n.n.197
      Management Node1 Hostname = ukpca01-mn1
      Management Node2 Hostname = ukpca01-mn2
      Management Node3 Hostname = ukpca01-mn3
      100g Management Node1 Ip = 10.n.n.9
      100g Management Node2 Ip = 10.n.n.10
      100g Management Node3 Ip = 10.n.n.11
      Object Storage Ip = 10.n.n.1
      Enable Admin Network = false
      Static Routing = true
      Spine VIP = 10.n.n.14
      Uplink Gateway = 10.n.n.1
      Uplink VLAN = 799
      Uplink Hsrp Group = 61
      BGP Authentication = false
  2. Use the edit NetworkConfig command to change any of these management node parameters:

    • Management Node 1 IP

    • Management Node 1 Hostname

    • Management Node 2 IP

    • Management Node 2 Hostname

    • Management Node 3 IP

    • Management Node 3 Hostname

    • Management Node VIP

    • Management Node VIP Hostname

    PCA-ADMIN> edit NetworkConfig mgmt01Ip100g=172.n.n.190 mgmt02Ip100g=172.n.n.191
    Command: edit NetworkConfig mgmt01Ip100g=172.n.n.190 mgmt02Ip100g=172.n.n.191
    Status: Success
    Time: 2021-09-27 14:25:00,603 UTC
    JobId: 52f5177d-402a-4a52-98fe-1cff9c1f26be
    PCA-ADMIN>

This section explains how to edit uplink information for your configuration.

Caution:

Reconfiguring the Private Cloud Appliance connection to the data center causes an interruption of all network connectivity to and from the appliance. No network traffic is possible while the physical connections are reconfigured. All connections are automatically restored when the configuration update is complete.

Using the Service Web UI

Using the Service CLI

Updating NTP Server Information

This section explains how to edit or add NTP server IP addresses.

Using the Service Web UI

  1. In the navigation menu, click Network Environment.

  2. In the Network Environment Information page, click the NTP tab.

    The NTP details appear.

  3. In the top-right corner of the page, click Edit.

  4. Click Next to navigate to the page you want to edit, then update the appropriate fields.

    For field descriptions, see the Initial Installation Checklist section in the Oracle Private Cloud Appliance Installation Guide.

  5. Click Save Changes.

Using the Service CLI

  1. Display the current network configuration information using the show NetworkConfig command.

    PCA-ADMIN> show NetworkConfig
    Command: show NetworkConfig
    Status: Success
    Time: 2021-09-28 17:31:33,990 UTC
    Data:
      Uplink Port Speed = 100
      Uplink Port Count = 2
      Uplink Vlan Mtu = 9216
      Spine1 Ip = 10.n.n.12
      Spine2 Ip = 10.n.n.13
      Uplink Netmask = 255.255.255.0
      Management VIP Hostname = ukpca01mn
      Management VIP 100g = 10.n.n.8
      NTP Server(s) = 100.n.n.254
      Uplink Port Fec = auto
      Public Ip range/list = 10.n.n.2/32,10.n.n.3/32,10.n.n.4/32,10.n.n.5/32,10.n.n.6/32,10.n.n.7/32
      DNS Address1 = 206.n.n.1
      DNS Address2 = 206.n.n.2
      DNS Address3 = 10.n.n.197
      Management Node1 Hostname = ukpca01-mn1
      Management Node2 Hostname = ukpca01-mn2
      Management Node3 Hostname = ukpca01-mn3
      100g Management Node1 Ip = 10.n.n.9
      100g Management Node2 Ip = 10.n.n.10
      100g Management Node3 Ip = 10.n.n.11
      Object Storage Ip = 10.n.n.1
      Enable Admin Network = false
      Static Routing = true
      Spine VIP = 10.n.n.14
      Uplink Gateway = 10.n.n.1
      Uplink VLAN = 799
      Uplink Hsrp Group = 61
      BGP Authentication = false
  2. Use the edit NetworkConfig command to change the NTP servers. Enter multiple IP addresses in a comma-separated list:

    PCA-ADMIN> edit NetworkConfig ntpIps=100.n.n.254,100.n.n.253
    Command: edit NetworkConfig ntpIps=100.n.n.254,100.n.n.253
    Time: 2021-09-27 14:31:00,605 UTC
    JobId: 42f5137f-122a-4a52-98fe-1cfv9c1f26ve
    PCA-ADMIN>

Editing Administration Network Information

If you use the optional Administration Network, you can update the parameters using these procedures.

Caution:

If you are not currently using a separate Administration Network, the Network Environment Information page in the Service Web UI will not display an Admin Network tab or any of the related configuration parameters. You must first enable the Administration Network.

Once an Administration Network is configured, it cannot be disabled again.

To edit Administration Network information, see the following resources in the Oracle Private Cloud Appliance Installation Guide:

Using the Service Web UI

Scenario 1: Administration Network Disabled

If you need to enable and configure a separate Administration Network, proceed as follows:

  1. In the navigation menu, click Network Environment.

  2. In the top-right corner of the page, click Edit.

  3. In the wizard, navigate to the Admin Network tab and set Admin Networking to Enable.

  4. Enter all the required parameters in the respective fields on the form.

  5. Click Save Changes.

Scenario 2: Administration Network Enabled

If you already configured a separate Administration Network and need to edit its settings, proceed as follows:

  1. In the navigation menu, click Network Environment.

  2. In the Network Environment Information page, click the Admin Network tab.

    The Admin Network details appear.

  3. In the top-right corner of the page, click Edit.

  4. Click Next to navigate to the page you want to edit, then update the appropriate fields.

  5. Click Save Changes.

Using the Service CLI

Caution:

If you are not currently using a separate Administration Network, the Service CLI output will not display any Admin Network parameters. You must first enable the Administration Network.

  1. Display the current network configuration information using the show NetworkConfig command.

    PCA-ADMIN> show NetworkConfig
    Command: show NetworkConfig
    Status: Success
    Time: 2022-10-11 07:13:12,186 UTC
    Data:
      Uplink Port Speed = 100
      Uplink Port Count = 4
      Uplink Vlan Mtu = 9216
      Spine1 Ip = 10.10.10.97,10.10.10.101
      Spine2 Ip = 10.10.10.99,10.10.10.103
      Uplink Netmask = 255.255.255.254,255.255.255.254
      Management VIP Hostname = mypca
      Management VIP = 10.10.10.107
      NTP Server(s) = 10.80.211.105,10.211.17.1,10.68.48.1
      Uplink Port Fec = auto
      Public Ip range/list = 10.10.10.114/31,10.10.10.116/31,10.10.10.118/31,10.10.10.120/31,10.10.10.122/31,10.10.10.124/31,10.10.10.126/32
      Management Node1 Hostname = pcamn01
      Management Node2 Hostname = pcamn02
      Management Node3 Hostname = pcamn03
      Management Node1 Ip = 10.10.10.108
      Management Node2 Ip = 10.10.10.109
      Management Node3 Ip = 10.10.10.110
      Object Storage Ip = 10.10.10.113
      Enable Admin Network = true
      Admin Port Speed = 100
      Admin Port Count = 1
      Admin Vlan Mtu = 9216
      Admin Port Fec = auto
      Admin VLAN = 3915
      Admin Spine1 Ip = 10.25.0.111
      Admin Spine2 Ip = 10.25.0.112
      Admin Spine VIP = 10.25.0.110
      Admin Netmask = 255.255.255.0
      Admin Hsrp Group = 152
      Static Routing = false
      Uplink VLAN = 3911
      Peer1 Asn = 50000
      Peer1 Ip = 10.10.10.96,10.10.10.98
      Oracle Asn = 136025
      Bgp Topology = mesh
      Peer2 Asn = 50000
      Peer2 Ip = 10.10.10.100,10.10.10.102
      BGP Authentication = false
      BGP KeepAlive Timer = 60
      BGP Holddown Timer = 180
      Network Config Lifecycle State = ACTIVE
      admin DNS Address1 = 10.25.0.1
      admin Management Node1 Hostname = pcamn01admin.example.com
      admin Management Node2 Hostname = pcamn02admin.example.com
      admin Management Node3 Hostname = pcamn03admin.example.com
      admin Management Node1 Ip = 10.25.0.101
      admin Management Node2 Ip = 10.25.0.102
      admin Management Node3 Ip = 10.25.0.103
      admin Management VIP Hostname = mypcaadmin.example.com
      admin Management VIP = 10.25.0.100
  2. Use the edit NetworkConfig command to change any of these administration network parameters:

    Tip:

    Enter edit networkConfig ? to display the parameters available for editing.

    • Admin Network enable

    • Management node cluster Admin VIP and host name

    • Management node 1-3 Admin IP and host name

    • Admin DNS IP 1-3

    • Admin Port count, speed, FEC

    • Admin CIDR

    • Admin VLAN and MTU

    • Admin Gateway IP

    • Admin Netmask

    • Spine 1+2 Admin IP

    • Spine Admin VIP

    PCA-ADMIN> edit NetworkConfig adminPortSpeed=25
    Command: edit NetworkConfig adminPortSpeed=25
    Time: 2022-10-11 08:01:00,605 UTC
    JobId: 62f8137f-772a-4a52-98f4-1cfv9c1f24te
    
    PCA-ADMIN> edit NetworkConfig adminCidr=10.25.0.1/24
    Command: edit NetworkConfig adminCidr=10.25.0.1/24
    Status: Success
    Time: 2022-10-11 08:10:02,640 UTC
    JobId: 861381ae-cc63-44a2-a66e-8e095e4a99f9

Updating DNS Information

This section explains how to edit or add DNS IP addresses.

Using the Service Web UI

  1. In the navigation menu, click Network Environment.

  2. In the Network Environment Information page, click the DNS tab.

    The DNS details appear.

  3. In the top-right corner of the page, click Edit.

  4. Click Next to navigate to the page you want to edit, then update the appropriate fields.

    For field descriptions, see the Initial Installation Checklist section in the Oracle Private Cloud Appliance Installation Guide.

  5. Click Save Changes.

Using the Service CLI

  1. Display the current network configuration information using the show NetworkConfig command.

    PCA-ADMIN> show NetworkConfig
    Command: show NetworkConfig
    Status: Success
    Time: 2021-09-28 17:31:33,990 UTC
    Data:
      Uplink Port Speed = 100
      Uplink Port Count = 2
      Uplink Vlan Mtu = 9216
      Spine1 Ip = 10.n.n.12
      Spine2 Ip = 10.n.n.13
      Uplink Netmask = 255.255.255.0
      Management VIP Hostname = ukpca01mn
      Management VIP 100g = 10.n.n.8
      NTP Server(s) = 100.n.n.254
      Uplink Port Fec = auto
      Public Ip range/list = 10.n.n.2/32,10.n.n.3/32,10.n.n.4/32,10.n.n.5/32,10.n.n.6/32,10.n.n.7/32
      DNS Address1 = 206.n.n.1
      DNS Address2 = 206.n.n.2
      DNS Address3 = 10.n.n.197
      Management Node1 Hostname = ukpca01-mn1
      Management Node2 Hostname = ukpca01-mn2
      Management Node3 Hostname = ukpca01-mn3
      100g Management Node1 Ip = 10.n.n.9
      100g Management Node2 Ip = 10.n.n.10
      100g Management Node3 Ip = 10.n.n.11
      Object Storage Ip = 10.n.n.1
      Enable Admin Network = false
      Static Routing = true
      Spine VIP = 10.n.n.14
      Uplink Gateway = 10.n.n.1
      Uplink VLAN = 799
      Uplink Hsrp Group = 61
      BGP Authentication = false
  2. Use the edit NetworkConfig command to change the DNS IP addresses:

    • DNS IP1

    • DNS IP2

    • DNS IP3

    PCA-ADMIN> edit NetworkConfig DnsIp2=206.n.n.2
    Command: edit NetworkConfig DnsIp2=206.n.n.2
    Time: 2021-09-27 14:21:00,605 UTC
    JobId: 42f5137f-122a-4a52-98fe-1cfv9c1f26ve
    PCA-ADMIN>

Updating Public IP Information

This section explains how to edit the public IP addresses for your appliance. You can add public IP addresses, or change the currently configured IP addresses.

Caution:

Changing public IP addresses that are in use can cause system disruption.

Using the Service Web UI

  1. In the navigation menu, click Network Environment.

  2. In the Network Environment Information page, click the Uplink tab.

    The Uplink details appear.

  3. In the top-right corner of the page, click Edit.

  4. Click Next to navigate to the page you want to edit, then update the appropriate fields.

    For field descriptions, see the Initial Installation Checklist section in the Oracle Private Cloud Appliance Installation Guide.

  5. Click Save Changes.

Using the Service CLI

  1. Display the current network configuration information using the show NetworkConfig command.

    PCA-ADMIN> show NetworkConfig
    Command: show NetworkConfig
    Status: Success
    Time: 2021-09-28 17:31:33,990 UTC
    Data:
      Uplink Port Speed = 100
      Uplink Port Count = 2
      Uplink Vlan Mtu = 9216
      Spine1 Ip = 10.n.n.12
      Spine2 Ip = 10.n.n.13
      Uplink Netmask = 255.255.255.0
      Management VIP Hostname = ukpca01mn
      Management VIP 100g = 10.n.n.8
      NTP Server(s) = 100.n.n.254
      Uplink Port Fec = auto
      Public Ip range/list = 10.n.n.2/32,10.n.n.3/32,10.n.n.4/32,10.n.n.5/32,10.n.n.6/32,10.n.n.7/32
      DNS Address1 = 206.n.n.1
      DNS Address2 = 206.n.n.2
      DNS Address3 = 10.n.n.197
      Management Node1 Hostname = ukpca01-mn1
      Management Node2 Hostname = ukpca01-mn2
      Management Node3 Hostname = ukpca01-mn3
      100g Management Node1 Ip = 10.n.n.9
      100g Management Node2 Ip = 10.n.n.10
      100g Management Node3 Ip = 10.n.n.11
      Object Storage Ip = 10.n.n.1
      Enable Admin Network = false
      Static Routing = true
      Spine VIP = 10.n.n.14
      Uplink Gateway = 10.n.n.1
      Uplink VLAN = 799
      Uplink Hsrp Group = 61
      BGP Authentication = false
  2. Use the edit NetworkConfig command to change the public IP addresses or the object storage public IP address:

    • Object Storage Public IP

    • Public IP Range/List

    PCA-ADMIN> edit NetworkConfig PublicIps= 10.n.n.17/32,10.n.n.18/32,10.n.n.19/32
    Command: edit NetworkConfig PublicIps= 10.n.n.17/32,10.n.n.18/32,10.n.n.19/32
    Time: 2021-09-27 14:21:00,605 UTC
    JobId: 42f5137f-122a-4a52-98fe-1cfv9c1f26ve
    PCA-ADMIN>