Secure Mobile Access 100 10.2 Administration Guide

Using the Command Line Interface

The Command Line Interface (CLI) is a text-only mechanism for interacting with a computer operating system or software by typing commands to complete specific tasks. It is a critical part of the deployment of the SMA 500v Virtual Appliance, where basic networking needs to be configured from the console.

While the SMA physical appliance products have a default IP address and network configuration that requires a client’s network settings to be reconfigured to connect, the network settings in an existing VMware virtual environment might conflict with the SMA appliance defaults. The CLI utility remedies this by allowing basic configuration of the network settings when deploying the Virtual Appliance.

The SonicWall Inc. Secure Mobile Access CLI allows configuration of only the X0 interface on SMA 200/400, SMA 210/410, SMA 500v for ESXi, SMA 500v for Hyper-V, SMA 500v for AWS, SMA 500v for KVM, and SMA 500v for Azure.

To use the CLI on a serial connection or in an SSH management session, you need to use a terminal emulation application (such as Tera Term) or an SSH Client application (such as PuTTY). You can find suitable, free terminal emulators on the Internet.

For the SMA physical appliances, console access is achieved by connecting a computer to the serial port. Use the following settings:

  • Baud: 115200
  • Data Bits: 8
  • Parity: None
  • Stop Bits: 1
  • No flow control

For the Virtual Appliance, the following login prompt is displayed after the firmware has fully booted:

In the following examples, user input is highlighted in bold to indicate text entered by the user.

To access the CLI, login as admin. The password is the same as the password for the admin account that is configured on the appliance. The default is password.

sslvpn login: admin
Password: password

If the incorrect password is entered, the login prompt is displayed again. If the correct password is entered, the CLI is launched.

For hardware and Virtual Appliances, basic system information and network settings are displayed along with the main menu, as in the following example:

You can press Ctrl-C at any time to log out and exit the CLI, returning to the login prompt.

The main menu has four selections:

  1. Setup Wizard – This option launches a simple wizard to change the basic network settings, starting with the X0 IP Address, X0 subnet mask, default gateway, primary and secondary DNS, and the hostname. The following CLI output illustrates an example where each field is changed:

    X0 IP Address (default 192.168.200.1): 192.168.200.201
    X0 Subnet Mask (default 255.255.255.0): 255.255.0.0
    Default Gateway (default 192.168.200.2): 192.168.200.1
    Primary DNS: 10.50.128.52
    Secondary DNS (optional, enter "none" to disable): 4.2.2.2
    Hostname (default sslvpn): sslvpn
    New Network Settings:
    X0 IP Address:	192.168.200.201
    X0 Subnet mask:	255.255.0.0
    Default Gateway:	192.168.200.1
    Primary DNS:	10.50.128.52
    Secondary DNS:	4.2.2.2
    Hostname:	sslvpn
    Would you like to save these changes (y/n)?

    If a field is not filled out, the prior value is retained, allowing you to change only a single field. After each field has been prompted, the new network settings are shown, and a confirmation message is given for the user to review and verify the changes before applying them. The following shows the result when you save the changes:

    Would you like to save these changes (y/n)? y
    Saving changes...please wait....
    Changes saved!
    Press <Enter> to continue...

    After saving the changes, press Enter to return to the original display of the System Information and Network Settings and verify that the changes have taken effect:

    If no changes are saved, the following message is displayed and pressing Enter returns to the initial display of the System Information and Network Settings:

    No changes have been made. 
    Press <Enter> to continue...

    When applying settings that change the IP address, there might be a delay of up to five seconds as the interface settings are updated.

  2. Reboot – Selecting this option displays a confirmation prompt and then reboots:

    Reboot
    Are you sure you want to reboot (y/n)?
  3. Restart SSL-VPN Services – This option displays a confirmation prompt and then restarts the Web server and the related Secure Mobile Access daemon services. This command is equivalent to issuing the EasyAccessCtrl restart command.

    Restart SSL-VPN Services
    Are you sure you want to restart the SSL-VPN services (y/n)? y
     
    Restarting SSL-VPN services...please wait. 
    Stopping SMM: [OK]
    Stopping Firebase :[OK] 
    Stopping FTP Session:[OK] 
    Stopping HTTPD: [OK] 
    Cleaning Apache State: [OK] 
    Stopping Graphd :[OK]
     
    Cleaning Temporary files........
    Starting SMM: [OK] 
    Starting firebase: [OK] 
    Starting httpd: [OK] 
    Starting ftpsession: [OK] 
    Starting graphd: [OK]
     
    Restart completed... returning to main menu...
  4. Logout – The logout option ends the CLI session and returns to the login prompt.

Was This Article Helpful?

Help us to improve our support portal

Techdocs Article Helpful form

Techdocs Article NOT Helpful form

  • Still can't find what you're looking for? Try our knowledge base or ask our community for more help.