Using the command line interface to run operations on your appliance

You can run commands to restart the appliance hardware, reset the appliance to its original factory settings, or shut down the appliance.

About this task

You can use the command-line interface to reset the appliance configuration data, restart the appliance, or shut down the appliance.

Procedure

  1. Establish a connection with the appliance using the xcadmin user. You can use a serial connection or you can connect with the command-line interface using a Secure Shell (SSH).
    • Serial connection: The serial connection must be between an ASCII terminal or a PC running terminal emulation software to the serial port on the appliance. If you are using a PC for the serial console, you must use a PC-based serial communications program for Windows or Linux. Use either the supplied serial cable or PL-2303 USB-to-serial cable to make the connection to the appliance.
      Important: If you are using the PL-2303 USB-to-serial cable, download and install a driver for the cable before proceeding.
    • Remote login: To connect to the appliance with SSH, provide the URL of your appliance to your SSH client.
  2. After you have established a connection with the appliance, you can run commands.

    [Version 2.5 and later] For a reference of the commands that you can run, see CLI command reference.

What to do next

If you reset the appliance, you can reinitialize your appliance. For more information about configuring your appliance, see Initializing and configuring IBM WebSphere DataPower XC10 Appliance.