HDM-IWE Hotfix Readme

Transcription

1

2 Description... 1 Resolved Issues... 1 Prerequisite... 1 Manifest... 2 Installation Instructions... 2 To prepare for the Intelligent Workflow Engine update... 2 To delete the existing Intelligent Workflow Engine application... 3 To start the Home Device Manager Managed Servers... 4 To install the Intelligent Workflow Engine application... 5 To verify that the Intelligent Workflow Engine hotfix installation was successful... 6 Uninstalling the Hotfix... 7 To roll back your Intelligent Workflow Engine hotfix... 7 Support and Contact Information... 7 Description Note: This hotfix is cumulative and includes changes from the following other hotfixes: IWE Resolved Issues The following issues are resolved in this hotfix: 66006: Caching of the Alarm Extension query Prerequisite Prerequisite version(s) for this hotfix: HDM or above 1

3 IWE Manifest Readme.html Server/iwe.ear Installation Instructions Perform one or more of the installation procedures listed below. For additional information on deployment, see the installation section of the Intelligent Workflow Engine Deployment Guide, version To prepare for the Intelligent Workflow Engine update 1. Back up all data and installation directories: a. Create a hot backup of the data in the HDM-Intelligent Workflow Engine OLTP database. This precaution enables rolling back the database to the previous version, if necessary. b. Create a backup of the application server directory on each host in the HDMDomain (for example, /opt/hdm). Each individual application server requires a backup and storage for rollbacks to bring the servers to the same state as before the upgrade was installed. 2. Back up the existing iwe.ear file file from /HDMDomain/. 3. Stop all Managed Servers: a. Log in to the BEA WebLogic Server Console. i. In a browser, go to the following URL: adminhost.yourcompany.com is the address of the host on which the Administration Server is installed is the domain-wide administration port of the Administration Server. The login page appears. ii. To log in, type the credentials for your server administration account into the Username and Password boxes, and then click Log In. 2

4 Note The Application Server Administrator account was created during the installation of the WebLogic Administration Server. b. From the directory tree (on the left), expand the Environment, click Clusters. The Summary of Clusters page is displayed. c. Click the HDMCluster link. The Settings for HDMCluster page is displayed. d. Click the Control tab and select the check box next to Server. This means you are selecting all servers in the cluster. e. Click the Shutdown button, and then select When work completes. You can alternatively choose the Force Stop Now option if you wish to stop the servers immediately without waiting. A confirmation dialog appears. f. Click Yes to proceed. The process may take several minutes. If the process appears to hang, use the Force Stop Now option instead, if you did not already choose this option above. g. Before proceeding, confirm that the state of the Managed servers appear as SHUTDOWN in the table. 4. On each Manage Server host, verify that all Managed Server processes are stopped using this command: ps -ef grep install_dir where install_dir is the name of the directory in which the Home Device Manager is installed on the host. No Managed Server process should appear in the output. To delete the existing Intelligent Workflow Engine application 1. Log in to the BEA WebLogic Server Console: a. In a browser, go to the following URL: adminhost.yourcompany.com is the address of the host on which the Administration Server is installed is the domain-wide administration port of the Administration Server. The login page appears. b. To log in, type the credentials for your server administration account into the Username and Password fields, then click Log In. 3

5 Note The Application Server Administrator account was created during the installation of the WebLogic Administration Server. 2. In the left panel of the console, click Deployments, then click Lock & Edit. The Summary of Deployments page appears on the right. 3. On the Summary of Deployments page, select the check box next to the Intelligent Workflow Engine application (iwe). 4. Click the Delete button. A confirmation dialog appears. 5. Click Yes to proceed. 6. In the left panel of the console, click the Activate Changes button. 7. Before proceeding, confirm that the Intelligent Workflow Engine application does not appear on the Summary of Deployments page. To start the Home Device Manager Managed Servers 1. Log in to the BEA WebLogic Server Console: a. In a browser, go to the following URL: adminhost.yourcompany.com is the address of the host on which the Administration Server is installed is the domain-wide administration port of the Administration Server. The login page appears. b. To log in, type the credentials for your server administration account into the Username and Password fields, then click Log In. Note The Application Server Administrator account was created during the installation of the WebLogic Administration Server. 2. From the directory tree (on the left), expand the Environment, click Clusters. The Summary of Clusters page appears. 3. Click the HDMCluster link. The Settings for HDMCluster page appears. 4. Click the Control tab and select the check box next to Server. This means you are selecting all servers in the cluster. 5. Click the Start button. A confirmation dialog appears. 4

