IBM Support

tacmd updateFramework

News


Abstract

This document describes the IBM Tivoli Monitoring command 'tacmd updateFramework' introduced in 6.2.2 Fix Pack 7.

Content

Use the tacmd updateFramework command to install an IBM® Tivoli® Enterprise Monitoring Agent (TEMA) Framework update on a specified managed system. Updating the TEMA Framework involves stopping any agents that are running, applying the changes, and then restarting them.

By using the bulk deploy option, the agents specified in the bundle group are updated on the managed systems specified in the deploy group. The no execute option is intended to allow the user to determine which bundles will be updated to which managed systems.

Note:
The prerequisite 'tf' bundles must be present in the TEMS Depot to use this command. You can confirm that the 'tf' bundles are present by running tacmd viewdepot to see that 'tf' is available as one of the Product Code's listed. If not the 'tf' bundles can be added to the TEMS Depot using the tacmd addBundles CLI command.

Note:
The 'tf' bundles include updates to multiple TEMA Framework components. Executing this command will only uplift the TEMA Framework components, not the agents. Use tacmd updateAgent to update the TEMA Framework together with the Agent.

Limitation:
The command does not uplift TEMA Framework components whose architecture does not match those that are contained in the 'tf' package. If an installed TEMA Framework component is for a platform architecture that is deprecated by the version contained in the 'tf' package, the TEMA Framework component will not be uplifted. Refer to TechNote # 1570779.

Limitation:
No 'tf' package has been produced to uplift a TEMA Framework on a Windows target. Issuing the command and specifying a Managed System Name (-n) parameter that is a Windows target will return the error message KDY0010E ( The agent bundle specified for deployment is not installed on the agent bundle depot for the target operating system. ).


CLI syntax

Updating a single IBM Tivoli Monitoring agent's Framework:

    tacmd updateFramework
        {-n|--node}
        {-v|--version} VERSION
        [{-f|--force}]

Updating bulk IBM Tivoli Monitoring TEMA Frameworks:
    tacmd updateFramework
        {-g|--deploygroup} DEPLOY_GROUP_NAME
        {-b|--bundlegroup}BUNDLE_GROUP_NAME
        {-v|--version} VERSION
      [{-f|--force} | {-x|--noexecute}]
where:
    -n|--node
    Identifies the node on the computer that has the TEMA Framework that you want to update. A node is identified by the managed operating system that it contains. The name of a node includes the computer where the OS agent is installed and the product code for the OS agent. For example, stone.ibm.com:LZ is the name of the node on computer stone.ibm.com, which has a Linux® OS agent installed.

    -v|--version
    Specifies the version of the TEMA Framework to which you wish to upgrade. You must specify the version in the format: vvrrmmfff where vv = version number; rr = release number; mm = modification number (fix pack number); and fff = interim fix number. You cannot use this command to revert a TEMA Framework to a previous version.

    -f|--force
    Performs actions without asking confirmation.

    -g|--deploygroup
    Specifies the name of the deploy group to which the agents in the bundle group will be updated.

    -b|--bundlegroup
    Specifies the name of the bundle group containing the agent(s) which will be updated on the managed system(s) in the deploy group.

    -x|--noexecute
    Causes the command to display which bundles will be updated to which managed systems.

CLI example
    The following command updates a TEMA Framework at version 6, release 2.2, fix pack 7 on the Managed System Name asas1wd.

    tacmd updateFramework -n asas1wd:LZ -v 062207000

    The following command updates the TEMA Framework for all the Managed Node members of the deploy group "UnixGroup" to IBM Tivoli Monitoring TEMA Framework v6.2.2, Fix Pack 7:

    tacmd updateAgent -g UnixGroup -b UXBundle -v 062207000
Return values

See Table 6, Return Codes for tacmd CLI commands in the Reference Guides.

[{"Product":{"code":"SSTFXA","label":"Tivoli Monitoring"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Not Applicable","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF010","label":"HP-UX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"6.2.2.7;6.2.3;6.2.3.1","Edition":"All Editions","Line of Business":{"code":"LOB45","label":"Automation"}}]

Document Information

Modified date:
17 June 2018

UID

swg21572221