Applies To:

Show Versions Show Versions

Release Note: BIG-IQ Cloud, 4.1.0
Release Note

Original Publication Date: 10/14/2013


This release note documents version 4.1.0 of BIG-IQ Cloud.


- Product description
- Screen resolution requirement
- Browser support
- Software installation
- Upgrading a BIG-IQ system license
- User documentation for this release
- New features
- Fixes
- Known issues
- Removing BIG-IQ system services from a BIG-IP device
- Contacting F5 Networks
- Legal notices

Product description

Cloud administrators can use BIG-IQ Cloud to supply tenants with on-demand access to resources such as networks, servers, storage, applications, and services. These cloud resources can be located on BIG-IP devices in a private local network, a public third-party cloud service, or a combination of both.

Each tenant has restricted and dedicated access to resources based on their tenant role and user account. Cloud space can be expanded, retracted, and reallocated to tenants as needed, providing flexible resource balancing.

Screen resolution requirement

To properly display, the BIG-IQ system requires that your screen resolution is set to 1280x1024 or higher.

Browser support

BIG-IQ Cloud supports the following browsers and versions:

  • Microsoft Internet Explorer version 9
  • Mozilla Firefox version 18.x
  • Google Chrome version 18.x

Software installation

For procedures about specifying network options and performing initial configuration, refer to the Setup and Getting Started guide specific to the hypervisor on which you installed BIG-IQ Cloud.

Upgrading a BIG-IQ system license

Before you can upgrade the BIG-IQ system license, you must perform the following tasks:

  • Reactivate your current license to ensure that you have a valid service check date.
  • Download the .iso file for the upgrade from F5 Downloads to /shared/images on the BIG-IQ system. If you need to create this directory, use the exact name /shared/images.
  • Using the management port, log in to the system and boot into an installation location other than the target for the installation.
  • Locate the user configuration set (UCS) in the /var/local/ucs directory on the source installation location, and copy the UCS file to another system for safe keeping.

You install the software upgrade at the command line.

  1. Log in to the BIG-IQ system with the administrator user name and password.
  2. At the top of the screen, click System Overview.
  3. In the Setup panel, click the IP address of the BIG-IQ system. The panel expands to display additional properties.
  4. Click the Re-Activate button. The screen refreshes.
  5. Click the Activate button. The BIG-IQ system license reactivates and the screen refreshes to display license details.
  6. Using a browser on which you have configured the management interface, type the following URL where <management_IP_address> is the address you specified for device management: https://<management_IP_address>
  7. Log in to the command line with your administrator user name and password.
  8. Type the following command where <image name> is the name of the .iso file you downloaded and <volume name> is the volume to which you want to install the file on the BIG-IQ system. tmsh install sys software image <image name> volume <volume name>
  9. Log in to the BIG-IQ system with the administrator user name and password.
  10. At the top of the screen, click Devices. Managed BIG-IP devices display a Discovery Failed Message.
  11. Click the properties icon for each device and:
    1. Type the device's administrator user name and password.
    2. Click the Save button.
    The BIG-IQ system rediscovers the device.

User documentation for this release

For a comprehensive list of documentation that is relevant to this release, refer to the BIG-IQ 4.1.0 Documentation page.

New features

Updated navigation for system-level configuration

The system-level properties and licensing details are now located on the System screen. To access the System screen, at the top of the screen, click System Overview.

Updated navigation for user management

The users and roles are now located on the Users screen. To access the Users screen, at the top of the screen, click Users.

High availability support

Starting in this release, BIG-IQ Cloud supports high availability configurations in an active-standby pair.

Enhanced health and performance monitoring

You can now view health and performance statistics for application, connector, and server objects. To access statistics, click the Statistics tab from the properties screen of the object's panel.

Online help

This release includes context-sensitive online help. To access online help, click the help (?) icon located in the right corner at the top of each screen.


