![[Contents]](FIGURE/CONTENT.GIF)
uCosminexus Application Server, System Setup and Operation Guide
![[Glossary]](FIGURE/GLOSS.GIF)
![[Index]](FIGURE/INDEX.GIF)
![[Back]](FIGURE/FRONT.GIF)
![[Next]](FIGURE/AFTER.GIF)
This subsection separately describes the notes on the installation and un-installation of component software for the times at which the operations are performed.
| Classification | Component software | Notes | New installation | Update installation | Un-installation |
|---|---|---|---|---|---|
| Common to OSs | Component Container | If the installation directory has been created during the new installation of Component Container, make sure that there are no files in the installation directory. If there is a file or directory with the same name as the file or directory installed by the product, the file or directory is overwritten. As and when required, move the directory and files, create a backup, or change the installation destination.
|
Y | -- | -- |
When you perform an update installation with a different version (version upgrade) for Component Container, the following directories are deleted. If there are required files in these directories, save these files before update installation.
|
-- | Y | -- | ||
| When you perform an update installation with a different version (version upgrade) for Component Container, allocate double or more free space than the amount of disk space used by the work directory. | -- | Y | -- | ||
| To install or un-install Component Container, stop HTTP Server. If you perform the installation or un-installation operation without stopping HTTP Server, you cannot update or un-install the redirector and Performance Tracer normally. | Y | Y | Y | ||
| To install or un-install Component Container, Component Container, stop the J2EE server, Web container server, and CORBA Naming Service. | Y | Y | Y | ||
When you perform an update installation with a different version (version upgrade) for Component Container, un-install the following component software if installed. However, in order to inherit the environment, do not delete the directories of the un-installed component software.
|
-- | Y | -- | ||
| Component Container - Redirector | To install or un-install the redirector functionality, stop HTTP Server. If you perform the installation or un-installation operation without stopping HTTP Server, you cannot update or un-install the redirector and Performance Tracer normally. | Y | Y | Y | |
| Common to Windows | Component Container | When you install Component Container, do not specify a path containing # (hash mark) in the name of the Application Server installation directory. | Y | Y | -- |
| Component Transaction Monitor | To install Component Transaction Monitor, you require the size specified in the disk occupancy. This size includes the temporary area required for the installation operation. If an attempt is made to install Component Transaction Monitor on a disk where this size has not been allocated, the installation processing will be interrupted when the free disk space becomes 5% or less. At this time, you can either allocate the free disk area, or cancel the installation operation. If you allocate the free disk area, the installation terminates normally. If you cancel the installation operation, delete all the files that are partially installed. Depending on the progress of the installation operation, you must un-install Component Transaction Monitor, or manually delete everything under the installation directory of Component Transaction Monitor. | Y | -- | -- | |
| Developer's Kit for Java | When you perform an update installation for Developer's Kit for Java, the files under Application-Server-installation-directory\jdk\ are initialized. Save the required files in advance. However, the following files need not be saved because the files before update installation are stored in the same directory with optional names (file-name_version-number_date-time):
|
-- | Y | -- | |
| HTTP Server | Before the following HTTP Server operations, stop the Cosminexus HTTP Server service:
|
-- | Y | Y | |
| Before un-installing HTTP Server, delete the services registered with the httpsd command. | -- | -- | Y | ||
| With the un-installation of HTTP Server, even the files with read-only attributes are deleted. | -- | -- | Y | ||
| Performance Tracer | To install Performance Tracer, you require the size specified in the disk occupancy. This size includes the temporary area required for the installation operation. If an attempt is made to install Performance Tracer on a disk where this size has not been allocated, the installation processing will be interrupted when the free disk space becomes 5% or less. At this time, you can either allocate the free disk area, or cancel the installation operation. If you allocate the free disk area, the installation terminates normally. If you cancel the installation operation, delete all the files that are partially installed. Depending on the progress of the installation operation, you must un-install Performance Tracer, or manually delete everything under the installation directory of Performance Tracer. | Y | -- | -- | |
| Windows x86 | DABroker Library | You can perform an update installation for an environment where either stand-alone DABroker or DABroker included with the Application Server products is installed. However, the following functionality provided by the already installed stand-alone DABroker, or DABroker included with the Application Server products can no longer be used:
|
-- | Y | -- |
| In an environment where DABroker Library is installed, you can only perform an update installation with the same version (overwrite) for the stand-alone DABroker. | -- | Y | -- | ||
| You cannot install DABroker Library on a network drive. | Y | -- | -- | ||
| Web Services - Security | In an environment where Web Services - Security is installed, if one of the following products is already installed, un-install these products, and then install Web Services - Security:
|
Y | -- | -- | |
| Common to UNIX | Component Container | The Component Container installation directory is fixed to /opt/Cosminexus/CC. | Y | -- | -- |
| When you install Component Container, some files are affected by umask. Specify an appropriate umask. | Y | -- | -- | ||
| When you perform an update installation for Component Container, and if the installation directory is changed, this installation becomes a new installation. | -- | Y | -- | ||
You cannot install Component Container in an environment where the following component software, from among the component software provided until Application Server Version 6, is installed :
|
Y | Y | -- | ||
| Web Services - Base is component software provided until Application Server Version 6. When you perform an update installation for Component Container in the latest Application Server version while Web Services - Base is installed, the operation mode is migrated. Therefore, see Appendix A Migrating SOAP Applications in the uCosminexus Application Server SOAP Application Development Guide to migrate the operation mode. | -- | Y | -- | ||
| Component Container - Redirector | The installation directory of the redirector functionality is fixed to /opt/Cosminexus/CCR. | Y | -- | -- | |
| When you install the redirector functionality, some files are affected by umask. Specify an appropriate umask. | Y | -- | -- | ||
| Developer's Kit for Java | When you perform an update installation for Developer's Kit for Java, all the files in opt/Cosminexus/jdk are deleted. Save the required files in advance. However, the following files need not be saved because the files before update installation are stored in the same directory with optional names (file-name_version-number_date-time):
|
-- | Y | -- | |
| HTTP Server | To re-install HTTP Server in a system where the server is already installed, you can perform an update installation (overwrite) with the same version. At this time, before you install HTTP Server, end the operations for all the programs and related files of HTTP Server. | -- | Y | -- | |
| If the config file already exists when you install HTTP Server, the server is installed with a version number-assigned optional name. | Y | Y | -- | ||
| If /opt/hitachi/httpsd/htdocs/index.html already exists when you install HTTP Server, the file is overwritten. | Y | Y | -- | ||
| When you perform an update installation with the same version (overwrite) for HTTP Server, we recommend that you save the files to be used after re-installation (config files such as httpsd.conf and sslc.cnf, and user-created contents) in advance. | -- | Y | -- | ||
| If an HTTP Server installation using the PP installer fails, confirm whether the operations for all the programs and related files of HTTP Server are terminated and then re-install HTTP Server. Also, if there is a file with the same name as a directory provided with HTTP Server, the installation might fail. Make sure that a file with the same name does not exist in /opt/hitachi/httpsd, and then re-install HTTP Server. | Y | -- | -- | ||
| When you perform an update installation with a different version (version upgrade) from Web Server to HTTP Server, the files, directories, and some utilities related to the HTML manuals and GUI server management functionality of the previous version might remain behind without being deleted. The use of these files is not supported. | -- | Y | -- | ||
| When you un-install HTTP Server, all the files under /opt/hitachi/httpsd are deleted. Save the required files in advance. | -- | -- | Y | ||
| Web Services - Security | If XML Security version 6 or earlier is already installed in an environment where you install Web Services - Security, un-install XML Security, and then install Web Services - Security. | Y | -- | -- | |
| XML Processor | When you perform an update installation with the same version (overwrite) for XML Processor, delete all the files in /opt/Cosminexus/jaxp once. Therefore, save the files required after overwrite installation in advance. | -- | Y | -- |
| Classification | Component software | Notes | New installation | Update installation | Un-installation |
|---|---|---|---|---|---|
| Common to Windows | HTTP Server | When performing an update installation with the same version (overwrite) for HTTP Server, if an error (such as a registry access error) occurs, un-install and then re-install HTTP Server. | -- | Y | -- |
| Classification | Component software | Notes | New installation | Update installation | Un-installation |
|---|---|---|---|---|---|
| Common to OSs | Component Container | When the environment is migrated by performing an update installation with a different version (version upgrade) for Component Container, the directory that was used in the earlier version is inherited and used as the work directory. Make sure you do not delete the earlier work directory version by mistake. | -- | Y | -- |
| If HTTP Server is un-installed and then re-installed without deleting the logical Web server on Management Server, the logical Web server managed by Management Server is not deleted, but the real server (Web server (HTTP Server)) is deleted. Therefore, after re-installation, the applicable logical Web server must be re-set up with Management Server. In this case, use the management portal to set up and allocate the logical Web server again. Also, a new httpsd.conf file is created or the existing file is overwritten when the logical Web server settings are allocated with the management portal. Therefore, if the httpsd.conf file was corrected manually, after you allocate the logical Web server settings with the management portal, correct the httpsd.conf file again, as and when required. Note that if the contents of the httpsd.conf file are edited and allocated with the Web Server Settings window of the management portal, the corrections are unnecessary. |
Y | -- | -- | ||
| Even if you perform an update installation with the same version (overwrite) for Component Container, DB Connector that is imported and allocated on Application Server is not updated. To update the imported and deployed DB Connector, execute the cjrarupdate command. The execution format of the cjrarupdate command is as follows: /opt/Cosminexus/CC/server/bin/cjrarupdate -type dbconnector For details, see cjrarupdate (Upgrading the resource adapter version) in the uCosminexus Application Server Command Reference Guide. |
-- | Y | -- | ||
| If there is no change in DB Connector when you execute the cjrarupdate command, the KDJE42249-W message is output. The output of this message is not a problem. | -- | Y | -- | ||
| Reliable Messaging | If you perform an update installation for Reliable Messaging, the request timeout value of the commands provided by Reliable Messaging returns to the default value (0). If you edit the batch files or shell script existing in the Application-Server-installation-directory/RM/bin directory, and change the request timeout value, set the value again. | -- | Y | -- | |
| If you execute the Reliable Messaging commands, the command runtime log is output to Application-Server-installation-directory/RM/logs. During un-installation, the log directory and files existing under this directory might remain behind. | -- | -- | Y | ||
| Common to Windows | Developer's Kit for Java | Even if you un-install Developer's Kit for Java, some of the files and directories might remain under Application-Server-installation-directory\jdk without being deleted. Manually delete the files and directories that are not deleted. | -- | -- | Y |
| During the update installation of Developer's Kit for Java, the installer does not delete the files stored with the optional names even if un-installed. Also, if you implement update installation repeatedly, the files stored with the optional names are created for the number of times the update installation is repeated. As and when required, delete the unnecessary files and directories. | -- | Y | Y | ||
| HTTP Server | With a new installation of HTTP Server, the startup type of the Cosminexus HTTP Server service is registered with "Manual". | Y | -- | -- | |
| With the un-installation of HTTP Server, the files and config files created after installation are not deleted. Also, the other files and directories might be retained without being deleted. | -- | -- | Y | ||
| Common to UNIX | Component Container | During the un-installation of Component Container, the /opt/Cosminexus/CC/spool directory was deleted in version 06-70 or earlier. However, in version 06-70 or later, this directory is retained. This directory is used to monitor the execution of the J2EE servers or Web container servers. You can delete this directory manually after un-installation. | -- | -- | Y |
All Rights Reserved. Copyright (C) 2012, 2013, Hitachi, Ltd.