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
- -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
See Table 6, Return Codes for tacmd CLI commands in the Reference Guides.
Was this topic helpful?
Document Information
Modified date:
17 June 2018
UID
swg21572221