Template:Deprecated Page - Command Line Menu

The Valt command line menu is an easy to use interface for configuring and managing many of the system level components of your Valt appliance or Valt virtual appliance.

The terminal window will automatically boot up to the command line menu. If you access the terminal and are presented with a shell prompt, type exit and press enter. You should be returned to the command line menu.

If accessing the appliance via SSH, you can start the command line menu by executing the following command:

sudo /usr/local/valt/bin/Menu

Note: The Valt command line menu is designed for use in configuration of the Valt appliance. If you perform any configuration outside the menu (such as setting an ip address), the menu may cease to function properly.

The menu map below details all of the options in the command line menu. Click on a section of the menu for more detailed information regarding that option.

Main Menu

The main menu displays the current IP configuration and serves as a central navigation point for the command line menu.

Network Configuration

The network menu contains all options related to network configuration. From this menu you can display the current network configuration, set IP addresses, as well as configure VLANs and NIC teaming.

Display Network Boot Settings

This menu option will display the current boot configuration. This configuration may or may not be currently active. This configuration will become active the next time the Valt appliance is rebooted. Additionally, this options displays the current client access IP address. Each Valt implementation can only have a single client access IP address. This is the ip address that you will navigate to in a web browser to access the Valt application.

Set IPs

This menu option will allow you to configure a static IP address or configure an interface for DHCP.

• Select your interface from the options listed.

  Note: If you want to configure a teamed interface or a vlan, you must first configure vlans or teaming, then these interfaces will be displayed as options to set an IP address on.

  

• Select Static or DHCP.

Static

File:Menu5.png

1. Enter an IP address for the interface in the format ###.###.###.###

   

2. Enter a subnet mask for the interface in the format ###.###.###.###

   ]

3. You will be asked if you want to enter a gateway, enter y or n.

   Note: You should only enter a gateway for one interface. Defining more than one gateway may cause communications problems. Additionally, you do not need to define a gateway if the appliance does not need to communicate with devices (clients, cameras, internet access, etc) on another subnet.

   

4. If you answered yes, enter the gateway address for the interface in the format ###.###.###.###

   

5. You will be asked if you want to enter dns servers, enter y or n.

   Note: You only need to enter DNS servers on one interface. Entering DNS servers on multiple interfaces will not cause any problems, but it also will not provide any benefit. Additionally you do not need to provide DNS servers on any interface if the appliance will not have any internet access.

   

6. If you answered yes, enter two dns servers.

   If additional DNS servers are required, please contact Valt technical support

   

7. Review the information you entered carefully. If everything is correct, enter y to continue. Otherwise enter n and you will be prompted to enter the configuration again.

   

8. You will be asked if this interface will be utilized for client access, enter either Y or N.

   Each Valt appliance must have one and only one interface designated for clients to access the appliance. The IP address of this interface is the address you will type into your web browser to access the Valt application. By designating an interface for client access, the menu will automatically configure the Valt software to listen on the IP address assigned to that interface. The changes will not take effect until the Valt appliance has been rebooted.

DHCP

If you want to utilize DHCP to configure the IP address of the Valt appliance, you must set a DHCP reservation for the server.

1. After selecting DHCP, you will be asked if this interface will be utilized for client access, enter either Y or N.

   Each Valt appliance must have one and only one interface designated for clients to access the appliance. The IP address of this interface is the address you will type into your web browser to access the Valt application. By designating an interface for client access, the menu will automatically configure the Valt software to listen on the IP address assigned to that interface. The changes will not take effect until the Valt appliance has been rebooted.

   

2. Enter the IP Address of the interface when prompted.

   If you have opted to configure the Valt appliance via DHCP, you will need to provide the IP address that has been reserved for the appliance. That IP address is utilized by the Valt software to listen for client access.

IP Address changes will not take effect until the server has been rebooted.

Configure Teaming

The teaming menu is used to team or bond together multiple network interfaces. In order to create a team, you must have at least two network interfaces. Additionally these interfaces must not have any vlans active. If you want to utilize vlans on a teamed interface, first create the team and then add a vlan to the teamed interface.

Display Current Teaming Status

This menu option will display current teaming status. If there is currently a team created, the members will be listed.

Create a new Team

