IBM Tivoli Monitoring > Version 6.3 Fix Pack 2 > Administrator's Guide > Edit your environment configuration settings > Tivoli Enterprise Portal client configuration settings

IBM Tivoli Monitoring, Version 6.3 Fix Pack 2

Portal client parameter list

Most of the Tivoli Enterprise Portal client parameters are left unchanged from their default values. Edit the client parameters to effect a specific behavior.

Some parameters pertain to the desktop client only, to the desktop client and Java WebStart client only, or to the browser client only and are noted as such.

browser.cache.memory.capacity

Indicates the maximum amount of memory in KB to be used to cache decoded images and other features by Browser views (a positive non-zero integer). Specify a value of 0 to disable memory caching. Default: -1, whereby the capacity value is automatically decided based on the total amount of memory.

Physical memory Memory cache in KB
32 MB 2048
64 MB 4096
128 MB 6144
256 MB 10240
512 MB 14336
1 GB 18432
2 GB 24576
4 GB 30720
8 GB and beyond 32768

cnp.agentdeploy.timeout

This is the time that should pass before the agent deploy request times out. Default: 1800 seconds (30 minutes).

cnp.attachment.segment.maxsize

For transmission across the network, file attachments are broken into segments then reassembled at the Tivoli Enterprise Portal Server. For example, an 8 MB file is transmitted in eight segments of 1 MB. Adjust this parameter for the segment size that best suits your environment. Enter the maximum size in bytes, such as 250000 for 250 KB. Default: 1000000 (1 MB).

This parameter is also available as a portal server environment variable. See Control the size of event attachments.

cnp.attachment.total.maxsize

Use this parameter to set the maximum size of each file attached to an acknowledgement. Enter the maximum size in bytes, such as 2500000 for 2.5 MB. Default: 10000000 (10 MB).

This parameter is also available as a portal server environment variable. See Control the size of event attachments.

cnp.authentication.skip_dns

Value: "N". This determines whether the server certificate validation tries to resolve and match the host DNS name.

cnp.browser.installdir

The WebRenderer Java browser component is used for browser view functionality in the portal client. The first time a user creates a browser view, a subdirectory is created automatically on the user's computer.

  • %HOMEPATH%\wrWebRendererVersion\.webrendererswing.
    Example: C:\Documents and Settings\Administrator\wr4.2.14\.webrendererswing

  • %HOME/wrWebRendererVersion/.webrendererswing

This subdirectory is where the browser jar files are extracted to and where certificates and other WebRenderer artifacts are created for browser views. Use this parameter to specify a different path for the browser view files to be saved on user computers. A different path is required if users will be running multiple instances of the portal client and possibly logging on to different versions of the portal server.

cnp.commonevent.cache.timeout

Number of minutes to retain the cache for the common event console when the user has switched to a workspace that does not contain the common event console view (which means the cache is not being used). If this time period ends before the cache is used again, the cache is cleared. The cache is then rebuilt when it is needed by a common event console view.

A value of -1 means always retain the cache, even when it is not being used. A value of 0 means immediately clear the cache when the user has switched to a workspace that does not contain the common event console view. Default: 30.

cnp.databus.pageSize

In the Tivoli Enterprise Portal user interface, the Properties editor has a field for adjusting the page size for individual query-based views. This parameter sets the number of rows to fetch in single logical page for all query-based views. Default: 100 rows. Although there is no limit to what you can set here, the larger the page size, the more memory required at the portal client and server.

You might, for example, want to set a larger page size for the searching in the table view over a larger number of rows. Or you might want fewer pages to scroll through when interacting with views that retrieve a large number of rows (or instances). You must make sure, however, that you have sufficient resources on the portal client and server to handle the additional data being packaged, transported, and ultimately rendered as a result of increasing the page size value. Probably the best way to find the right number here is to increase it gradually (such as increments of 100) until response time across a good sampling of workspaces begins to suffer. At that point, you might want to reduce the number by the last increment (such as 100 rows fewer) as that will be close to the optimal value for the environment.

Another setting that affects query-based view response time is KFW_REPORT_NODE_LIMIT, which is a portal server environment variable.

cnp.drag.sensitivity

Number of pixels the mouse must move before drag operation begins. Default: 7.

cnp.encoding.codeset

String encoding code set identifier.

cnp.eventcon.autoresume.delay

The number of seconds to wait before automatically resuming updates to the Situation Event Console and the Common Event Console after they have been paused due to scrolling. Default: 60 seconds.

cnp.heartbeat.interval

Heartbeat ping interval between the Tivoli Enterprise Portal client and server. An increase in the interval means that the client will take longer to detect when the portal server is offline. A shorter interval means the client will be notified sooner but it also increases the traffic between client and server. Default: 30 seconds.

cnp.history.depth

Number of workspaces to maintain in the back / forward history navigation stack. Default: 20.

cnp.http.proxy.password

Password used for proxy authentication using Browser view.

cnp.http.proxy.user

Userid used for proxy authentication using Browser view.

cnp.http.url.host

Desktop client and Java WebStart client only: URL host for IOR fetch.

cnp.http.url.path

Desktop client and Java WebStart client only: URL path for IOR fetch.

cnp.http.url.port

Desktop client and Java WebStart client only: URL port for IOR fetch.

cnp.http.url.protocol

Desktop client and Java WebStart client only: URL protocol for IOR fetch.

cnp.http.url.DataBus

Desktop client and Java WebStart client only: The URL for the cnps.ior file, which is required for the portal server to locate the graphic view images and style sheets. The default setting, which does not show, assumes the integral HTTP server. If it has been disabled for some reason, you must enter the URL for the integral HTTP server. See the IBM Tivoli Monitoring Troubleshooting Guide for details. When this parameter is set, it overrides the settings of the other cnp.http.url parameters for protocol, port, and path.

