How to: Configure Static IP Address Manually

     

    Summary

    Setting a static IP address can be a convenient way to access your VIRL server but may also be a necessary step in your deployment. Unfortunately, the VIRL server is a little bit picky on how it wants you to apply a static IP. This guide is meant to assist with this process and is not meant to replace the installation instructions. For the full installation instructions go to Installing VIRL and choose your deployment type. This guide does NOT cover bare-metal installations where 'dummy' interfaces would need to be configured.

     

    Getting Started

    Please make sure to follow appropriate section. If your VIRL server does not have internet access or is not able to reach Cisco license (Salt) servers, STOP and do not continue. You must resolve internet and license connectivity prior to making system configuration changes. If you choose to continue, it is likely that your static IP address and some of the required services will fail.

     

    If Your VIRL Server has...

     

    DHCP Address and is Licensed

    The recommended method of updating your VIRL server system settings is via UWM web interface. Because of the different background services running on your VIRL server, making configuration edits via CLI will not have the desired effect. Even if your server continues to function as expected after changes were made, a system update or reboot can render your VIRL server useless.

     

    Set Static IP Address via UWM

    When making changes to networks or network related information, including hostname and port numbers, a 'rehost' operation will be required. This process can take up to 20 minutes to complete. Be patient and wait for process to finish and reboot your server when prompted.

    • Log into your VIRL server
      Username: uwmadmin
      Password: password
    • Navigate to VIRL Server > Salt Configuration and Status
    • Navigate to System Configuration
      • Remove tick from Use DHCP on Primary Ethernet Port
      • Set IP address information as required
      • IMPORTANT: do not duplicate DNS server entries, each server must be unique
      • Apply Settings and follow prompts
      • Reboot server when prompted

     


    No DHCP Address and is Un-Licensed (VIRL 1.3 and later)

    Set Static Network Information for Internet Access

    This method is only available on VIRL 1.3 and later.

    From console:

    • Log into your VIRL server
      Username: virl
      Password: VIRL
    • Open VIRL Configurator with the following command
      virl_setup
      Use the cursor keys to navigate or press the corresponding Red character on your keyboard for faster navigation.
    • Select option 1 from Main Menu; "Network Configuration" and press enter
    • Select option 3 from Network Configuration; "Configure Static IP address on Primary Interface" and press enter
    • Update interface settings as needed. All fields are required.
    • Once complete, navigate to your server's IP address using a browser to complete deployment.


    Next - Apply License.

     

    Apply License

    Follow the steps outlined in T-Shoot: "Failed to collect current salt contact status" to ensure your license has been correctly applied and it has been registered.


    IMPORTANT: do not continue if you are not able to successfully apply your license key.

     


     

    No DHCP Address and is Un-Licensed (VIRL 1.2 and older)

    Set Static Network Information

    This section assumes all changes are being made from the VIRL server desktop.

    • Log into your VIRL server
      Username:  virl
      Password:  VIRL
    • Double click xterm (terminal) icon on desktop

    • Type the following command
          gksudo gedit /etc/network/interfaces

    • Apply IP address to section for eth0 as shown: (enter desired IP address and network information)
      Do Not change the layout or syntax

    auto eth0

    iface eth0 inet static

        address a.a.a.a

        netmask m.m.m.m

        gateway g.g.g.g

        dns-nameservers s.s.s.s n.n.n.n

        up ip address add 172.16.10.250/24 dev eth0

     

    • Make changes, save and close gedit
    • Next, open and edit  virl.ini  to reflect your static IP address
          gksudo gedit /etc/virl.ini
    • Locate line  _dhcp_on_public_port: change True to False(use ctl+f to search file)
    • Do NOT change hostname if you are still trying to deploy your server for the first time
    • Scroll down to section titled  If not DHCP what is the static IP...
    • Remove the  ##  from ONLY the lines shown below and enter appropriate network information. Make sure it matches what you entered in /etc/network/interfaces

    ##If not DHCP what is the static IP address in use on public port?

    ## Defaults

    Static_IP: a.a.a.a

    public_network: n.n.n.n

    public_netmask: m.m.m.m

    public_gateway: g.g.g.g

     

    • (optional) Locate  _nameserver  set the first and second nameserver (DNS) as needed (DO NOT specify the same server twice)
    • Save and close gedit
    • Reboot your server
          sudo reboot now

     

    Next - Verify Internet Access

     

    Verify Internet Access

    After reboot, open a web browser and connect to your VIRL server via your new static IP address. Be patient as UWM may not be immediately available. It can take up to 3 minutes for UWM to respond and allow log in.

     

    Next - Apply License.

     

    Apply License

    Follow the steps outlined in T-Shoot: "Failed to collect current salt contact status" to ensure your license has been correctly applied and it has been registered.

    IMPORTANT: do not continue if you are not able to successfully apply your license key.

     

    Next - Finalize Settings

     

    Finalize settings - Update Openstack

    If you need to make changes to other system networks (Flat, Flat1, SNAT) or hostname you may do so now via UWM. It is important that any changes made at this time include vinstall rehost under Changes Impact section when applying the new settings. If  vinstall rehost  command is NOT present, discard changes and proceed to Finalize Settings via CLI.

     

    Finalize Settings via CLI

    Connect to your VIRL server via SSH or open a terminal on VIRL server desktop via graphical console

    • Log into your VIRL server
      Username: virl
      Password: VIRL
    • Be patient when running the following commands. Rehost may take about 20 minutes to complete depending on your system resources
          vinstall rehost
          sudo reboot now