Default language.

Important This documentation space contains information about the on-premises version of BMC Helix Discovery. If you are using the SaaS version of BMC Helix Discovery, see BMC Helix Discovery (SaaS).

The netadmin user


The netadmin user account is a special account with limited privileges. It enables you to change network, hostname and gateway settings, and to reboot the appliance.

You can no longer remotely log in using the netadmin user. Rather, you should log in as the root user and use the netadmin account as described in the following section.

To use the netadmin account, enter the following as the root user:

su - netadmin

You see the following text based interface:

[root@upgrade ~]# su - netadmin

BMC Discovery Appliance Network Administration Shell
----------------------------------------------------

  G  Configure General Settings
  I  Configure Network Interfaces
  P  Change netadmin password
  R  Exit & Reboot the appliance
  Q  Exit *without* rebooting

Select option:

Select an option by entering the code letter:

  • Enter G to configure the appliance hostname.
  • Enter I to configure the appliance network interfaces.
  • Enter P to change the netadmin user password,
  • Enter R to exit the netadmin session and reboot the appliance.
  • Enter Q to exit the netadmin session without rebooting the appliance.

If you make any configuration changes from the General Settings or Network Interfaces menu, you must reboot the appliance for the changes to take effect.

The following tables describe the items in the General Settings and Network Interface menus:

G - General Settings menu 


Key

Label

Description

H

Change Hostname: current.hostname

Enter H to set the hostname. At the Hostname or FQDN: prompt, enter the new hostname or an FQDN to use as the hostname. Press enter to return to the General Settings menu.


D

Discard changes

Discard any changes and remain in the General Settings menu. Requires confirmation.

C

Commit changes

Commit any changes and remain in the General Settings menu. Requires confirmation.

Q

Return to the main menu

Discard any unsaved changes and return to the main menu. Requires confirmation.



I - Network Interfaces menu

Key

Label

Description

1

Reconfigure ens160: DHCP ONBOOT=Yes current.configuration

Enter 1 to reconfigure ens160.

To use DHCP:

  1. At the Use DHCP prompt, enter Y to use DHCP.
  2. At the Enable on boot prompt, enter Y to enable the interface when the appliance boots.
  3. DHCP configuration is complete.

To use a static IP address: 

  1. At the Use DHCP prompt, enter N to use a static IP address.
    1. Enter the IPv4 address.
    2. Enter the Netmask.
    3. Enter the IPv4 gateway address.
    4. Enter the gateway IP address.
  2. At the Configure IPv6 prompt, enter Y or N, depending on whether you want to configure IPv6. If Y:
    1. Enter the IPv6 address.
    2. Enter the IPv6 prefix.
    3. Enter the IPv6 gateway gateway address.
  3. At the Enable on boot prompt, enter Y to enable the interface when the appliance boots.

You cannot manually set a gateway using netadmin if you have DHCP enabled.

Note: If you change the appliance's IP address, you will also need to update proxy configurations (known appliance in the proxy manager), and for consolidation, you must delete and re-create the existing connections.

A

Add interface

Enter A to add a new interface

To add an interface using DHCP.

  1. At the Device: prompt, enter the new device name. For example, ens1.
  2. At the Use DHCP prompt, enter Y to use DHCP.
  3. At the Enable on boot prompt, enter Y to enable DHCP when the appliance boots.
  4. DHCP configuration is complete.

To add an interface using a static IP address:

  1. At the Use DHCP prompt, enter N to use a static IP address.
    1. Enter the IPv4 address.
    2. Enter the Netmask.
    3. Enter the IPv4 gateway address.
    4. Enter the gateway IP address.
  2. At the Configure IPv6 prompt, enter Y or N, depending on whether you want to configure IPv6. If Y:
    1. Enter the IPv6 address.
    2. Enter the IPv6 prefix.
    3. Enter the IPv6 gateway gateway address.
  3. At the Enable on boot prompt, enter Y to enable the static IP address when the appliance boots.

You cannot manually set a gateway using netadmin if you have DHCP enabled.

R

Remove/Restore Network Interfaces

Enter R to list configured network interfaces. To remove or restore a listed interface, enter the menu number corresponding to the interface. A [DELETED] flag marks removed interfaces.

D

Discard changes

Discard any changes and remain in the Network Interfaces menu. Requires confirmation.

C

Commit changes

Commit any changes and remain in the Network Interfaces menu. Requires confirmation.

Q

Return to the main menu

Discard any unsaved changes and return to the main menu. Requires confirmation.

P - Change netadmin password

[root@appliance01 tideway]# su - netadmin
BMC Discovery Appliance Network Administration Shell
----------------------------------------------------
  G  Configure General Settings
  I  Configure Network Interfaces
  P  Change netadmin password
  R  Exit & Reboot the appliance
  Q  Exit *without* rebooting
Select option: p
Changing password for user netadmin.
New password:
Retype new password:
passwd: all authentication tokens updated successfully.
BMC Discovery Appliance Network Administration Shell
----------------------------------------------------
  G  Configure General Settings
  I  Configure Network Interfaces
  P  Change netadmin password
  R  Exit & Reboot the appliance
  Q  Exit *without* rebooting
Select option: q
[root@appliance01 tideway]#

R - Reboot the appliance

Enter R to reboot the appliance. This operation requires confirmation, after which your session ends and the appliance reboots.

Q - Quit

Enter Q to quit the netadmin session.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*