IBM Tivoli Monitoring, Version 6.3

tacmd importNavigator

Description

Use the tacmd importNavigator command to import a Tivoli® Enterprise Portal custom navigator view, workspaces, queries, and situation associations from an XML file to the Tivoli Enterprise Portal Server.

When a navigator view is imported, the navigator is not assigned to any users. If the navigator already existed, the previously established user assignments are preserved. The tacmd editUser command can be used to assign the logical navigator to a user. Some important notes about using the tacmd editUser command:

The tacmd editUser command explicitly assigns navigators, so you must be careful to append the new navigator to the list of navigators already assigned to you, or the other assignments for you will be lost.
The Tivoli Enterprise Portal client does not receive a refresh event notification when assignments are made through the CLI, so a client restart is required to pick up the changes.
The default navigator is displayed as the first navigator in the list assigned to the "NavigatorViews" property; in the following example, "VerizonCellular" is the default navigator view when the Tivoli Enterprise Portal client is restarted:
```
tacmd edituser -u sysadmin -w mypassword -i sysadmin 
-p NavigatorViews=VerizonCellular,Physical
```

When a navigator is imported, by default all workspaces, workspace links, queries, situation associations, and managed system assignments (distributions) that are defined in the xml file are imported.

After the tacmd importNavigator command has been used to import a custom navigator that was exported from another environment, the tacmd exportWorkspaces and tacmd importWorkspaces commands can be used to import workspaces into the newly imported environment.

Note: If you are importing a workspace that has been viewed in the Tivoli Enterprise Portal previously, you must recycle the Tivoli Enterprise Portal to see the correct version. If you want to use the current tacmd tepsLogin values for username, password, and server hostname, do not enter any of these options for the importNavigator command. If you specify values for some, but not all of these options, you are prompted to specify the username and password if these values are missing.

CLI syntax

tacmd importNavigator
                      {-x|--xmlFile} XMLFILE
                      [{-u|--username} TEPS_USER]
                      [{-p|--password} TEPS_PASSWORD]
                      [ {-s|--server} TEPS_HOST[:PORT] ]
                      [ {-o|--navigatorOnly} ]
                      [ {-f|--force} ]

where:

-x|--xmlFile: Specifies the name of the XML file accessible to the local file system where the custom navigator view, workspaces, queries, and situation associations will be imported from. The file name can either be a relative or absolute file name.
-s|--server: Specifies which Tivoli Enterprise Portal Server to use.
-u|--username: Specifies the identifier of the user to authenticate to the Tivoli Enterprise Portal Server. The user must have the 'Modify' permission for the 'Custom Navigator Views' object, the 'Modify' permission for the 'Query' object, and the 'Workspace Administration Mode' and 'Workspace Author Mode' permissions for the 'Workspace Administration' object enabled on the server to execute the importNavigator command. The permissions for these objects are disabled by default for most users. The software prompts you for the username if you do not specify one.
-p|--password: Specifies the password of the user to authenticate to the Tivoli Enterprise Portal Server. The software prompts you for the password if you do not specify one.
-o|--navigatorOnly: Specifies that only the custom navigator view is imported. Workspaces, queries, and situation associations in the XML file will not be imported.
-f|--force: Imports the custom navigator view without confirmation.

CLI example

The following example imports the custom navigator views specified from the file importNavigator.xml to the Tivoli Enterprise Portal Server on HDCHASDSTC0420:

tacmd importnavigator -x importNavigator.xml -s HDCHASDSTC0420 
-u sysadmin -p ***** -f

Return values

See Table 1.

Related commands

Return to Table 1.

Feedback