Release Notes : Remote Installation: Upgrading from WANJet appliance version 5.0.1 to version 5.0.2

Applies To:

Show Versions Show Versions


  • 5.0.2
Release Notes
Updated Date: 04/18/2019


This installation note documents the process of upgrading to WANJet ® appliance version 5.0.2 from WANJet appliance version 5.0.1 using the remote upgrade procedure. For information about installing the software, please refer to the instructions below.


About the installation

This installation note describes how to remotely upgrade the WANJet appliance to version 5.0.2. If you do not have direct access to the system, you need to perform a remote upgrade. The remote upgrade provides the ability to serve the installation files from a different network using HTTP. We recommend using the local upgrade if you have a direct connection to the unit you want to upgrade.

Warning: You can apply this upgrade only to WANJet appliances running version 5.0.1 and having a Management IP address (rather than the Bridge IP address) configured for communication.

Warning: A valid service contract is required to complete this upgrade.

[ Top ]

Installing the software

If the WANJet appliance is currently running version 5.0.1, you can upgrade directly to version 5.0.2.

The process of upgrading to WANJet appliance version 5.0.2 remotely requires completing the following tasks:

The following sections describe how to perform these tasks.

[ Top ]

Saving and backing up existing configuration data

Before you upgrade to this version of the software, you need to save the current WANJet appliance configuration data. Backing up your configuration prevents loss of data if, for any reason, the upgrade is not successful.

Collect and archive the existing configuration files, by typing the following command. Note that to have the installer automatically load the configuration file during startup, you must name the file config.ucs and store it in the / partition.
bigpipe config save /config.ucs

Important: It is critical that you back up the archived configuration files to a secure remote location. In the event installation fails, you might need to use the remotely stored file in order to restore your previous configuration data. For more information about UCS archive files, see SOL4423: Overview of UCS archives.

[ Top ]

Downloading the installation CD-ROM ISO image from F5 Networks

After you save the existing configuration, download the installation CD-ROM ISO image from For details about downloading the ISO image, see SOL167: Downloading software from F5 Networks

Note: Before you continue, we recommend downloading the associated MD5 checksum file and performing the MD5 checksum operation to ensure that the file downloaded correctly. For more information about running the MD5 checksum, see Verifying the MD5 checksum of the installation file.

[ Top ]

Copying the remote upgrade package to the WANJet appliance from the CD-ROM

After you save the existing configuration and download the installation CD-ROM, you need to copy the file from the root of the CD-ROM to the /var/tmp directory on the WANJet appliance that you want to upgrade. The following example shows how you use the scp command to copy the file to a remote WANJet appliance, where <remote_upgrade>.im is the name of the remote upgrade IM you copied from the CD-ROM, and the <WANJetIP> is the IP address of the WANJet appliance to which you want to copy the IM file.

scp <remote_upgrade>.im root@<WANJetIP>:/var/tmp .

After you copy the remote upgrade IM file to the WANJet appliance you want to upgrade, use the CD-ROM to create an installation server (this process is described in the following section).

[ Top ]

Designating and configuring a remote host to be an installation server

Before you run the remote upgrade, you must designate and configure a remote host to be an installation server. The installation server must meet all the following criteria:

  • Contain a CD-ROM drive.
  • Support a CD-ROM boot.
  • Reside on the same network as the one to which the WANJet management interface is connected.

Note: You must connect the installation server to the same network to which the management port on the WANJet unit is connected.

Note: If you are installing the software on a WANJet 400 platform by directly connecting the unit to the installation server, you must use an Ethernet cross-over cable to directly connect to the management interface. If you are installing the software on a WANJet 300 or 500 platform by directly connecting to the installation server, you can use a standard Ethernet cable to directly connect to the management interface.

Once you have designated a host, complete the following steps.

To configure an installation server

  1. Insert the CD into the drive on the installation server and reboot the host system from the CD-ROM drive.
    The following message displays:
    Select terminal type? [vt100]
  2. Press the Enter key to use vt100 emulation, or type the name of the terminal emulator you are using.
    The system presents the Maintenance OS Options screen:

    Maintenance OS Options Serve Provide network installation services Install Install software onto hard disk Reboot Reboot to your current system Exit Exit to maintenance shell

  3. Select the default, Serve.
    The system presents a list of available network interfaces.
  4. Select one of the network interfaces for the installation server interface.
    After you select the interface you want to use as the installation server interface, the system presents the following prompt:
    Use existing DHCP server on subnet [no]?
  5. Indicate your DHCP choice:
    • If you want to use an existing DHCP server on your subnet, type yes.
      The server configuration automatically completes.
    • If you want to set up this server as the DHCP server, type no.
      The system presents the following series of prompts:

      IP network [10.1.10]? IP address of server 10.1.10[n] [199]? Lower range for clients 10.1.10.[n] [199]? Upper range for clients 10.1.10.[n] [200]?

      • If your subnet consists only of the server and the target WANJet unit, or is otherwise a private subnet, use the default IP addresses provided.
      • If other units share the subnet and there is a possibility of conflict, substitute the appropriate unique IP addresses and ranges. When you have finished entering the addresses, they are displayed and you are prompted to accept or reject them.

        Note: When you specify the IP address of the server, you need to enter only the last octet. When completing the lower and upper ranges for the clients, type the network numbers where the clients are situated.

    • If the settings displayed are correct, type yes. If they are not, type no to have the system prompt you to re-enter the addresses.
  6. Finally, the system prompts you to specify the protocol you want to use to transfer the installation files. The default protocol is HTTP; however, you can also transfer the files using NFS.
    Once you accept the settings, the server configuration is complete.
[ Top ]

Running the installation script

Now that you have copied the installation package to the target system and set up the installation server, you can install the version 5.0.2 software. On the WANJet appliance, use the im command to run the installation script. The im command extracts the script and begins the installation.

To install the software

  1. Navigate to the /var/tmp directory using the following command:
    cd /var/tmp
  2. To extract and run the remote-install script from the IM package and complete the installation, type the following command:
    The installation script prompts you for the following information:
    Terminal type? [vt100]
  3. Press the Enter key to continue, or specify the terminal type you are using. We recommend that you use vt100.
    The system posts a number of messages, and then installation starts. Once installation starts, you can use the arrow and Tab keys to navigate the presented options. You can select an option from a menu using the Enter key or the highlighted character key, and you can toggle select boxes on or off using the spacebar.
  4. Respond to the installation script prompts for the following information:
    1. Syslog server name: If you want a log of the installation process, specify a syslog server by typing the IP address of the syslog server you want to use. (Or, continue without typing an IP address if you do not want to specify a syslog server.)
      Note: The syslog option is not present when the controlling terminal is the console. You see this option only when you are performing the installation through an SSH connection.
    2. Installation server: Next, the system prompts you for an installation server URL or path. Type the URL of the installation server.
      The format for the URL is http://<installserver>/cdserver.
    3. Installation location: You are then prompted for the installation location, slot cf 1.1 or cf 1.2, on the CompactFlash. You can install the software in each location. At boot time, you can select which installation you want to boot.)
    4. Configuration files: Next, you have the option to roll forward any supported configurations (config.ucs files) found on the system. You should have already saved a UCS in the procedure Saving and backing up existing configuration data.
  5. After responding to each prompt, review the installation options you have selected. Select Yes on the final WANJet appliance installation screen to begin installing.

After the installation is complete, the WANJet appliance reboots and you can log on, as described in Getting Started.

[ Top ]

Contacting F5 Networks

  Phone: (206) 272-6888
Fax: (206) 272-6802

For additional information, please visit