Applies To:

Show Versions Show Versions

Release Note: 520/540 Platform: Installing BIG-IP version 9.2.2
Release Note

Updated Date: 07/12/2006


This technical note documents how to perform an upgrade install on a 520/540 (D35) platform of the BIG-IP software version 9.2.2 using a CD mounted on an installation server. For information about installing the software, please refer to the instructions below.


- Minimum system requirements and supported browsers
- About the BIG-IP version 9.2.2 installation for the 520/540 platforms
- Installing the software

Minimum system requirements and supported browsers

The minimum system requirements for this release are:

  • Intel® Pentium® III 933Mhz processor
  • Hard drive
  • Minimum 512MB RAM
  • Recommended 1GB RAM

The supported browsers for the Configuration utility are:

  • Microsoft® Internet Explorer TM, version 6.x and later
  • Netscape® Navigator TM, version 7.1, and other browsers built on the same engine, such as Mozilla TM, Firefox TM, and Camino TM.
[ Top ]

About the BIG-IP version 9.2.2 installation for the 520/540 platforms

This technical note describes how to upgrade version 4.5.x or 4.6.x software to version 9.2.2 on the 520/540 platform. The 520/540 platforms are not switch-based platforms. Some BIG-IP features and requirements are slightly different, or are not supported, on the 520/540 platforms. The following section describes these differences.

Interface support

When you install BIG-IP version 9.2.2 on a 520/540 platform, the interface 1.1 is converted to the management interface. The interface 1.2 becomes interface 1.1. Other additional interfaces will be numbered as they were in version 4.5.x or 4.6.x. See OTCU section for other details on the numbering changes. The minimal configuration is two built-in interfaces, however, we recommend that you add network interface card (NIC) to bring to the total number of interfaces to at least three.

Memory support

The minimum memory supported is 512MB. Most 520 platforms shipped with only 256MB of RAM. The recommended amount of RAM is 1GB. To avoid complications stemming from combining dissimilar brands of DIMMs, if you upgrade the memory on a unit, we recommend that you discard the old DIMMs and replace them with a single 512MB or 1024MB DIMM.

BIG-IP Link Controller and BIG-IP GTM/LTM combination installations require a minimum of 768MB of memory. However, the recommended amount of RAM is 1GB.

LED indicator behavior

The front panel LED behavior is the same as version 9.x behavior. For more information, see SOL4263: Change in behavior: Front panel indicator usage in BIG-IP version 9.

VGA and serial console behavior

The VGA and serial console behave as described after you install BIG-IP version 9.2.2.

  • You can install from the console or VGA
  • The system boot up messages go to the console and not the VGA.
  • On halt, the halt messages go only to the console.

NIC support

For details about obtaining supported network interface cards, contact F5 Networks .

Unsupported features in the this release

Some switch-based BIG-IP features are not supported on the 520/540 platforms. This section describes these features and their behavior.

Add-in hardware accelerator PCI cards

The following add-in hardware cards are not supported in this release on the 520/540 platforms:

  • Rainbow SSL PCI cards
  • nCipher FIPs cards

Switch port protocol support

LACP and STP are not supported on the 520/540 platform. LACP switchboard failsafe is not active on these platforms. The HA Table displays the switchboard failsafe entry as disabled. LACP is enforced when the user attempts to set lacp_enable 'true' on a trunk.

STP is enforced by the global stp mode setting. The allowed modes are passthru and disabled. Note you can view and modify the other stp related parameters without affecting the system operation. These commands include the bigpipe stp commands, bigpipe stp instance commands, and bigpipe interface stp, bigpipe auto edge, and the link type commands.

bigpipe commands

Most of the bigipipe commands are supported fully by the 520/540 platform, with the following exceptions:

Command Result
daemon Displays the bcm56xxd. Not functional.
db boot.netreboot Cannot enable. Not functional.
ha table Displays switchboard failsafe as disabled. Not functional.
interface [stp | auto edge | link type ] Can be configured. Has no effect.
interface pause Not supported
mirror Port mirror not supported and gives an error when configured.
stp Cannot set mode. Not functional.
stp instance Can be configured. Not functional.
trunk Cannot enable lacp.

Boot support

Quiet boot is supported. You can set this variable using the bigdb boot.quiet setting. The D35 Tyan 2515 motherboard does not support a CMOS setting for quiet boot, so user must use the BIOS setup utility to configure the BIOS quiet boot setting. (same as 4.5.x or 4.6.x).

The bigpipe command netboot enable | disable is not supported on the 520/540 platform. You must use the front panel Netboot button.

Port mirroring

As in BIG-IP version 4.5.x or 4.6.x, you cannot configure port mirroring on the 520/540 platform.

