Applies To:

Show Versions Show Versions

sol13676: The BIG-IP system fails to include the referenced CLI script when exporting an iApp template
Known IssueKnown Issue

Original Publication Date: 06/21/2012
Updated Date: 06/13/2013

Description

The BIG-IP system fails to include the referenced CLI script when exporting an iApp template. This issue occurs when all of the following conditions are met:

  • The iApp template references the use of a CLI script
  • The referenced CLI script is a user-created script

The CLI script is based on the Traffic Management Shell (tmsh) utility using Tool Command Language (TCL), and automates the management of the BIG-IP system by combining a series of tmsh and TCL commands. For more information about the CLI script, you can run the tmsh help cli script command.

Impact

You cannot import the iApp template export file into the BIG-IP system.

Symptoms

As a result of this issue, you may encounter the following symptoms:

  • The BIG-IP system fails to import the iApp template export file and reports an error message that appears similar to the following example:

    01070712:3: Caught configuration exception (0), ERROR app_template - /Common/myiApp definition:
    line 2 [script "test382051script" included from "APP_TMPL_/Common/myiApp_definition" not found] [tmsh::include "test382051script"]
    line 4 [script "test382051script" included from "APP_TMPL_/Common/myiApp_definition" not found] [tmsh::run_proc test382051script:myproc]
     - sys/validation/AppTemplateAction.cpp, line 359.

  • The BIG-IP system that has the iApp template and referenced user-created CLI script fails to ConfigSync to its device group peers and logs an error message that appears similar to the following example to the /var/log/ltm file:

    01070712:3: Caught configuration exception (0), ERROR app_template - /Common/myiapptemp definition:  line 4 [script "/Common/test382051script" included from "APP_TMPL_/Common/myiapptemp_definition" not found] [tmsh::include /Common/test382051script] line 6 [script "/Common/test382051script" included from "APP_TMPL_/Common/myiapptemp_definition" not found] [tmsh::run_proc /Common/test382051script:my_proc]  - sys/validation/AppTemplateAction.cpp, line 359.

Status

F5 Product Development has assigned ID 382051 to this issue, and has confirmed that this issue exists in the products listed in the Applies To box. For information about releases or hotfixes that resolve this issue, refer to the following table:

Type of Fix Versions Fixed Related Articles
Release 11.4.0 SOL2200: Most recent versions of F5 software
Hotfix None None

Workaround

To prevent this issue from occurring, ensure the destination BIG-IP system has a copy of the script before the iApp template is imported to the destination BIG-IP system. You can do so by exporting the user-created CLI script from the source BIG-IP system and importing it to the destination BIG-IP system. To do so, perform the following procedure:

Impact of workaround: None.

  1. Identify the missing script on the destination BIG-IP system by inspecting the error message.

    For example, in the following example error message, the missing script is test382051script:

    01070712:3: Caught configuration exception (0), ERROR app_template - /Common/myiApp definition:
    line 2 [script "test382051script" included from "APP_TMPL_/Common/myiApp_definition" not found] [tmsh::include "test382051script"]
    line 4 [script "test382051script" included from "APP_TMPL_/Common/myiApp_definition" not found] [tmsh::run_proc test382051script:myproc]
     - sys/validation/AppTemplateAction.cpp, line 359.

  2. Log in to the command line of the source BIG-IP system.
  3. Export out the script to a file on the source BIG-IP system by entering the following command:

    tmsh list cli script <CLI script name> > <path/to/export/file>

    For example:

    tmsh list cli script test382051script > /var/tmp/test382051script.txt

  4. Copy the script export file to the destination BIG-IP system.
  5. Import the script into the existing running configuration on the destination BIG-IP by entering the following command:

    tmsh load sys application template <path/to/script/file>

    For example, to load the /var/tmp/test382051script.txt script export file, you would type the following command:

    tmsh load sys application template /var/tmp/test382051script.txt

  6. Import the iApp template export file by entering the following command:

    tmsh load sys application template <path/to/iApp/template/fle>

    For example, to import the /var/tmp/myiApp.tmpl iApp template export file, you would type the following command:

    tmsh load sys application template /var/tmp/myiApp.tmpl

  7. Save the configuration changes on the destination BIG-IP system by entering the following command:

    tmsh save sys config

Supplemental Information

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)