Troubleshooting

Use this section to read about known issues and for common troubleshooting steps.

AS3 general troubleshooting tips

  • Examine the restnoded failure log at /var/log/restnoded/restnoded.log (this is where AS3 records error messages)
  • Examine the REST response:
    • A 400-level response will carry an error message with it
    • If this message is missing, incorrect, or misleading, please let us know by filing an issue on Github.
  • Use AS3’s trace option to create a detailed trace of the configuration process for subsequent analysis. AS3’s trace option can be a powerful tool to learn about its working details and to review AS3’s operations in detail

Troubleshooting

I’m receiving an error with status of 500 when sending a large declaration

When sending a large declaration with hundreds of application services, you may experience a 500 error stating that the save sys config operation failed. In some cases, the operation succeeds, but you still receive the error.

If you experience this issue, restart restjavad (from the BIG-IP command line: `bigstart restart restjavad`), and then resend the declaration.


After upgrading to AS3 3.10.0, I’m experiencing issues with my Service Discovery pool configuration

In AS3 3.10.0, the name of the Service Discovery package changed. In prior versions, the package was named f5-appsvcs-discovery, and in 3.10.0 this changed to f5-service-discovery. If you were running AS3 3.8.0 or later, and upgraded to 3.10.0, the new package is installed, but the old package is not deleted. This means both Service Discovery applications are running, which may cause unpredictable pool configuration when you post a declaration after the upgrade. The procedure if slightly different depending on whether you have already upgraded to 3.10.0 or not.

If you are using AS3 3.8.0 or later, and have not yet upgraded to 3.10.0, before upgrading to 3.10.0, use the following guidance:

  1. Uninstall the previous version of AS3, and the Service Discovery package:
    • From the BIG-IP UI, click iApps > Package Management LX.
    • Check the boxes for f5-appsvcs and f5-appsvcs-discovery. You must uninstall both packages at the same time.
    • Click the Uninstall button, and then click Yes when prompted to uninstall the packages.
  2. Install AS3 3.10.0 (see Downloading and installing the AS3 package).

Important Uninstalling AS3 and the Service Discovery packages will not delete your current configuration, alter the BIG-IP configuration, or disrupt traffic.

If you have already installed AS3 3.10.0, use the following guidance to resolve this issue:

  1. Uninstall AS3 3.10.0, and both Service Discovery packages:
    • From the BIG-IP UI, click iApps > Package Management LX.
    • Check the boxes for f5-appsvcs, f5-appsvcs-discovery, and f5-service-discovery. You must uninstall all packages at the same time.
    • Click the Uninstall button, and then click Yes when prompted to uninstall the packages.
  2. Reinstall AS3 3.10.0 (see Downloading and installing the AS3 package). After you reinstall 3.10.0, you may have to refresh the UI to see the new Service Discovery package.

Important Uninstalling AS3 and the Service Discovery packages will not delete your current configuration, alter the BIG-IP configuration, or disrupt traffic.


I’m receiving a path not registered error when I try to post a declaration

If you are receiving this error, it means either you did not install AS3, or it did not install properly. The error contains the following message:

{
    "code":404,
    "message": "Public URI path no registered. Please see /var/log/restjavad.0.log and /var/log/restnoded/restnoded.log for details.".
    ...
}

If you receive this error, see Downloading and installing the AS3 package to install or re-install AS3.


I’m receiving the following error when using AS3 on BIG-IQ: “Failed to set tenant on BIG-IQ: java.lang.IllegalArgumentException: Cannot modify target address”

The entire message looks similar to:

{
    "message": "Failed to set tenant on BIG-IQ: java.lang.IllegalArgumentException: Cannot modify target address",
    "tenant": "Generic_Ten",
    "host": "localhost",
    "runTime": 531,
    "code": 422
}

This error message occurs when you attempt to create/modify a Tenant or something on a Tenant that exists on another BIG-IP. Note: Tenants must be unique among all BIG-IPs managed by BIG-IQ. Referencing the proper BIG-IP should solve this error.


I’m receiving the following error when using AS3 on BIG-IQ: “Cannot find any ADC root nodes for the target devices”

The entire message looks similar to:

{
    "message":"Cannot find any ADC root nodes for the target devices",
    "tenant":"TEST_Monitor",
    "host":"localhost",
    "runTime":11558,
    "code":422
}

This error means that the BIG-IQ has not discovered/imported LTM on that specific BIG-IP. To correct this issue, perform the following from the BIG-IQ UI:

  1. Click Devices > BIG-IP Devices. Note the Services column will likely show only Management.
  2. Click the Management link for the target BIG-IP.
  3. In the LTM section at the top of the page, click Discover.
  4. When the discovery process completes, click Import.
  5. Send the AS3 declaration again. You should no longer receive the error.