Hitachi

uCosminexus Application Server System Setup and Operation Guide

3.2.1 Replacing the business application

This subsection describes the procedure for replacing a J2EE application with an archive format set in 2.2.10 Setting and starting the business application (when using GUI) for executing version upgradation and maintenance of the business application after starting a system operation.

Reference note

For details on the windows used in the description, see 5. Windows, Commands, and Files used in the System Setup and Operations.

Normally, when replacing J2EE applications, stop J2EE application operating on J2EE server, and delete the same. You must start by importing a new J2EE application. Use the management portal for these operations. The business application used in the description is a J2EE application with an archive format that includes cosminexus.xml. The following table describes the setting contents used in the example:

Table 3‒1: Setting contents used in example(replacing the business application)

Item

Setting example

File name of J2EE application before replacement

MyApp1.ear

File name of J2EE application after replacement

MyApp2.ear

Display name of J2EE application

MyApp
Organization of this subsection

(1) Startup and login of the management portal

Once you have already logged in to management portal, proceed to (2) Stopping J2EE application before replacement.

  1. Start the Web browser, connect to http://localhost:28080/mngsvr/index.jsp, and then start the management portal.

  2. Enter "admin" in the management user ID on the Login to Management Server window, and click the Login button.

To Page Top

(2) Stopping J2EE application before replacement

Once you are have logged in to the management portal, proceed to (3) Deleting J2EE application before replacement.

  1. Click Application management of the Logical server on Management Portal window.

  2. Click DefaultDomain-Logical J2EE server- J2EE server- MyJ2EEServer- Application, and then Start/Stop J2EE Application tab.

  3. In the Start/Stop J2EE application window, click the Stop anchor of Operation for display name of the application before replacement (MYApp) in the Import J2EE applications list.

  4. Click the Yes button in the Stop J2EE Application window.

  5. Check the Execution result, and click the Back anchor.

    If "Failure" is displayed in the Execution result, click the Display log tab, check the message in the Display Log window, remove the cause of the failure, and then stop the J2EE application again.

    When "Success" is displayed in the Execution result, the Status on the Start/Stop J2EE Application window changes to "Stopped".

To Page Top

(3) Deleting J2EE application before replacement

  1. Click Application management of the logical server on the Management Portal window.

  2. Click DefaultDomain - Logical J2EE Server - J2EE Server - MyJ2EEServer - Application, and then click the Delete tab.

  3. In the Delete J2EE application window, click the Delete anchor of Operation for display name of the application before replacement (MYApp) in the Import J2EE applications list.

  4. Click the Yes button in the Delete J2EE Application window.

  5. Check the Execution result, and click the Back anchor.

    If "Failure" is displayed in the Execution result, click the Display log tab, check the message in the Display Log window, remove the cause of the failure, and then delete again.

    If "Success" is displayed in the Execution result, the application is deleted from the Import J2EE application list in the Delete J2EE Application window.

To Page Top

(4) Setting J2EE Application after replacement

  1. Store the replaced J2EE Application (MyApp2.ear) acquired in Any-directory of Application Server.

  2. Click Application management of the Logical server on the Management Portal window.

  3. Click the DefaultDomain.

  4. Enter J2EE Application (MyApp2.ear) stored in Any-directory in Step 1 to J2EE application file on Upload J2EE Application window, and click the Upload button.

  5. Check the messages displayed, and click the Back anchor.

    If a message showing failure is displayed, remove the cause of the failure, and upload the J2EE application again.

    J2EE Application file name (MyApp2.ear) uploaded in step 4 is displayed in the Upload directory files list.

  6. Click DefaultDomain - Logical J2EE server - J2EE server - MyJ2EEServer - Application, and then click the Import tab.

  7. Select the file (MyApp2.ear) uploaded in step 4 from J2EE application files in import J2EE Application window, and click the Execute button.

  8. If "Success" is displayed in the Execution result, click the Back anchor.

    If "Failure" is displayed in the Execution result, click the Display log tab, check the message in the Display Log window, remove the cause of the failure, and then import the J2EE application again.

To Page Top

(5) Starting J2EE application after replacement

  1. Click Application management of the logical server on the Management Portal window.

  2. Click DefaultDomain - Logical J2EE server - J2EE server - MyJ2EEServer - Application, and then click the Start/Stop tab.

  3. In the Start/Stop J2EE Application window, click the Start anchor of Operation for the display name (MyApp) of J2EE applications imported in 4. Settings J2EE application after replacement in Import J2EE applications list.

  4. Click the Yes button on the Start J2EE Application window.

  5. Check the Execution result and click the Back anchor.

    If "Failure" is displayed in the Execution result, click the Display log tab, check the message in the Display Log window, remove the cause of the failure, and then start again.

    If "Success" is displayed in the Execution result, the status of the Start/Stop J2EE Application window changes to "Operating".

To Page Top

(6) Logout from the management portal

  1. Click the Logout anchor.

  2. Check the displayed message, click the Login window, and close the Web browser.

To Page Top

Trademarks

All Rights Reserved. Copyright (C) 2022, Hitachi, Ltd.