Baud rate support

You can use the command bigpipe baud rate to modify the current serial console (ttyS0), and the grub baud rate setting. This baud rate is maintained across reboots and power cycles. However, the Tyan 251x BIOS does not support a CMOS setting for baud rate. As a result, for the PXE installation, you must use the BIOS baud rate setting (default 19200) for the serial console.

Chassis sensor support

The sensor support for chassis fan, chassis power supply, chassis temperature, and cpu status is not be supported.

[ Top ]

Installing the software

Use these procedures to install the version 9.2.2 software.

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

Warning:  You must reactivate the license on the BIG-IP system on which you intend to install before you begin the installation.

The process of installing the BIG-IP version 9.2.2 software requires:

The following sections describe how to perform these tasks.

[ Top ]

Saving and backing up existing 4.5.x or 4.6.x BIG-IP configuration data

Before you upgrade to BIG-IP version 9.2.2, you need to save your version 4.5.x or 4.6.x configuration data. This file is used by the OTCU to convert your 4.5.x or 4.6.x configuration files to the 9.2.2 configuration file format. In addition, this prevents loss of data if, for any reason, the version 9.2.2 upgrade is not successful.

Collect and archive the version 4.5.x or 4.6.x configuration files, by typing the following command. Note that config.ucs is the name you must use for the UCS file, and the file must be saved at the / partition.
bigpipe config save /config.ucs

Important: If you are upgrading a system that is using zone files with named, you must manually back up all necessary zone files and save them to a remote location. After the upgrade is complete, you can place them on the 9.0 system. There is a new location on the 9.x system for these files: /var/named/config/namedb.

Important:  It is critical that you back up the archived configuration files to a remote location. If the upgrade process fails for any reason, you may need to use the remotely-stored file in order to restore your 4.5.x or 4.6.x configuration data.

[ Top ]

Download the installation CD-ROM ISO image from F5 Networks

Before you begin the installation process, you may need to download the installation CD-ROM ISO image from For details about downloading the ISO image, see SOL167: Downloading software from F5 Networks.

[ Top ]

Designating and configuring a remote host to be a Pre-boot Execution Environment (PXE) server

Before you perform a network boot from a CD, you must designate and configure a remote host to be a Pre-boot Execution Environment (PXE) server. This remote host 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 BIG-IP system is connected.

Note:  You must connect the installation server to the same network to which the BIG-IP unit is connected.

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

  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]

    Press Enter to use vt100 emulation, or type the name of the terminal emulator you are using.

  2. After you select the terminal type, the following screen opens:
    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.
    A list of available network interfaces displays.
    Select one for the installation server interface.

  4. After you select the interface you want to use as the installation server interface, the following prompt displays:
    Use existing DHCP server on subnet [no]? 
  5. Indicate your DHCP choice:
    • If there is an existing DHCP server on your subnet that you want to use, type yes.
      The server configuration automatically completes.

      If you choose this option, skip the rest of this procedure and go directly to Boot the target hardware from the remote installation server.

    • If you want to set up this server as the DHCP server, type no.
      The following series of prompts displays:
      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 BIG-IP unit, or is otherwise a private subnet, use the default IP addresses provided.

        If other machines 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 enter the IP address of the server, you need to enter only the last octet. When completing the lower and upper ranges for the clients, enter the network number(s) where the clients are situated.

      • If the settings displayed are correct, type yes. If they are not, type no and you are prompted to re-enter the addresses.
  6. Finally, you are prompted 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 ]

Booting the target hardware from the remote installation server

After you designate and configure a remote host to be a installation server, you are ready to perform the network boot from the console of the platform on which you wish to install the software.

