Description
This command is used to import the Tivoli® Enterprise
Portal workspaces from an XML file into the Tivoli Enterprise Portal Server. This command
can only be run from a Tivoli Enterprise
Monitoring Server, Tivoli Enterprise
Portal Server, or Tivoli Enterprise
Portal Desktop Client installation.
Once 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. Workspaces imported
into a custom navigator environment are not visible in the Tivoli Enterprise Portal or Browser
Client unless the custom navigator has been imported from the source
environment for the workspaces.
Note: 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 importWorkspaces command. If you specify
values for some, but not all of these options, you are prompted to
specify the username and password if they are missing.
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.
Note: The XML schema for workspaces was redesigned
for the IBM® Tivoli Monitoring v6.2 Fix Pack 1 release. Any workspace
XML produced by the tacmd exportWorkspaces command before IBM Tivoli Monitoring
v6.2 Fix Pack 1 is incompatible with the new format, and cannot be
imported by using this command.
CLI syntax
tacmd importWorkspaces
{-x|--xmlFile} XMLFILE
[{-u|--username} TEPS_USER]
[{-p|--password} TEPS_PASSWORD]
[{-s|--server} TEPS_HOST[:PORT]]
[{-q|--queries} ]
[{-f|--force} ]
where:
- -x|--xmlFile
- Specifies the name of the XML file accessible to the local file
system where the workspace definitions will be imported from. The
file name can either be a relative or absolute file name.
- -s|--server
- 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 15200.
- -u|--username
- Specifies the identifier of the user to authenticate on the Tivoli Enterprise Portal Server.
Specify a valid string in the local locale. You must have both 'Workspace
Administration Mode' and 'Workspace Author Mode' Workspace Administrator
permissions enabled on the server to execute the listWorkspaces command.
The 'Workspace Administration Mode' permission is disabled by default
for most users. The software prompts you for the username if you
do not specify one.
- -p|--password
- The password of the user to authenticate on the Tivoli Enterprise Portal Server.
Specify a valid string in the local locale. The software prompts you
for the password if you do not specify one.
- -q|--queries
- Imports any queries from the XML file to the Tivoli Enterprise Portal Server.
- -f|--force
- Imports the workspace(s) without confirmation.
CLI example
This example imports workspaces from the file all_lever_workspaces.xml to
the server located at myteps.ibm.com.
tacmd importworkspaces –s myteps.ibm.com –u imasample
–p mypassword –x all_lever_workspaces.xml
This example is the same scenario as the previous example, except
that the force flag is used to suppress confirmation prompts.
tacmd importworkspaces –s myteps.ibm.com –u imasample
–p mypassword –x all_lever_workspaces.xml -f
This example imports workspaces from the file all_lever_workspaces.xml to
the server located at myteps.ibm.com on port 1996. The user is prompted
to enter the server username and password.
tacmd importworkspaces –s http://myteps.ibm.com:1996 –x all_lever_workspaces.xml