Issue Description
ID 419935 The BIG-IQ system now supports Device Service Clustering (DSC) on managed BIG-IP devices. Changes made to a BIG-IP configuration are automatically synchronized to its peers.
ID 418899 Applications that a tenant creates now properly display in the catalog panel.
ID 413274 In the previous release, if the screen was reduced past the minimum specific size of 1280x1024 or higher, the horizontal scroll bar disappeared. This issue is resolved and the horizontal scroll bar properly appears.

Known issues

Issue Description Workaround (if available)
ID 432835 After activating a production license on BIG-IQ Cloud version 4.1.0, the system logs may contain a "NullPointerException" error and some BIG-IQ Cloud functionality may not be available.  
ID 428064 When activating a production license for the BIG-IQ system version 4.1.0, the expiration date on the Properties screen displays the error message "NaN". This error is benign and has no impact on the license activation process. You can disregard this benign error.
ID 427810 If you change the self IP address specified for the BIG-IQ system during initial configuration after you discover managed devices, then future device discovery processes may not work as expected. You can change the self IP address only if you have not yet discovered managed devices. Do not change the self IP address once you have performed device discovery.
ID 427122 You cannot change the active BIG-IQ system in a high availability pair from the user interface. To work around this issue: (1) On the standby BIG-IQ system, type the following command to get the latest state from the active BIG-IQ system: PUT to /mgmt/shared/storage/snapshot-client with this body: { "snapshotFile": "" } (2) On the active BIG-IQ system, type: bigstart stop restjavad (3) When the standby BIG-IQ system becomes active, type the following command on the BIG-IQ system that is now in standby mode: bigstart start restjavad
ID 426951 The Amazon EC2 connector reports an UnknownHostException error when trying to resolve the region endpoint DNS name. To resolve this issue, navigate to the System > Services screen and specify the DNS settings for the BIG-IQ system. Then restart restjavad as follows: 1) Access the BIG-IQ system's management IP address through SSH, 2) Log in as root, 3) Type bigstart restart restjavad.
ID 426708 When a BIG-IQ system in a high availability configuration fails over to the peer system, the formerly active BIG-IQ system incorrectly displays in the devices panel as a managed device.

To work around this issue, (from the active BIG-IQ system) delete the BIG-IQ system from the managed devices list. You may receive a benign error.

ID 426582 There must be a route configured between the BIG-IQ system's internal self IP address (used for discovery) and the self IP address for all managed BIG-IP devices. If the internal self IP addresses for the BIG-IQ system and the managed BIG-IP devices are on different subnets, the discovery task may fail with a connection reset log message and display a message in the user interface that the framework on the targeted BIG-IP requires an update. Verify there is no route between the two self IP addresses by logging in to the command line and typing, ping -I internal <self IP address you are trying to reach>. Then, to configure the internal self IP default route on the BIG-IQ system: 1) Access the BIG-IQ system's management IP address through SSH, 2) Log in as root, 3) Type: tmsh create net route <route name> {gw <x.x.x.x> network default}, Where <route name> is a user-provided name to identify the new route, and <x.x.x.x> is the self IP address of the default gateway for the internal network.
ID 426320 Discovering a device, such as declaring management authority or setting a peer device, fails with the following error: Unable to discover the device to be managed, reason (You cannot discover device [IP ADDRESS] through group [YOUR GROUP] because that group does not contain local host.) Refer to the AskF5 Solution SOL14593 titled Device discovery may fail due to localhost discovery failure for troubleshooting instructions.  
ID 418490 The VMware vSphere hypervisor returns TMM restart messages when using the 4-core configuration option. To work around this issue: 1) Access the BIG-IQ system's management IP address through SSH, 2) Log in as root, 3) Type bigstart restart
ID 417874 If a tenant does not remove all applications from a device before an administrator deletes the device, those applications remain associated with it. If the device is re-discovered the applications persist and display for the tenant, but are not available for deployment. You cannot remove these applications through the user interface. To remove orphaned applications, log in to the managed device with the administrator user name and password, and delete the orphaned applications. To avoid this situation, administrators must first request that tenants remove applications before they delete a device on which those applications exist.
ID 417871 When you are logged in as administrator, newly-deployed VMware vShield applications do not display in the BIG-IQ Cloud Application panel, and the associated servers do not appear in the Servers panel. To work around this issue, refresh the BIG-IQ Cloud browser twice: the first refresh updates the Application panel, the second refresh updates the Servers panel.
ID 417179 If an application shares a server, and you select an application from the Application panel, the associated Servers do not display properly in the Server panel. To avoid this issue, do not share servers between multiple applications.
ID 417165 If the health of a cloud connector changes, BIG-IQ Cloud does not immediately display the change in the Connector panel. To view the current health of a cloud connector, refresh your browser.
ID 417051 BIG-IQ Cloud does not currently support devices with IPV6 addresses. Use IPV4 addresses to discover devices.
ID 416870 If a vShield Manager or vCloud Director user explicitly removes the BIG-IQ Cloud registration, the VMware cloud connector for that VMware product continues to display in the Connector panel, but as unhealthy. To work around this issue, log in to BIG-IQ Cloud as administrator, navigate to the properties screen for the VMware connector, and click the Delete button.