Select this menu option to create a new team. Valt currently only supports one team. This is typically sufficient as Valt physical appliances ship with two network interfaces. If you require more than one team, please contact Valt technical support for assistance.

1. Select the first interface to include in the team from the menu. This will be the primary interface in an active-standby configuration.

   

2. Select the second interface to include in the team from the menu. This will be the secondary interface in an active-standby configuration. Notice the first interface no longer appears as an option.

   

3. Select a teaming mode from the available options.
   • balance-rr

     This mode utilizes both NIC simultaneously for additional throughput. The NICs must be connected to the same switch and it must be configured for teaming.

   • active-backup

     This mode utilizes only one NIC at a time. The other NIC only becomes active if the primary NIC fails. This does not require any switch configuration and the NICs can each be connected to separate switches for redundancy.

The team will now be created as interface bond0. This interface will be set to DHCP by default and will become active on the next reboot. Make sure to configure the IP address on bond0 prior to rebooting.

Delete Existing Team

Select this menu option to disable teaming. If you have teaming active, this must be done before you can add a vlan or assign an IP address to one of the teamed NICs.

Configure VLANs

The VLAN menu is used to create VLANs on an interface. VLANs can only be added to unteamed interfaces. You can add a vlan to a team, but not to the individual interfaces included in the team. If you need to add a VLAN to a teamed interface, you must first break the team.

Display Current VLANS

This menu option will display all VLANs currently configured.

Create new VLAN

This menu option will allow you to create additional VLANs.

1. Select an interface from the list provided.

   

2. Enter a VLAN ID

   

3. The vlan will now be created on that interface and will now be available to assign an IP address.

Delete Existing VLAN

This menu option will allow you to delete existing VLANs. Before an interface can be assigned to a team, you must first delete all VLANs associated with it.

SSL

The SSL menu is used for generating Certificate Signing Requests or installing certificates.

Generate CSR

This menu option will allow you to generate a CSR to be signed by an internal or external Certificate Authority.

1. Enter a name for the private key file.

   

2. Enter a name for the CSR.

   

3. Enter your two letter country code.

   

4. Enter your state or province name.

   

5. Enter your locality name.

   

6. Enter your organization name.

   

7. Enter your organizational unit name.

   

8. Enter the fully qualified domain name of your Valt appliance.

   Note: This MUST match the dns entry for your Valt appliance or when clients connect they will receive a certificate warning.

   

9. Enter your email address.

   

10. When prompted to enter a challenge password, just hit enter.

    

11. When prompted to enter an optional company name, just hit enter.

    

12. The location of your private key, public key, and CSR will be displayed. Make a note of these locations.
13. Retrieve the public key and CSR from the Valt appliance by connecting to it via sftp. Provide the CSR to your cerfiticate authority, they may also request the public key. Once they have processed the request, your CA should provide you with a certificate.

Enable SSL

This menu option will enable SSL. You can choose to install either a self signed certificate or install a certificate signed by a CA.

Installing a self signed certificate is no less secure than using a CA, however a self signed certificate will cause a warning message in most browsers, whereas a certificate signed by a trust CA will not.

Install Self Signed Certificate

1. 

2. Enter your two letter country code.

   

3. Enter your state or province name.

   

4. Enter your locality name.

   

5. Enter your organization name.

   

6. Enter your organizational unit name.

   

7. Enter the fully qualified domain name of your Valt appliance.

   Note: This MUST match the dns entry for your Valt appliance or when clients connect they will receive a certificate warning.

   

8. Enter your email address.
9. The system will now generate an install a self signed certificate.

Install SSL Certificate signed by a CA

1. Upload the new certificate file to the Valt appliance prior to selecting this menu option.

   

2. Enter the path to the private key file.

   You should have noted this path when you generated the CSR

   

3. Enter the path to the SSL Certificate.

   This should be the location and file name where you uploaded the certificate to the Valt appliance.

   

4. Enter the path to the intermediate certificate.

   This should have been provided by your CA. If they did not provide it, just enter the path to the SSL certificate again. If they did not provide a intermediate certificate, you may receive a warning when accessing the Valt application from some browsers.

5. The certificate will now be installed.

Disable SSL

This menu option will disable SSL. This must be done prior to installing a new certificate.