Express Runtime console README

To install the Express Runtime console, see the Express Runtime console InfoCenter.

Known development issues
    Reinstallation of console module fails
    Reboot required if managing IBM DB2 UDB Express does not work
    Windows platforms only: Managing multiple IBM HTTP Server installations on one computer
    Console agent must be restarted after creating another WebSphere Application Server - Express profile

Documentation issues
    Supported Web browser required for documentation
    Help for console modules shown separately for some languages
    Eclipse configuration must be regenerated for documentation to be viewed

Messages
IRU10950

Known Development Issues

Reinstallation of console module fails

When you uninstall a console module (for example, DB2 UDB Express) and reinstall it using the Express Runtime deployment wizard, it might fail; the log message indicates a return code from the Integrated Solution Console. These return codes, and their meanings, are summarized in the following tables. If you get a return code of 104, verify that you have the user ID and password specified correctly, and restart the task. For all other return codes, contact your IBM Support Center representative.

ISCDeploy (INSTALL)

Return code	Explanation and recommended action
0	The Integrated Solutions Console component was deployed successfully (IscDeploy) or the prerequisite check was successful (IscPrereqChk).
1	A syntax error occurred.
2	The specified WAR file was not found. Specify the correct file path and filename.
3	The protocol or the context URL that you specified is not correct. Verify that the URL includes the correct protocol (http:// or https://). Specify deploy/deploy as the context URL.
4	The host name you specified is not valid or the Integrated Solutions Console server is not running. Verify that the URL includes the correct host name. Start the server before you issue the deploy command.
10	The correct parameters were not specified.
70	The process (deployment or prerequisite check) completed successfully.
71	The process (deployment or prerequisite check) did not complete successfully. This message usually indicates a problem with a portlet in the component WAR file. See your_isc_root\PortalServer\log\wps_date_time.log for messages that were logged before this return code was displayed. Use the time stamps in the file to locate those messages.
81	An error occurred while deploying the help files for the component. The attempt to copy the help files to the system has failed.
100	This component cannot be deployed, because it has been deployed already. If you want to deploy the component again, you can use IscReplace to update the component.
101	This component cannot be deployed, because it has a prerequisite component and the prerequisite has not been deployed. Deploy the prerequisite component and then deploy this component.
102	This component has a prerequisite component, but the wrong version of the prerequisite is deployed. Deploy the correct version of the prerequisite component and then deploy this component.
104	The Integrated Solutions Console administrator user ID, password, or both are not correct. Specify the correct values.
105	An internal error has occurred. A server-side file was not found. Be sure to specify the fully-qualified or relative file path and the WAR filename. Contact your service representative if the problem persists.
106	The component.xml file in the WAR file is not valid. Correct the file and repackage the WAR file.
108	An internal error has occurred. Contact your service representative.

ISCRemove (UNINSTALL)

Return code	Explanation and recommended action
0	The Integrated Solutions Console component was deployed successfully (IscRemove) or the prerequisite check was successful (IscDependencyChk).
1	A syntax error occurred.
3	The protocol or the context URL that you specified is not correct. Verify that the URL includes the correct protocol (http:// or https://). Specify deploy/deploy as the context URL.
4	The host name you specified is not valid or the Integrated Solutions Console server is not running. Verify that the URL includes the correct host name. Start the server before you issue the remove command.
84	An error occurred while removing the help plug-ins for this component. No action is required.
200	The component cannot be removed, because it is not deployed. Specify the component UID for a component that is deployed.
201	This component cannot be removed, because it is a prerequisite component for one or more components. Remove the dependent components before you remove this component.

ISCReplace (REINSTALL)

Return code	Explanation and recommended action
0	The Integrated Solutions Console component was replaced successfully.
1	A syntax error occurred.
2	The specified WAR file was not found. Specify the correct file path and filename.
3	The protocol or the context URL that you specified is not correct. Verify that the URL includes the correct protocol (http:// or https://). Specify deploy/deploy as the context URL.
4	The host name you specified is not valid or the Integrated Solutions Console server is not running. Verify that the URL includes the correct host name. Start the server before you issue the deploy command.
10	The correct parameters were not specified.
70	The replacement process completed successfully.
71	The replacement process did not complete successfully. This message usually indicates a problem with a portlet in the component WAR file. See the log file wps_date_time.log for messages that were logged before this return code was displayed. Use the time stamps in the file to locate those messages.
81	An error occurred while deploying the help files for the component. The attempt to copy the help files to the system has failed.
102	This component has a prerequisite component, but the wrong version of the prerequisite is deployed. Deploy the correct version of the prerequisite component and then deploy this component.
104	The Integrated Solutions Console administrator user ID, password, or both are not correct. Specify the correct values.
105	An internal error has occurred. A server-side file was not found. Be sure to specify the fully-qualified or relative file path and the WAR filename. Contact your service representative if the problem persists.
106	The component.xml file in the WAR file is not valid. Correct the file and repackage the WAR file.
108	An internal error has occurred. Contact your service representative.
200	The component cannot be replaced, because a component with the same component UID is not already deployed. Specify a WAR file for a component that is already deployed or use IscDeploy to deploy this component for the first time.

Reboot required if managing IBM DB2 UDB Express does not work

You might have to reboot the server in order to use the console for Express Runtime to administer IBM DB2 UDB Express. When administering remotely, Windows server operating systems do not pick up the environment variables correctly until you reboot, which means you cannot perform many of the database tasks.

If you cannot complete database tasks, reboot the server IBM DB2 UDB Express is installed on, and try again.

Windows platforms only: Managing multiple IBM HTTP Server installations on one computer

If you install the IBM HTTP Server on a system that already has it installed, only the last one installed is manageable by the the Express Runtime console.

If you want to manage more than one installation of IBM HTTP Server on the same system, you can do so by defining a service for the additional copies of IBM HTTP Server. This can be accomplished by executing the command in the directory where the IBM HTTP Server is installed:

\bin\apache -k install -n

The console then allows the designation of this IBM HTTP Server as a manageable Web server.

Console agent must be restarted after creating another WebSphere Application Server - Express profile

When a WebSphere Application Server - Express profile is created after the console agent has started for a system, the new WebSphere Application Server - Express profile will not be recognized until the console agent is stopped and restarted. Refer to the console InfoCenter for instructions on restarting the console agent.

Documentation issues

Supported Web browser required for documentation

A Web browser is required to view the documentation for this product. If no Web browser is available, the online documentation is not accessible.

Help for console modules shown separately for some languages

You might find that the help for the optional console modules (for example, IBM HTTP Server) is shown in the help navigation pane as a top-level entry in the table of contents, instead of within the console InfoCenter. The helps will still work, and the links between help pages and the InfoCenter will still function correctly. However, to locate help topics for the console module, you will have to open up its table of contents entry in the navigation pane.

Eclipse configuration must be regenerated for documentation to be viewed

If the documentation is not shown in the Eclipse help, you should restart Eclipse after removing the configuration information:

Delete the contents of the <ISC_install_dir>\PortalServer\ISCEclipse\configuration\org.eclipse.osgi directory.
Restart Eclipse.

Messages

IRU10950: The uninstallation of the {0} plug-in failed. Run {1} to uninstall the plug-in.

Explanation: The uninstallation of an Express Runtime console plug-in failed. Failure might be caused by any number of problems, including network problems, a corrupted installation registry, an incorrect user id or password, or other reason.
User Response: Manually run the uninstallation program that is listed in the message.

Express Runtime console README

Table of Contents