The following sections detail the steps required to install the PPS-N software. Section 3.1 details the terminology used for the configuration and deployment of the software. Section 3.2 outlines the assumptions for installing the software. While the system may be configured to run outside the given assumptions, doing so requires modifications that are not detailed in this document. Section 3.3 describes how to install and configure the Oracle databases. Section 3.4 describes installation and configuration of the VistA patches. Section 3.6 describes how to install and configure the PPS-N software in WebLogic. Finally, Section 3.7 describes how to upgrade an existing PPS-N v1.2 installation to PPS-N v1.3, thereby incorporating the VA mandate on two factor authentication (2FA). In order to understand the installation and verification process, the reader should be familiar with the WebLogic console shown in Figure 31. The WebLogic console is a Web page viewable from any Internet browser; however, Internet Explorer, Version 11, is recommended. The WebLogic console is generally divided into two columns. The left column contains the Change Center, the Domain Structure, and other informational panels. The right column displays panels containing additional options or configuration details. Note: With the exception of the Change Center and Domain Structure, all WebLogic console panels shown in the figures contained in this document are found in the right column of the WebLogic console. Whenever examples are given with the text, “For example,” the given value may be different depending on the specific server configuration. When the text, “For example,” is not provided, the text supplied must be entered exactly as specified for the PPS-N application to operate properly. Figure . WebLogic Console Terminology In an effort to make these installation instructions as general as possible for installation at any site, a few terms are used throughout the installation instructions with the intent that they be replaced with values. Table 31 contains a list of those terms used only within this document as well as sample site-specific values for each term. Table 31. Terminology Term Definition Sample Database Server Machine on which Oracle is installed and runs PPS-N-DB Deployment Server WebLogic managed server where PPS-N is deployed NationalPharmacyServer Deployment Server Port Port on which the Deployment Server is listening 8021
Table 34. Deployment Location Database Configuration Deployment Location Database Database Type Database Driver Transaction Options JNDI Name National FDB DIF Oracle Oracle’s Driver (Thin XA) Versions: 9.0.1 and later Supports Global Transactions datasource/FDB-DIF National EPL Oracle Oracle’s Driver (Thin XA) Versions: 9.0.1 and later Supports Global Transactions datasource/NationalEPL FSS MS SQL Server Microsoft’s MS SQL Server Driver (Type 4) Versions: 2005 Supports Global Transactions Emulate Commit datasource/PRE-FSS SDS Oracle Oracle’s Driver (Thin XA) Versions: 9.0.1 and later Supports Global Transactions Open and log on to the WebLogic console, using an administrative user name and password. The WebLogic console is located at: http://<Deployment Machine>:7001/console. Within the Domain Structure panel found in the left column of the WebLogic console, click on the Services > Data Sources node. For reference, see Figure 37. Figure . Domain Structure Click New in the Summary of JDBC Data Sources panel found in the right column of the WebLogic console and choose Generic Datasource from the drop down list. For reference, see Figure 38. Figure . Summary of JDBC Data Sources WebLogic will now display the panel Create a New JDBC Data Source in the right column of the console, where details of the new data source are set. For reference, see Figure 39. Figure . JDBC Data Source Properties For the Name, type a unique name. For example, FDB-DIF. For the JNDI Name, type the appropriate JNDI found in Figure 39. For example, datasource/FDB-DIF. For the Database Type, select the appropriate type found in Table 34. For example, Oracle. Click Next.
Verify that the State of the current PPS-N deployment is Active. For example, is in the Active state in Figure 329. The browser window may need to be refreshed multiple times before the deployment reaches the Active state. Instructions to Undeploy The following steps detail how to undeploy the PPS-N application: Open and log into the WebLogic console. This is located at: http://<Deployment Machine>:7001/console. Within the Domain Structure panel in the left column of the WebLogic console, click the Deployments node. Within the Change Center panel in the left column of the WebLogic console, click Lock & Edit. In the panel Summary of Deployments in the right column of the console, select the previously deployed PPS-N deployment, click Stop, and then select Force Stop Now from the drop-down list box. WebLogic will now display the panel Force Stop Application Assistant in the right column of the console for confirmation to start servicing requests. Click Yes in the Force Stop Application Assistant panel in the right column of the WebLogic console. WebLogic now returns to the Summary of Deployments panel in the right column of the console. Verify that the State of the PPS-N deployment is Prepared. Select the previously deployed PPS-N deployment, and then click Delete. WebLogic will now display the panel Delete Application Assistant in the right column of the console for confirmation to start servicing requests. Click Yes in the Delete Application Assistant panel in the right column of the WebLogic console. WebLogic now returns to the Summary of Deployments panel in the right column of the console. Verify that the PPS-N deployment is deleted and no longer present. Within the Change Center panel in the left column of the WebLogic console, click Activate Changes. Installation of FDB_Images FDB_Images is the name of the deployment that contains the images utilized by PPS-N for the display of images associated with various items within the application. FDB_Images is an open-directory type deployment that needs to be added to the server so that PPS-N works correctly. As a separate and deployment, this allows the modification of the image contents within the deployment, such as adding monthly image updates from First Data Bank. Deployment of FDB_Images Deploying the FDB_Images directory consists of the following: Click on the Deployments link national