2 Installation and Setup

The RIHA installation chapter widely focuses on ADF 11g runtime installation and deploying the tool's EAR file. For more information about domain creation and other server related information, see the WebLogic application server documents.

Installation and Setup Instructions

This section describes the installation and setup instructions including the installation prerequisite, preparing the WebLogic server, creating a WebLogic domain, verifying installation of ADF runtime libraries, extending an existing domain to add ADF run-time libraries, and deploying the EAR file. It also describes the security setup guidelines.

Note: The screen captures included in the following procedures are for example only. Because these procedures must be followed for each application, valid values will vary. Therefore, consider the illustrations as guides only; the values shown may not always apply.

Installation Prerequisite

The RIB Hospital Administration(RIHA) requires Oracle WebLogic Server 11g (10.3.6) and built with Java 7 (JDK 1.6.0_18+ 64 bit or later, within the 1.6 code line. 64 bit, for Linux and Solaris OS only).

Important: If there is an existing WebLogic 10.3.5 installation on the server, you must upgrade WebLogic 10.3.5 to WebLogic 10.3.6. All middleware components associated with WebLogic server 10.3.6 should be upgraded to 11.1.1.6. Back up the weblogic.policy file ($WLS_HOME/wlserver_10.3/server/lib) before upgrading your WebLogic server, because this file could be overwritten. Copy over the weblogic.policy backup file after the WebLogic upgrade is finished and the post patching installation steps are completed. For upgrading your WebLogic server to 10.3.6 use the Upgrade Installer (installers starting with the name wls1036_upgrade

Prepare the WebLogic Server

To get the ADF runtime option while creating a domain, download the Application Development Runtime-11.1.1.6.0 from http://www.oracle.com/technetwork/index.html.

1. Unpack the downloaded Application Development Runtime-11.1.1.6.0 and run the installer. The Installer Welcome screen opens.

   
   

2. Click Next.

   • Installer performs the prerequisite checks and ensures all required prerequisites are met.

   
   

3. Click Next. The Specify Installation Location screen opens.

   
   

4. Select the Oracle Middleware Home from where the WebLogic server instance hosting RIHA applications will run.

5. Click Next. The Installation Summary screen opens.

   
   

6. Click Install.

   • The installation progress is displayed.

   
   

7. Click Next. The Installation Complete screen opens once the installation is complete.

   
   

8. Click Finish.

Creating a WebLogic Domain with ADF Runtime Libraries

This section describes the steps to create a new WebLogic domain with ADF runtime libraries.

1. Run quick start from the Oracle Middleware home located under Utils folder.

   • The WebLogic Platform Quick Start screen opens.

   
   

2. Select Getting started with WebLogic Server.

   • The Fusion Middleware Configuration Wizard opens.

   
   

3. Select Create a new WebLogic domain. The domain source window screen opens.

   
   

4. Select the Oracle JRF - 11.1.1.0 checkbox. Click Next.

   
   

5. In the Domain name field, enter the domain name.

6. In the Domain location field, enter the domain location or click Browse to select a domain location.

7. Click Next.

   
   

8. In the Name field, enter the user name.

9. In the User Password field, enter a password for the user.

10. In the Confirm user password field, enter the password again.

11. In the Description field, enter a description for the user (optional).

    • Click Discard Changes (above the Name field) to reset the fields.

12. Click Next. The server configuration screen opens.

    
    

13. In the WebLogic Domain Startup Mode section, select Production Mode.

    • The available JDKs are listed in the JDK Selection section.

14. Select a JDK from the available JDKs.

    • Click Other JDK to browse and select a JDK of your choice.

15. Click Next. The Select Optional Configuration screen opens.

    
    

16. Select the Managed Servers, Clusters and Machines checkbox to add a managed server for the domain.

17. Select the Deployments and Services checkbox to add ADF runtime libraries to the managed server for the domain.

18. Click Next. The Configure Managed Servers screen opens.

    
    

19. Click Add to add a managed server and edit the name and ports of the managed server.

20. Click Next. The Configure Clusters screen opens.

    
    

21. Click Add and configure the clusters if needed.

22. Click Next. The Configure Machines screen opens.

    
    

23. Click Add and configure the machines.

24. Click Next. The Target Deployments to Clusters or Servers screen opens.

    
    

25. Select the created cluster or server (new_managedServer_1, in this example) in the left pane.

26. Select the applications in the right pane to target them to the selected cluster or server.

27. Click Next. The Target Services to Clusters or Services screen opens.

    
    

28. Select the clusters or servers in the left pane.

29. Select the services in the right pane to target them to the selected clusters or servers.

30. Click Next. The Configuration Summary screen opens.

    
    

31. Click Create. The Creating Domain screen opens.

    
    

32. Click Done. The domain and managed servers with ADF runtime is created.

Verify Installation of ADF Runtime Libraries

This section describes the steps to verify the installation of ADF runtime libraries.

1. Start the server and log on to the console.

   
   

2. In the Domain Structure section, click Deployments. The deployed libraries are listed.

3. Click on the ADF libraries.

   
   

4. Click the Targets tab and verify that the created server is selected for that library.

Extending an existing domain to add ADF run-time libraries

This section describes the steps to extend an existing domain to add ADF runtime libraries.

1. Run quick start from the Oracle Middleware home located under Utils folder.

   • The WebLogic Platform Quick Start screen opens.

   
   

2. Select Getting started with WebLogic Server.

   • The Fusion Middleware Configuration Wizard opens.

     
     

3. Select Extend an existing WebLogic domain.

4. Click Next. The Select a WebLogic Domain Directory screen opens.

   
   

5. Select the domain that requires ADF runtime libraries.

6. Click Next. The Select Extension Source screen opens.

   
   

7. Select the Oracle JRF-11.1.1.0 checkbox to add ADF run-time libraries.

8. Click Next. The Select Optional Configuration screen opens.

   
   

9. Select the Managed Servers Clusters and Machines checkbox to create managed servers, if a managed server needs to be created.

10. Select the Deployments and Services checkbox to add ADF run-time.

11. Click Next. The Configure Managed Servers screen opens.

    
    

12. Click Add to add a managed server and edit the name and ports of the managed server.

13. Click Next. The Configure Clusters screen opens.

    
    

14. Click Add and configure the clusters if needed.

15. Click Next. The Configure Machines screen opens.

    
    

16. Click Add and configure the machines.

17. Click Next. The Target Deployments to Clusters or Servers screen opens.

    
    

18. Select the clusters or servers in the left pane.

19. Select the services in the right pane to target them to the selected clusters or servers.

20. Click Next. The Configuration Summary screen opens.

    
    

21. Click Create. The Extending Domain screen opens.

    
    

22. Click Done. The domain is extended to add ADF run-time libraries.

Deploying RIHA ear File from RIB-HOME

This section describes the steps to deploy RIHA ear from rib-home. Single RIHA ear file is used for all the rib-apps and deployment is supported only from rib-home.

To deploy RIHA app from rib-home:

1. Download RibHospitalAdministration-Web-14.0.0 for all 14.x.xApps_eng_ga.tar and extract it to RIB_INSTALL/rib-home/tools-home.

2. Go to the location rib-home/tools-home/riha/conf

3. Edit the riha-deployment-env-info.properties with riha-admin-server-connection-url value

   Ex: riha-admin-server-connection-url=t3://host:portto the location rib-home/tools-home/riha/conf

   1. Edit target server name where RIHA app should be deployed.

      Ex: riha-wls-target-name=AdminServer

      This means riha app will deploys to AdminServer.

      Ex: riha-wls-target-name=m1

      This means riha app will deploys to Managed Server 'm1'.

   2. Edit cluster name where RIHA app should be deployed.

      If no cluster is configured then enter cluster name as ”no_cluster”

      Ex:riha-wls-cluster-name=no_cluster

      If any cluster is configured then enter the name of the cluster.

      Ex:riha-wls-cluster-name=New_Cluster_1

4. Compile the riha-app. Security credentials get configured while compiling with the following command:

   tools-home/riha/bin: ./riha-app-compiler.sh -setup-security-credential

   
   

5. Prepare Weblogic for RIHA deployment: by executing this step all the datasource required by RIHA application will be created based on the number of applications in scope of rib-deployment-info.xml and user information required for riha app to login will be created (RihaAdminGroup and user entered in riha compilation phase) tools-home/riha/bin: ./riha-app-deployer.sh -prepare-wls.

6. Deploy RIHA app by executing tools-home/riha/bin: ./riha-app-deployer.sh -deploy-riha-app

7. If needed you can undeploy RIHA by executing tools-home/riha/bin: ./riha-app-deployer.sh -undeploy-riha-app

Testing the Deployment

This section describes the steps to test the deployment.

Navigate to the post deployment screen.

1. Click the Control tab.

   
   

2. Select the application. Click Start.

   
   

3. Click Yes.

   
   

   • The deployed tool is started successfully.

   
   

4. Click on the Testing tab and expand the deployed tool to access the URL of the tool.