IBM Performance Management

Creating workspaces

Place the Tivoli® Enterprise Portal in the Administrator mode to create workspaces that you can export and include in your solution.

About this task

Build the workspaces in the environment from which they are used. When you build workspaces, change the display settings on your computer to build workspaces at the minimum resolution that is normally used in your environment. Building workspaces at a greater resolution can create views that are too cluttered to be used reasonably at lesser resolutions.

To create workspaces that you can export and include in your solution, the Tivoli Enterprise Portal must be placed in the "Administrator" mode. To place the Tivoli Enterprise Portal in "Administrator" mode, use the following steps:

Procedure

Go to the ITM_INSTALL/CNP directory and open the cnp.bat file. If you used the default installation, the directory is C:\IBM\ITM\CNP. In the cnp.bat file, you must update the set _CMD= %_JAVA_CMD% line to include option -Dcnp.candle.mode="$_KCJ_$".
If you want to create extensions on Linux or AIX® systems, use the following path:
```
/opt/IBM/ITM/li263/cj/bin/cnp.sh
```
Where li263 is the operating system on which the Tivoli Enterprise Portal is running.
The updated set _CMD= %_JAVA_CMD% looks similar to the following example:
```
set _CMD= %_JAVA_CMD% -Dcnp.candle.mode="$_KCJ_$" -Xms64m -Xmx256m -showversion -noverify
 -classpath %CPATH% -Dkjr.trace.mode=LOCAL -Dkjr.trace.file=C:\IBM\ITM\CNP\LOGS\kcjras1.log 
-Dkjr.trace.params=ERROR -DORBtcpNoDelay=true -Dibm.stream.nio=true 
-Dice.net.maxPersistentConnections=16 -Dice.net.persistentConnectionTimeout=1 
-Dcnp.http.url.host=SKINANE -Dvbroker.agent.enableLocator=false  -Dnv_inst_flag=%NV_INST_FLAG% 
-Dnvwc.cwd=%NVWC_WORKING_DIR% -Dnvwc.java=%NVWC_JAVA% candle.fw.pres.CMWApplet 
```
Note: The command is shown here on multiple lines for formatting reasons only.
Open a new Tivoli Enterprise Portal Client, and log in with the sysadmin user ID.
Set the "sysadmin" user ID in Administrator mode. In the Tivoli Enterprise Portal, select Edit > Administer Users. Select sysadmin and then under the Permissions tab, select Workspace Administration. Select the Workspace Administration Mode check box. If you make the selection correctly, *ADMIN MODE* is displayed in the desktop title bar.
Figure 1. Setting the sysadmin user ID

Figure 2. Setting the sysadmin user ID (continued)

Figure 3. Setting the sysadmin user ID (continued)

What to do next

After you are in Administrator mode as depicted in (Figure 3), you are now ready to create workspaces for your application. For information about how to customize and create workspaces, see the Tivoli Enterprise Portal User's Guide online at the IBM® Tivoli Monitoring Information Center. Alternatively, use the help documentation that is installed with your Tivoli Enterprise Portal component.

If you want your workspaces to be read-only and to not be deleted by a customer, set the not-editable and non-deletable properties for each workspace. In the workspace properties, you must select the following properties:

Do not allow modifications
Product-provided by IBM (mark as non-deletable)

You can go to the properties by either viewing a workspace or clicking the icon with the controls on it. You can also go to one of the view property pages and then going to the workspace level in the properties tree. If you have more than one workspace for each navigator item, remember to set the properties for each workspace. As indicated in the following example screen capture:

Figure 4. Setting workspace properties

Tivoli Enterprise Portal window with the properties icon highlighted

Figure 5. Setting workspace properties (continued)

Properties window for AVAILABILITY workspace with the Do not allow modifications and Product-provided by IBM (mark as non-deletable) cleared and highlighted