Note:  You must connect the installation server directly to the management port on the BIG-IP unit, or to the network to which the management interface is connected.

  1. First, net boot the unit.

    If the machine is powered down, power it up, and within the first ten seconds use a paperclip to push the NETboot button on the front panel of the IP Application Switch.

    If the machine is started and running, type the following two commands in sequence:

    bigpipe db boot.netreboot enable
    You may receive the following message after you type the reboot command:
    The requested operation is not supported by the hardware.
    If you see this error message, use a paperclip to push the RESET button on the front panel of the IP Application Switch. Then, within ten seconds, use a paperclip to push the NETboot button.
  2. After the system reboots, it attempts to discover the installation server.

    Once the installation server is found, the system presents the following prompt:
    Press M or Control-SPACE to view menu.
    Let the timer count down to auto-select the installation options. After the timer counts down, the installer presents the terminal type.
    Terminal type? [vt100]
    Press Enter to continue, or type the terminal type you are using. We recommend that you use vt100.

  3. A number of messages scroll by and then the install script starts. Once the install script starts, you can use the arrow and Tab keys to navigate the options. You can use the Enter key or highlighted letter key to select an option from a menu, or the Spacebar to toggle select boxes on or off.

  4. The install script prompts you for the following information.

    • You can specify a syslog server if you want a log of the install process. Type 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.

    • After the syslog screen, you are prompted for an installation server URL or path.
      The installation script provides the information about the installation server you created. We recommend you choose the installation server found by the installation script. The format for the URL is: http://<installserver>/cdserver or nfs://<installserver>/cdserver

    • After you choose the installation server found by the installation script, you are then prompted for the slot on which you want to install the software. A slot is a portion of a drive with adequate space required for an installation. If the hardware supports multiple slots, you can create more than one installation by installing the software on each slot. At boot time, you can select the installation that you want to boot. To install on multiple slots, follow the on-screen instructions.

    • You then have the option to roll forward the supported configurations (config.ucs files) found on the system.

    • After you have completed the prompts for the installer, review the install options you have selected.

  5. To transfer the files and begin the installation, press Enter.

    The software takes only a few minutes to install. Once the installation is complete, the unit reboots to the installation in slot 0 or CF (compact flash). You can use the switchboot utility to specify which installation you want to boot by default. For more information about the switchboot utility, see the BIG-IP version 9.2.2 release notes.

[ Top ]

Adding an IP address to the management interface using the config command

After you complete the installation of the software, and before you license the software, run the config command to configure an IP address, net mask, and gateway on the management port (MGMT). The config command is a command line utility created for this purpose. You can run the config command from the serial console you used during installation.

To run the config command, type the following command:


After you run this utility and add an IP address, net mask, and gateway to your management port, you can log in to the Configuration utility (graphical user interface), and license the unit.

[ Top ]

Licensing the traffic management software using the Configuration utility

