![]() |
![]() |
[ Bottom of Page | Previous Page | Next Page | Contents ]
This section contains new information for documentation units of IBM Tivoli Configuration Manager, Version 4.2.
The following new information applies to the Reference Manual for Software Distribution.
Attribute | Comments | |||
---|---|---|---|---|
Values | Required | Default | Stanzas | |
force_restart | Specifies if the reboot action on
the endpoint must be forced. This attribute is valid only on Windows
systems. Possible values are y and n.
The default value is n. This attribute interacts
with the timeout attribute, as described in the following list:
|
|||
y, n | No | n | restart | |
timeout | Specifies the number of seconds Software Distribution must wait before the reboot fails. If a retry interval occurs during this timeout, the distribution interrupts and the checkpoint and restart feature is used to retry later. The default value is -1. This means that Software Distribution retries the operation for an infinite time. | |||
Integer | No | -1 | restart |
The following new information applies to Messages and Codes.
In Chapter 2 "Activity Planner Message", add the following messages:
The system failed to look up the Activity Planner object in the Framework object database.
The operation is not performed.
Verify whether the Activity Planner was installed correctly. Reinstall the service if the installation was not performed correctly.
An error occurred during an attempt to start the Activity Planner engine.
The Activity Planner engine does not initialize.
Check the Activity Planner log file to determine why the Activity Planner initialization failed.
You specified more than one mutually exclusive option.
The command is not performed.
Specify only one of the mutually exclusive options and resubmit the command.
The system cannot read the specified file.
The operation is not performed.
Check and correct the file name, and resubmit the operation.
The system cannot create the specified file.
The command is not performed
Check and correct the file name, and resubmit the command.
You do not have the correct role assigned to perform the operation.
The operation is not performed.
Ask your Tivoli administrator to assign you the appropriate role.
The system is not able to open the Inter-Object-Messaging channel to receive the data resulting from the operation.
The operation is not performed
Check whether network connections are functioning correctly, and whether Tivoli Management Framework is working properly.
The system cannot find the specified RIM object.
The operation is not performed
Check and correct the name of the RIM object, and resubmit the command.
The trace level you specified is not valid.
The operation is not performed
Specify a valid level and submit the command again.
You specified a file name that is not valid.
The operation is not performed
Check and correct the file name, and resubmit the command.
An error has occurred while trying to create the RIM object.
The operation is not performed
Use the wcrtrim command to create the RIM Object before performing any Activity Planner operations.
An error occurred while trying to create the RIM object for the specified database.
The operation is not performed
Use the wcrtrim command to create the RIM Object before performing any Activity Planner operations
The system is unable to create the Activity Planner user.
The operation is not performed
The system is unable to create the Activity Planner user.
The system cannot create the specified file because the file already exists.
The operation is not performed.
Specify a different name and resubmit the command, or resubmit the command using the -o option to overwrite the specified file.
The maximum length allowed for target names is 250 single-byte characters.
The operation is not performed
Resubmit the command using the -T option.
See message.
The operation is not performed.
Verify why the connection was not established, correct the error, and resubmit the operation.
The operation cannot be completed because of an internal error (for example, a memory allocation failure).
The operation is not performed.
Check the log files. If the problem persists, collect trace information and, if necessary, contact Tivoli Customer Support.
The host name you specified is not recognized in the local Tivoli Management Region.
The operation is not performed
Check the host name and try the operation again.
The host name you specified is not recognized in the local Tivoli Management Region.
The operation is not performed
Check the host name and try the operation again.
The specified variable is not defined.
The operation is not performed
Ensure that the installation was performed correctly, and try the operation again.
See message.
The operation is not performed
Install or repair the Java Runtime Environment, and try the operation again.
The Activity Plan Editor is not installed on the specified host, or the installation is corrupted.
The operation is not performed
Install or repair the Activity Plan Editor, and try the operation again.
See message.
The operation is not performed.
Verify why the connection was not established, correct the error, and resubmit the operation.
The operation cannot be completed because of an internal error (for example, a memory allocation failure).
The operation is not performed.
Check the log files. If the problem persists, collect trace information and, if necessary, contact IBM Software Support.
The host name you specified is not recognized in the local Tivoli Management Region.
The operation is not performed
Check the host name and try the operation again.
The host name you specified is not recognized in the local Tivoli Management Region.
The operation is not performed
Check the host name and try the operation again.
The specified variable is not defined.
The operation is not performed
Ensure that the installation was performed correctly, and try the operation again.
See message.
The operation is not performed
Install or repair the Java Runtime Environment, and try the operation again.
The Activity Plan Monitor is not installed on the specified host, or the installation is corrupted.
The operation is not performed
Install or repair Activity Plan Monitor, and try the operation again.
The following new information applies to the User's Guide for Deployment Services
wlstpln [-Qoption_to_query=value]Also, add the following entry in the Options list:
[-Qoption_to_query=value]Specifies a filter criteria to be applied to the list of plans. The filter criteria and its possible values are as follows:
In the introductory paragraph, add the following bullet as the third bullet of the unordered list:
Enabling User Context Switch
On the Windows NT, 2000, and XP operating systems, to enable the Web user to perform the install, uninstall and verify operations on a software package even if he is not logged on as administrator, the administrator must perform one of the following procedures:
Initializing ... done
Downloading UCS bundle ... done
Distributing profile <name.version> ... Distributed profile <name.version>.where, name.version is the name of the Software Package profile used to import the WebUIService_w32-ix86.spb package.
If while initializing the WebUI on the Web user machine, the following occurs:
The centre of the browser's page will show an error icon which will replace the waiting bar and using the Operations Console will be impossible.
Enable Java plug-in auto-download
The java plug-in auto-download feature on web-user machines can be enabled setting the value of the PLUGIN_AUTH_DOWNLOAD.ENABLED key to "true", by editing the webconsole.properties file located on the Web Gateway machine under the $WAS_HOME/installedApps/WebConsole.ear/WebConsole.war/WEB-INF/classes path. In order that the feature is really enabled, it is necessary to specify in the webconsole.properties file, the http URLs to download the java plug-in for the different operating systems supported on the web-user machines. Then there will be keys such as PLUGIN_DOWNLOAD_URL.<os_name>.
Following the fix pack installation, the files concerning the common and basic libraries, besides those concerning the command line of the Web applications installed on the WebUI (like SoftwareDistributionWeb and InventoryWeb), will be downloaded in a default directory defined as:
while the Operations Console configuration file, webui.properties, will be located under the following directories:
So, on web-user machines you will have to eliminate, if necessary, the configuration file and the runtime files of the WebUI and of the applications that had been installed because of the use of the WebUI prior to the fix pack 1 installation.
To install and configure an environment with unrestricted access to Web objects, follow the instructions in the IBM Tivoli Configuration Manager, Version 4.2 documentation, eliminating the requirement of installing and configuring the IBM Tivoli Access Manager and IBM Tivoli Access Manager WebSEAL security mechanisms. Then, to access the Web objects, start the Web Interface by typing the Web address for the Web Interface server in the following form:
http://hostname/WebConsole/com.tivoli.webui.servlets.ConsoleMain
where, the host name represents the machine where WebSphere is installed and configured. See the following section for the new command syntax for the wweb command used to publish Web objects on the endpoints running the WebSphere Application Server.
In an existing environment with the IBM Tivoli Access Manager and IBM Tivoli Access Manager WebSEAL security mechanisms configured and installed, you can switch to an unrestricted environment where all Web objects already published and any new objects published become accessible for all users:
http://hostname/WebConsole/com.tivoli.webui.servlets.ConsoleMainwhere, the host name represents the machine where WebSphere is installed and configured. In this way, you bypass the authentication on the WebSEAL machine.
In the Preface, section "Using the Command Line", sub-section "Command Line Syntax", the syntax of the wweb command in the Notes section, point 2. should be changed to the following syntax:
wweb {-publish|-unpublish} -p publicName -v version [-i all | [-i interp]...] -w app_serv_ep_label [-w app_serv_ep_label]... [-c connSpeed] [-u all | [-u user]... [-U file]...] [-f|-n] @profile
In the same section, the command line syntax is shown with every option on a separate line. Replace the lines:
{-u all | -u user [-u user] ... } \ [-U userfile] ... \
with the following:
[-u all | [-u user]...[-U file]...]
Also, on the same page, from the list of bullets of what you must specify in the command, remove the following bullet:
Instead, add the following bullet in the list of bullets of what you can optionally specify in the command:
Chapter 7, "Administering the Web Interface", section "Making Web Objects Available", sub-section "Publishing and Unpublishing Web Objects", the syntax of the wweb command should be changed as follows:
wweb -publish -p publicName -v version {-i all | -i interp [-i interp] ... } \ -w app_server [-w app_serv_ep_label] ... [-c connspeed] \ [-u all | [-u user]...[-U file]...] [-f|-n] @profile
wweb -unpublish -p publicName -v version -w app_server [-w app_server] ... \ [-u all | [-u user]...[-U file]...] [-f|-n] @profile
Replace the descriptions for the { -u all | -u user [-u user ] ... } and [ -U userfile ] ... options with the following:
Chapter 2, "Planning a configuration management environment", section "Software requirements for the Web Gateway component", sub-section "Software requirements for Web access", add the following new section:
Unrestricted access to Web objects
You can also use the Web Interface component in a non-secure environment, that is, without installing and configuring the IBM Tivoli Access Manager and IBM Tivoli Access Manager WebSEAL security mechanisms. Running the Web Interface in a non-secure environment means that no authentication is performed when accessing Web objects. When publishing Web object, the administrator can choose to not specify user information so that the object published can be accessed by all users. Refer to the wweb command in the IBM Tivoli Configuration Manager: User's Guide for Deployment Services for more information about publishing objects with unrestricted access.
Defining the Activity Planner Engine Parameters
To improve product performance, you can define the engine tuning parameters and set the notify_ext_directly key for Software Distribution operations. This key allows the user to skip the notification manager queue and the Inventory database validation when notifying Activity Planner about Software Distribution activities, thus improving product performance. For more information on this key, refer to IBM Tivoli Configuration Manager: Reference Manual for Software Distribution.
In the [ENGINE_TUNING] section of the apm.ini file, you can customize the following parameters:
The data stored in the caches described above is updated only when the global_cache_refresh_timeout expires or when the Activity Planner engine is stopped and restarted.
The following new information applies to the IBM Tivoli Configuration Manager: User's Guide for Software Distribution.
Select the Force check box to specify that the reboot action on the endpoint must be forced. This option is valid only on Windows systems. This option interacts with the timeout option, as described in the following list:
The Timeout box specifies the number of seconds Software Distribution must wait before the reboot fails. If a retry interval occurs during this timeout, the distribution interrupts and the checkpoint and restart feature is used to retry later. The default value is -1. See "Checkpoint Restart Service for Network Failure or Power Interruptions" on page 187 for more information about the checkpoint and restart feature. See "Setting Timeout Values for a Distribution" on page 315 for more details about the timeout.
Customizing the Default Path
To customize the default path that the Software Package Editor launches when you select the browse button (...) from Software Package Editor dialogs, or when you open or save software packages, perform the following steps: default_file_path=directory_path
where directory_path represents the path automatically used by the
Software Package Editor open and save dialogs and the browser dialog.Cloning software packages from the Tivoli desktop
When cloning software packages from one profile manager to another using the drag-and-drop function, the cloned software package might not work correctly.
To clone a software package from one profile manager to another, perform the following steps:
You can also move a software package from one profile manager to another, by performing one of the following procedures:
The following information changes apply to the Internationalization Notes section of the Release Notes:
Valid characters in the activity plan name
The list of allowed characters is based on the standard Unicode 2.0. The valid characters in the activity name of APM plans are:
A character is considered to be a letter if and only if it is specified to be a letter by the Unicode 2.0 standard (category "Lu", "Ll", "Lt", "Lm", or "Lo" in the Unicode specification data file). Most ideographic characters are considered to be letters (Unicode category "Lo") for this purpose.
In Unicode 2.0 a character is considered to be a digit if it is NOT in the range '\u2000' <= ch <= '\u2FFF' and its Unicode name contains the word "DIGIT". These are the ranges of Unicode characters that are considered digits:
Number sign ( # ), plus sign ( + ), dash ( - ), question mark ( ? ), asterisk ( * ), open square bracket ( [ ) and closed square bracket ( ] ), period ( . ), tilde ( ~ ), underscore ( _ ), are allowed only in the English version.
The following information changes apply to the Software Package Editor Online Help documentation.
[ Top of Page | Previous Page | Next Page | Contents ]