6 6. Click Yes to proceed. The process may take several minutes. 7. Before proceeding, confirm that the state of the Home Device Manager Managed Servers appear as RUNNING in the table. To install the Intelligent Workflow Engine application 1. From the HDM-Intelligent Workflow Engine Hotfix CD, copy the iwe.ear file (located in the /Server/ directory) into the /HDMDomain/ directory on the Administration Server host. 2. Log in to the BEA WebLogic Server Console: a. In a browser, go to the following URL: adminhost.yourcompany.com is the address of the host on which the Administration Server is installed is the domain-wide administration port of the Administration Server. The login page appears. b. To log in, type the credentials for your server administration account into the Username and Password boxes, and then click Log In. Note The Application Server Administrator account was created during the installation of the WebLogic Administration Server. 3. In the left panel of the console, click Deployments, then click Lock & Edit. The Summary of Deployments page appears on the right. 4. On the Summary of Deployments page, click the Install button. The Install Application Assistant page appears on the right. 5. Using the file browser under the Location area, navigate to the /HDMDomain/ directory that has the Intelligent Workflow Engine application (iwe.ear). 6. Click the radio button next to the iwe.ear file. Click Next to proceed. 7. On the Choose targeting style page, choose the Install this deployment as an application option. Click Next to proceed. 8. On the Select deployment targets page, select the All servers in the cluster option. Click Next to proceed. 9. On the Optional Settings page: 5

7 For the Security section, choose DD Only: Use only roles and policies that are defined in the deployment descriptors option. For the Source Accessibility section, choose Copy this application onto every target for me option. 10. Click the Finish button to complete the installation. This process may take a few minutes. Before proceeding, confirm that the state of the Home Device Manager application appears as New in the table. 11. In the left panel of the console, click the Activate Changes button. This process may take a few minutes. Before proceeding, confirm that the state of the Home Device Manager application appears as Prepared in the table. 12. On the Summary of Deployments page, select the check box next to the Intelligent Workflow Engine application. 13. Click the Start button, and then click the Servicing all requests option. A confirmation dialog appears. 14. Click Yes to proceed. This process may take a few minutes. Confirm that the state of the Intelligent Workflow Engine application appears as Active in the table. To verify that the Intelligent Workflow Engine hotfix installation was successful 1. Verify the version number: a. In a browser, go to the HDM Management Console at the following URL: or hdm.yourcompany.com is the host name for one of the following: Load balancer that fronts the HDMCluster of Managed Servers in the application tier. Instance of the Managed Server in the application tier is the SSL port for the host is the non-ssl port for the host. The login page appears. b. In the upper-left corner, pause on the product name, Home Device Manager - Intelligent Workflow Engine. A tooltip appears with the following version information: Intelligent Workflow Engine Hotfix Version 6

8 c. Log in by typing your credentials, and then click Log On. 2. By completing each of the steps above and yielding the expected results, you are done with the required installation steps for this hotfix. If the procedure above does not yield the expected results, there is a problem with the installation. In that case, roll the installation back according to To roll back your Intelligent Workflow Engine hotfix section. Uninstalling the Hotfix To roll back your Intelligent Workflow Engine hotfix 1. Before uninstalling components on a Solaris host: a. Be sure to preserve the backup you created from your existing installation during the initial hotfix installation. b. Back up all data in the HDM-IWE OLTP database. 2. Stop Intelligent Workflow Engine application. This is described in Step 4 of the section To prepare for the Intelligent Workflow Engine update. 3. Delete the new Intelligent Workflow Engine application by using the procedure described in section To delete the existing Intelligent Workflow Engine application. 4. Reinstall the Intelligent Workflow Engine application using the iwe.ear file from the backup that you made prior to upgrade. Use the procedures described in the section To install the Intelligent Workflow Engine application. Support and Contact Information If you encounter issues with this product, visit the Online Customer Support (OLCS) [ web site. After registering and logging on, you can access troubleshooting information. In addition, you can contact Alcatel-Lucent Motive Support by phone, fax, or , as follows: Toll-free phone (within U.S.): , option 1 Outside U.S.: (United States) Fax: support@motive.com [mailto:support@motive.com] 7

9 The Motive Product Group and its parent company, Alcatel-Lucent, are interested in feedback about your experience with this product and its documentation. If you have comments or suggestions, send to Copyright 2010 Alcatel-Lucent. All rights reserved. 8