cnp.pipeline.factor

Databus to Server Pipeline monitoring factor (in Heartbeat cycles). Default: 2.

cnp.playsound.interval

Number of seconds before the same sound file can be played again. If events open frequently, this setting provides sound pause. Default: 10 seconds.

cnp.publishurl.delay

Browser client only: When you make a workspace switch, allows the user interface rendering to complete before the browser initializes the new applet and destroys the old applet. Default: 1 second.

Modify this parameter only after consulting IBM Software Support.

cnp.systemtray.offset

Tivoli Enterprise Portal factors in the Windows task bar at the bottom of the screen when sizing menus and windows for display. Default: true.

cnp.terminal.cache.entries

Maximum number of active terminal emulator sessions. Default: 50.

cnp.terminal.host

Default terminal emulator host name.

cnp.terminal.port

Default terminal emulator port number. Default: 23.

cnp.terminal.script.entries

Maximum number of user terminal emulator scripts that can be saved. Default: 256.

cnp.terminal.type

Default terminal emulator type. When specifying a terminal type, enclose the terminal type within double quotes and enter one of these supported names:

  • IBM 3270 (24x80)

  • IBM 3270 (32x80)

  • IBM 3270 (43x80)

  • IBM 3270 (27x132)

  • IBM 5250 (24x80)

  • VT100 (24x80)

cnp.view.change_remove.warning

Warning message when the user is about to change or remove a view.

Default: True. The message is displayed. Change the setting to False to stop the message from being displayed.

cnp.workspace.switch.rate

The minimum amount of time that must pass before the workspace can be replaced by the next one selected. Default: 1000 (1 second).

cnp.workspacerender.delay

Browser mode only: Workspace post render delay in milliseconds.

http:agent

Defines the name of the integral HTTP server. If it or its proxy requires a different browser identity before it enables the browser view to access the Internet, you can enter a one-word name for the browser. It can be any name so long as it is not rejected by the proxy server. You normally do not need to add an http name definition unless users get an error when they attempt to access the Internet through a workspace browser view.

http.nonproxyhosts

When Enable HTTP Proxy Server Requests is selected, the servers in this list bypass the proxy. Separate each server name with a vertical line (|). See Enable the HTTP proxy server.

http.proxyHost

Browser client: Used to specify the host name or IP address of the http proxy server if one is used.

http.proxyPort

Browser client: Used with the http.proxyHost parameter to specify the listening port number for the HTTP proxy server. Port 80 is the default for third-party HTTP servers.

kjr.browser.default

This is the path and name of the browser application to use when launching contextual help. To open the help with a specific browser or one other than the default, enter the path and the application name, such as C:\Program Files\Mozilla Firefox\firefox.exe.

kjr.trace.file

File name of RAS1 trace log if trace mode is LOCAL.

kjr.trace.mode

The RAS1 tracing option. Default: LOCAL.

kjr.trace.params

RAS1 trace options. Default: ERROR.

kjr.trace.qdepth

Sets the tracing thread queue depth to 15000 by default.

kjr.trace.thread

Determines whether trace calls are threaded. Default: true.

sun.java2d.noddraw

When the Tivoli Enterprise Portal is run as a client image in an emulation environment that does not support the DirectDraw screen-writing function, turn off the function by setting this variable to true in both the browser and desktop clients. Otherwise, users encounter conditions of high CPU usage because the Java process attempts to write to the screen. Default: true.

user.language

Desktop client and Java Web Start client only: Specifies the language code of the user's locale preference (such as cs, de, en, es, fr, hu, it, ja, ko, pl, pt, ru, th, and zh). You can create another instance of the desktop client and change this variable (and user.region) to another locale. In this way, you can have two or more instances of the desktop client running on the same computer, each in a different language. If you specify an unsupported locale, the failover is to en_US.

Browser client only: On the client computer, enter the text below directly into the Java plug-in runtime parameters used by the browser, where xx is the language and XX is the locale. 

    -Duser.language=xx -Duser.region=XX

The portal client uses cascading style sheets to render the application text. If no localized version of a style sheet, such as ws_press.css, is available, the English version will be used.

To edit the runtime parameters complete the following tasks:

  1. Open the Java control panel:

    Launch the IBM Control Panel for Java or the Java Control Panel.

    Find the Java ControlPanel executable under your jre_install_dir and launch it. For example: /opt/IBM/ibm-java2-i386-70/jre/bin/ControlPanel.

  2. Click the Java tab.

  3. In the Java Applet Run time Settings area, click View.

  4. If you have multiple Java versions, verify that you have the correct control panel open by reading the Location column to confirm the Java Run time and that the JRE is in the correct path. For example: C:\Program Files\IBM\Java70\jre\bin for IBM Java on Windows.

  5. Edit the parameter you want to change.

  6. Save your changes.

user.region

Specifies country code of user's locale preference (such as BR, CN, CZ, DE, ES, FR, HU, IT, JP, KR, PL, RU, TH, TW, and US). See also the description for user.language.
Use the following table to find language codes and locale codes:


Language and locale codes

Language Language code (xx) Locale code (XX)
Chinese, Simplified zh CN
Chinese, Traditional zh TW
Czech cs CZ
English en US
French fr FR
German de DE
Hungarian hu HU
Italian it IT
Japanese ja JP
Korean ko KR
Polish pl PL
Portuguese, Brazilian pt BR
Russian ru RU
Spanish es ES
Thai th TH


Parent topic:

Tivoli Enterprise Portal client configuration settings

Related tasks:

Edit the client parameters
Control the size of event attachments
Start the browser client on another portal server

Related reference:

Portal server environment variables

+

Search Tips   |   Advanced Search