Viewing and modifying IP groups and addresses

View or modify details for each IP group and IP addresses within the IP group.

Before you begin

You must be assigned one of the following permissions to perform these steps:
  • Cloud group administration role with permission to View all cloud groups (Read-only)
  • Cloud group administration role with permission to View all cloud groups (Read-only permission)
  • Resource level administration role with Read access rights permission (ACL) to view a specific instance
  • Resource level administration role with Write or All access rights permission (ACL) to view and manage a specific instance

For an overview of IP groups and how they are used with Cloud Pak System Software, see IP groups overview.

About this task

You can use the console, the command line interface, or the REST API to complete this task. For the command line and REST API information, see the Related information section.

Procedure

  1. Click Cloud > IP Groups. If you are on 2.3.3.3, navigate to Cloud > Architecture > IP Groups.
  2. Select an IP group.
    You can view or modify the following fields. Editable fields display either edit or remove links, or are underlined with a dash line.
    Jobs
    Specifies the jobs associated with the IP group.
    Description
    Specifies the description of the IP group.
    State
    Specifies the state of the IP group.
    Created on
    Specifies the date that the IP group was created.
    Updated on
    Specifies the date that the IP group was last updated.
    Version
    Displays IPv4 or IPv6 as the version of the IP addresses specified when the IP group is added.
    Important: Workloads that require IP caching must be deployed to cloud groups with only IPv4 IP groups.
    Used For
    The IP group uses Data for user access to virtual machines.
    Subnet address
    Enter a valid subnet address. This subnet address is associated with the IP group represented as a string in dotted decimal notation, for example: 192.168.98.0.
    Network address
    This address is associated with the IP group represented as a string in dotted decimal notation, for example: 192.168.98.0 for IPv4 or 2001:218:420::/64 for IPv6.
    Netmask
    Important: This field applies only to IPv4.
    This network mask is associated with the network address of the IP group that is represented as a string in dotted decimal notation, for example: 255.255.255.0.
    Gateway
    Specifies the gateway address for the IP addresses in the IP group. This information is required when you are creating an IP group.
    Primary DNS
    Specifies the primary Domain Name System (DNS) value for the IP group. This DNS server is used for the IP group represented as a string in dotted decimal notation, for example: 192.168.98.2.

    When you modify the Primary DNS value, new virtual machine deployment will use the new value. However, you must manually update the DNS value for any virtual machines that are already deployed.

    Important: If the IP addresses for the DNS servers are not set up correctly, the deployment can fail. The failure is caused by a failed connection between Secure Shell (SSH) and the virtual machine.
    Secondary DNS
    Specifies an additional optional secondary DNS value for the IP group. This secondary DNS server is used for the IP group represented as a string in dotted decimal notation, for example: 192.168.98.2.

    When you modify the Secondary DNS value, new virtual machine deployment will use the new value. However, you must manually update the DNS value for any virtual machines that are already deployed.

    VLAN
    Specifies the virtual local area network.
    In cloud group
    Specifies the cloud group for which the IP group is associated.

    The system includes three default cloud groups or you can create your own. You can select a cloud group from this drop down menu. You can leave this field blank if you have not created your cloud group yet. After you create the cloud group, edit this field with the new cloud group.

    IP addresses
    Provides a numerically sorted list of IP addresses that have been added to the IP group. Choose from the following actions:
    Remove
    Indicates any IP groups that are inactive and can be removed.
    Add by
    Use the two entry boxes and the Add link to add strings of IP addresses at a time. Entering the first IP address in the string in the first box and the final IP address in the second box adds all IP addresses, numerically, between the two addresses specified.
    You can add IP addresses as host names instead of the actual IP addresses. Select Host names in the Add by menu. When a host name is specified for an IP address, the host name resolves to the IP address. However, what is entered is what is stored. Therefore, if you enter the host name then the host name is stored and not the IP address to which it resolves. If any of the host names entered cannot be resolved to IP addresses, then a warning message is shown beside any entry that cannot be resolved. If a host name is resolved to an IP address but the IP address is not valid for the specified subnet, then an error message is shown and the host name is not added to the IP group.
    Routes
    Provides a list of IP routes that have been added to the IP group.
    Choose from the following actions to add or remove IP routes:
    Remove
    Add
    For an IP group with a Used for setting of Cloud management, you must define the following:
    • a subnet route via this IP group's gateway address to the system management subnet configured on the System > Network Configuration configuration page.
    • a subnet route via this IP group's gateway address to any other management IP group subnet that your deployments will span. For example, in a multisystem deployment, the cloud management IP groups on each system require a subnet route to each other.
    Additional route configuration is optional for IP groups with a Used for setting of Data. You can configure routes for data IP groups as a way of providing special routing for your virtual machines' add-on NICs.
    Access granted to

    Select user IDs from the Add more menu for those users who require access to the IP group.

    To view the users with admin access, click admin. To display all users, click all. To remove a user, click remove.