Removing BIG-IQ system services from a BIG-IP device

To manage a BIG-IP device using the BIG-IQ system, you must install specific BIG-IQ system components onto that device using the procedure outlined in the Installation and Initial Configuration chapter of the Setup and Getting Started guide specific to the hypervisor on which you install the BIG-IQ system. In the event that you have to remove these services for any reason, use this procedure.
  1. Log in to the command line of the BIG-IP device.
  2. Stop any running BIG-IQ system services.
    Note: The msgbusd service may not be installed. You can use the bigstart status command to see if it is running.

    $ bigstart stop restjavad

    $ bigstart stop msgbusd

  3. Remove the RPM packages related to the BIG-IQ system.

    mount -o remount,rw /usr

    rpm -qa | grep f5-rest-java | xargs rpm -e --nodeps

    rpm -qa | grep msgbusd | xargs rpm -e  --nodeps

    mount -o remount,ro /usr

    This removes the BIG-IQ system components from the BIG-IP device, including the F5-contributed cloud connector iApp template (cloud_connector.tmpl).

  4. Optional: To reinstall the F5-contributed cloud connector iApp template, take these steps:
    1. Download the cloud_connector.tmpl iApp template from F5 DevCentral,
      Note: You need an account to access the DevCentral site.
    2. Unzip the file, and on the BIG-IP system, upload it to the /var/local/app_template directory.
    3. Install the template with this command: tmsh load / sys application template cloud_connector.tmpl

Contacting F5 Networks

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

For additional information, please visit

Additional resources

You can find additional support resources and technical documentation through a variety of sources.

F5 Networks Technical Support

Free self-service tools give you 24x7 access to a wealth of knowledge and technical support. Whether it is providing quick answers to questions, training your staff, or handling entire implementations from design to deployment, F5 services teams are ready to ensure that you get the most from your F5 technology.


AskF5 is your storehouse for thousands of solutions to help you manage your F5 products more effectively. Whether you want to search the knowledge base periodically to research a solution, or you need the most recent news about your F5 products, AskF5 is your source.

F5 DevCentral

The F5 DevCentral community helps you get more from F5 products and technologies. You can connect with user groups, learn about the latest F5 tools, and discuss F5 products and technology.

AskF5 TechNews

Weekly HTML TechNews
The weekly TechNews HTML email includes timely information about known issues, product releases, hotfix releases, updated and new solutions, and new feature notices. To subscribe, click TechNews Subscription, fill out the required fields, and click the Subscribe button. You will receive a confirmation. Unsubscribe at any time by clicking the Unsubscribe link at the bottom of the TechNews email.
Periodic plain text TechNews
F5 Networks sends a timely TechNews email any time a product or hotfix is released. (This information is always included in the next weekly HTML TechNews email). To subscribe, send a blank email to from the email address you would like to subscribe with. Unsubscribe by sending a blank email to

Legal notices



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)