Before you can convert your configuration files or configure the system, you must license the version 9.2.2 software. To activate the license for the system, you must have a base registration key. The registration key is a 27-character string that lets the license server know which F5 products you are entitled to license. If you do not already have a registration key, you can obtain one using the dossier from a licensed 4.5x system (

To activate the license using the Configuration utility

  1. Open a web browser on a work station attached to the network on which you configured the management port. If you have not configured this IP address, see Adding an IP address to the management interface using the config command.

  2. Type the following URL in the browser, where <IP address> is the address you configured for the management port (MGMT):
    https://<IP address>/

  3. At the password prompt, type the default user name admin and the default password admin, and click OK.
    The Licensing screen of the Configuration utility opens.

  4. To begin the licensing process, click the Activate button. Follow the on-screen prompts to license the system. For additional information, click the Help tab.

  5. Once you have activated the license, STOP.
    DO NOT continue with the Setup utility if you want to use the One Time Conversion Utility (OTCU) to convert your 4.5.x or 4.6.x configuration files. For more information see Converting the configuration data using the OTCU.
[ Top ]

Converting the configuration data using the OTCU

After you install and license the 9.2.2 software, you can configure the 9.2.2 system from scratch, or you can convert the existing configuration you rolled forward on the system. If you want to configure the new software from scratch, you can skip converting the configuration using the OTCU. This section describes how the OTCU works.

To convert your existing 4.5.x or 4.6.x configuration files to 9.2.2 configuration files, you use the One Time Conversion Utility (OTCU). The OTCU parses 4.5.x or 4.6.x configuration files and uses the data to create a 9.2.2 configuration database. Due to the complexity of the 9.2.2 release, and differences in the 4.5.x or 4.6.x and 9.2.2 feature sets (which depend on your configuration), the OTCU may produce some unexpected results. We ask that you use the OTCU as a starting point for converting your 4.5.x or 4.6.x configuration files. Keep in mind that, in most cases, you will need to examine the resulting configuration files, troubleshoot the contents, and make adjustments where necessary. To view an example of a converted file, see conversion example . The following notes are to help you understand the conversion process and interpret the output of the OTCU.

When you run the OTCU, the files in /otcu.ucs are untarred and placed in /var/tmp/otcu_4.5. These files remain in their original state. They are not altered during the conversion process. Selected files used for the upgrade are moved into /var/tmp/otcu_9.0. For example, /etc/hosts is moved to /var/tmp/otcu_9.2.2/etc/hosts . After the files are moved, they are converted as much as possible into the version 9.x format and then placed in the version 9.0 system. After the conversion is complete, the /otcu.ucs is renamed to /renamed_otcu.ucs. Renaming the file prevents you from being prompted to run the OTCU every time you start the system.

During this process a log file is created and saved as /var/tmp/otcu.log. This file contains everything printed on screen during the installation. This information is useful for understanding what files are converted, and for reviewing or troubleshooting the resulting configuration. The files in /var/tmp/otcu_9.2.2 remain in the state they were in before being moved to the version 9.x system. If you want to refer to your 4.5.x or 4.6.x configuration files, these files are saved in /var/tmp/otcu_4.5. The /var/tmp/otcu_4.5_miscellaneous directory may contain some 4.5.x or 4.6.x files that are not carried forward during the conversion that may be of interest to you. This could include the 4.5.x or 4.6.x license file, inetd.conf file, openssl.conf file, or monitor files that were not converted. You can also find these with the rest of the files located in /var/tmp/otcu_4.5, however they are moved here for convenience.

Warning:  You should run the OTCU only one time. If you need to run the OTCU again, we recommend that you reinstall version 9.2.2 and then run the OTCU.

The following 4.5.x or 4.6.x files are removed during the conversion:

/config/default_base.conf (no user alert)
/etc/ssh_host_key (no user alert)
/etc/ (no user alert)
/etc/ssh_config (no user alert)
/etc/sshd_config (no user alert)
/etc/ssh3/hostkey (no user alert)
/etc/ssh3/ (no user alert)
/etc/ssh3/ssh3_config (no user alert)
/etc/ssh3/sshd2_config (no user alert)
/etc/snmptrap.conf (no user alert)
/etc/rc.local (no user alert)
/etc/syslog.conf (no user alert)
/etc/login.conf (no user alert)
/usr/local/www/bigipgui/.users (no user alert)
/config/bigconfig/slapd.txt (no user alert)
/etc/irs.conf, /etc/irs.conf.dns, /etc/irs.conf.nodns (no user alert)

The following 4.5.x or 4.6.x files are moved forward with no conversion:

/root/.ssh/ (no user alert)
/root/.ssh/id_dsa (no user alert)
/root/.ssh/ (no user alert)
/root/.ssh/identify (no user alert)
/root/.ssh/authorized_keys (no user alert)
/root/.ssh/authorized_keys2 (no user alert)
/root/.ssh/known_hosts (no user alert)

The following table lists the files that are moved and converted during the OTCU process.

4.5.x or 4.6.x config files 9.2.2 conversion notes
/config/routes Routes commands are converted to 9.2.2 bigpipe commands.
/config/bigconf/httpd.conf The ServerName line from this file is inserted into the new httpd.conf located at /config/httpd/conf/httpd.conf.
/config/bigconfig/ssl.crl/ is moved to /config/httpd/conf/ssl.crl.
/config/bigconfig/ssl.crt/ is moved to /config/httpd/conf/ssl.crt.
/config/bigconfig/ssl.key is moved to /config/httpd/conf/ssl.key.
etc/named.conf is converted to BIND version 9, and references to 3-DNS are removed.
/etc/snmpd.conf sysip is deleted and com2sec is changed to com2sec6.
/etc/snmpd.conf.disabled sysip is deleted and com2sec is changed to com2sec6.

Using the command line utility to run the OTCU

Use the following procedure to convert your existing 4.5.x or 4.6.x configuration data to version 9.2.2.

Note:  If at any point you want to go back to version 4.5.x or 4.6.x, you must re-install the 4.5.x or 4.6.x software. For information on how to install the 4.5.x or 4.6.x software, please refer to the applicable 4.5.x or 4.6.x release notes. For instructions on how to reinstall your previous 4.5.x or 4.6.x configuration files, see SOL1493.

  1. From the command line, type the following command:


    This command starts the utility that converts the version 4.5.x or 4.6.x configuration files.

  2. Follow the on-screen instructions to complete the conversion.

    The utility prompts you for the following information:

    • The time zone

    • The root password

    • Consolidate profiles

    • Rename virtual servers, profiles, pools, and snatpools

    Once the 9.x conversion is complete, the files are moved to their correct locations and loaded.

  3. After you you have reviewed the log files and are completely satisfied with the resulting configuration, you can remove all conversion files from the system by typing the following command:


[ Top ]

Running the profile consolidater and config renamer

If you skipped the step to consolidate profiles and rename virtual servers, profiles, pools, and snatpools, you can run the consolidation utility by typing the following command:

     profile_consolidator /config/bigip.conf

You can run the renaming utility by typing the following command:

     config_renamer /config/bigip.conf

Note:  In order for the renaming to take effect, you must reload the configuration file.

[ Top ]

Was this resource helpful in solving your issue?

NOTE: Please do not provide personal information.

Incorrect answer. Please try again: Please enter the words to the right: Please enter the numbers you hear:

Additional Comments (optional)