Skip to main content

F5 fix Guided Configuration Installation

Customers are using more and more Guided Configuration on F5 systems.
Sometimes we have the problem that GC is not working and shows a 404 not-found error or similar.

The problem is that when GC is not working properly anymore you cannot get to the GUI part to install or update GC to the actual version.

K13120484: Guided configuration cannot load page - The requested URL was not found on this server

After clicking Guided Configuration in GUI we can see:

The requested URL was not found on this server.

Follow below steps:

  1. Log on to the BIG-IP APM command line. Run backup creation to have a snapshot to revert to:

    # make sure to be in bash mode:
    # tmsh save sys ucs $(echo $HOSTNAME | cut -d'.' -f1)-$(date +%H%M-%m%d%y)_pre
     
  2. Stop the restjavad and restnoded with the following commands :

    # bigstart stop restjavad restnoded
     
  3. Run the following commands:
    # tar -czpf /var/tmp/rest_storage_pre.tgz /var/config/rest/storage/*
     # rm -f /var/config/rest/storage; clear-rest-storage

    Important: This step will remove SSLO configuration from device - if SSLO module is in use. Also if device is managed by BIG-IQ, BIG-IP device might have to be rediscovered on BIG-IQ systems.


    Start the restjavad and restnoded daemons in the standby unit by running the following commands

    # bigstart start restjavad restnoded
     
  4. After few minutes navigate to Access >> Guided Configuration to verify if the error message is no longer seen.
     
  5. Raise service ticket with F5 support and share files generated with fresh Qkview with support.

New Installation of GC Components

The following shows how to proceed with curl and REST-API to do a new installation of the GC components.
You can download the actual GC at https://my.f5.com

Upload File

curl -i -sk -u <username> -X POST -H "Content-Type: application/octet-stream" -H "Content-Range: 0"\
 --data-binary "<filename>" "https://<f5-hostname>/mgmt/shared/file-transfer/uploads/<filename>"

Install File

curl -k -u <username> -X POST -d '{"filePath": "/var/config/rest/downloads/<filename>
"}' -H 'Content-Type: application/json' 'https://<f5-hostname>/mgmt/tm/access/bundle-install-tasks' | jq

Check installation of file

curl -k -u <username> -d '{"filePath": "/var/config/rest/downloads/<filename>"}'\
 -H 'Content-Type: application/json' 'https://<f5-hostname>/mgmt/tm/access/bundle-install-tasks' | jq

Back to top