Tivoli Monitoring, Version 6.2

tacmd exportworkspaces

Description

This command exports one or more Tivoli Enterprise Portal Server workspaces to the file xml_file. This command can only be run from a Tivoli Enterprise™ Monitoring Server, Tivoli Enterprise Portal Server, or Tivoli Enterprise Portal Desktop Client installation.

CLI syntax

tacmd exportworkspaces {-x|--xmlFile} xml_file  
                        [{-s|--server} host[:port]]
                        [{-u|--username} teps_user]
                        [{-p|--password} pwd]
                        [{-w|--workspace} workspace ...]
                        [{-r|--workspaceUser} userid ...]
                        [{-t|--type} type ...]
                        [ {-e|--exclude} ]
    [{-f|--force}]

where:

-x|--xmlFile xml_file
The name of the XML file accessible to the local file system where the workspace definition or definitions will be exported to. This is the name of a file that can be created or overwritten.
-s|--server host[:port]
Specifies a Tivoli Enterprise Portal Server to use. The host is a 32 or 64 bit IP address or hostname and port is an integer between 1 and 65536. If not specified, host defaults to localhost and port defaults to 1920.
-u|--username teps_user
The identifier of the user to authenticate on the remote Tivoli Enterprise Portal Server. Specify a string valid in the local locale.
-p|--password pwd
The password of the user to authenticate on the remote Tivoli Enterprise Portal Server. Specify a string valid in the local locale.
-w|--workspace workspace ...
The name or names of the workspaces to export. Specify a string (any character except hyphen (-)) up to a maximum length of 72 characters. If not specified, all workspaces will be exported.
-r|--workspaceUser userid ...
A Tivoli Enterprise Portal user ID that one or more Tivoli Enterprise Portal workspaces are associated with. Specify a string of letters (upper or lower case) or numbers up to a maximum length of 32 characters. If not specified, workspaces are exported for all users.
-t|--type type ...
An IBM Tivoli Monitoring 6.1 or IBM Tivoli Monitoring 6.2 application type. Specify a 2 or 3 character string for the managed system type code. If a 2 character type is entered, the letter 'k' will be prefixed automatically to form a 3 character type code. If not specified, all types are exported.
-e|–exclude
Exclude the specified workspace users, application types, and Tivoli Enterprise Portal user IDs from the export operation.
-f|--force
Perform the export without prompting for confirmation first.

CLI example

This example exports all workspaces on the Tivoli Enterprise Portal Server myteps.ibm.com without any filtering arguments (such as workspace name, user ID, or application type).

Note:
A large number (over 500) of workspaces may be displayed and exported.
   tacmd exportworkspaces -s http://myteps.ibm.com:1920 -u imasample
                          -p mypassword-x all_workspaces.xml

This example exports all workspaces on the Tivoli Enterprise Portal Server myteps.ibm.com without any filtering arguments (such as workspace name, user ID, or application type). The -f option is used in this example to perform the export operation without prompting for confirmation.

Note:
A large number (over 500) of workspaces are likely be exported.
   tacmd exportworkspaces -s http://myteps.ibm.com -u imasample 
                          -p mypassword-x all_workspaces.xml -f

This example exports all workspaces belonging to the klz and knt application types on the Tivoli Enterprise Portal Server running on the local machine on port 1920 and filtered by application type.

   tacmd exportworkspaces -u imasample -p mypassword-t klz knt 
                          -x klz_and_knt_workspaces.xml

This example is identical to the one above, except that the server credentials (username and password) were omitted at invocation time, and the user is interactively prompted to enter them.

   tacmd exportworkspaces -s myteps.ibm.com -t klz knt

This example exports all workspaces belonging to (customized for) the SYSADMIN user on the Tivoli Enterprise Portal Server myteps.ibm.com and filtered by user name.

Note:
In this example no global workspaces are exported.
   tacmd exportworkspaces -s myteps.ibm.com -u imasample -p mypassword-r SYSADMIN

This example exports only workspaces matching the names Historical Summarized Availability Daily or Historical Summarized Availability Weekly on the Tivoli Enterprise Portal Server myteps.ibm.com and filtered by workspace name.

   tacmd exportworkspaces -s myteps.ibm.com -u imasample -p mypassword 
         -w “Historical Summarized Availability Daily" 
            “Historical Summarized Availability Weekly"

This example exports only workspaces belonging to the klz and knt application types, workspace names matching the names Historical Summarized Availability Daily or Historical Summarized Availability Weekly on the Tivoli Enterprise Portal Server myteps.ibm.com, and filtered by both workspace name and application type.

   tacmd exportworkspaces -s myteps.ibm.com -u imasample -p mypassword-t klz kux 
		-w “Historical Summarized Availability Daily" 
         “Historical Summarized Availability Weekly"

Return values

See Return codes.

Related commands

tacmd listworkspaces

tacmd importworkspaces



Feedback

[ Top of Page | Previous Page | Next Page | Contents | Index ]