Diagnosing Typical Problems Oracle Fusion Middleware Online Documentation Library

Deploying Applications 10-3 Services Manager, use an MDS Repository. For information about the MDS Repository and registering the repository, see Section 14.3 .

10.1.2 Understanding Deployment, Redeployment, and Undeployment

When you deploy an application, you deploy it to the application server for the first time. When you redeploy an application, you can: ■ Redeploy a new version of the application; the previous version is still available, but the state is set to Retired. This is known as the production redeployment strategy. Oracle WebLogic Server automatically manages client connections so that only new client requests are directed to the new version. Clients already connected to the application during the redeployment continue to use the older version of the application until they complete their work, at which point Oracle WebLogic Server automatically retires the older application. ■ Redeploy the same version of the application or redeploy an application that is not assigned a version; the application version you select is replaced with the new deployment. ■ Redeploy a previous version of the application; the earlier, retired version is set to Active and the later version is set to Retired. When you undeploy an application, Oracle WebLogic Server stops the application and removes staged files from target servers. It does not remove the original source files used for deployment.

10.2 Understanding and Managing Data Sources

A data source is a Java object that application components use to obtain connections to a relational database. Specific connection information, such as the URL or user name and password, are set on a data source object as properties and do not need to be explicitly defined in an applications code. This abstraction allows applications to be built in a portable manner, because the application is not tied to a specific back-end database. The database can change without affecting the application code. Applications use the Java Naming and Directory Interface JNDI API to access a data source object. The application uses a JNDI name that is bound to the data source object. The JNDI name is logical and can be mapped to any data source object. Like data source properties, using JNDI provides a level of abstraction, since the underlying data source object can change without any changes required in the application code. The end result is the details of accessing a database are transparent to the application. Note: If your application contains an application-level credential store, and you are moving the application from a test to a production environment, you must reassociate the credential store, as described in Reassociating the Domain Policy Store in the Oracle Fusion Middleware Application Security Guide. See Also: Oracle Fusion Middleware Configuring and Managing JDBC for Oracle WebLogic Server for more information about data sources 10-4 Oracle Fusion Middleware Administrators Guide When you configure certain Oracle Fusion Middleware components, such as Oracle SOA Suite or Oracle WebCenter, using the Oracle WebLogic Server Configuration Wizard, you specify the data source connection information. If the components use the MDS Repository, the Configuration Wizard prepends mds- to the data source name to indicate that the data source is a system data source used by MDS Repository. If you are using Oracle Real Application Clusters Oracle RAC or Oracle Fusion Middleware Cold Failover Cluster, you must configure multi data sources. To do so, you must use the Oracle WebLogic Server Administration Console. Note that if you create a multi data source and you add an existing MDS data source to it, the data source you added is no longer considered a valid MDS Repository. The repository is not displayed in Fusion Middleware Control or Oracle WebLogic Server Administration Console. For example, the MDS Repository is not listed in the Fusion Middleware Control navigation pane and is not displayed as a choice for a target metadata repository when you deploy an application.

10.2.1 Creating and Managing JDBC Data Sources

You can create and manage JDBC data sources using the following management tools: ■ The Oracle WebLogic Server Administration Console ■ The WebLogic Scripting Tool WLST ■ Fusion Middleware Control To create an MDS data source manually, you should use Fusion Middleware Control or WLST to set the correct attributes for the data source. The MDS data source is displayed in the navigation pane in Fusion Middleware Control and in the domain structure in the Administration Console. If your application uses an MDS Repository, you must register the repository with the Oracle WebLogic Server domain before you deploy your application. For information about the MDS Repository and registering the repository, see Section 14.3 . Although it is not recommended, you can also use the Oracle WebLogic Server Administration Console to create a MDS data source. If you do, note the following: ■ You must prefix the data source name with mds- if you intend it to be used with MDS Repository. ■ You must target the data source to the Administration Server and to all Managed Servers to which you are deploying applications that need the data source. ■ You must turn off global transactions. See Also: Oracle Fusion Middleware Creating Domains Using the Configuration Wizard for information about specifying data sources with the Configuration Wizard See Also: Oracle Fusion Middleware Configuring and Managing JDBC for Oracle WebLogic Server for more information about configuring multi data sources Note: When you create the data source, you must use the MDS schema created by the Repository Creation Utility RCU, not other schemas. Deploying Applications 10-5 For information creating and managing JDBC data sources with Fusion Middleware Control, see the following topics: ■ Creating a JDBC Data Source Using Fusion Middleware Control ■ Editing a JDBC Data Source Using Fusion Middleware Control ■ Monitoring a JDBC Data Source Using Fusion Middleware Control ■ Controlling a JDBC Data Source Using Fusion Middleware Control

10.2.1.1 Creating a JDBC Data Source Using Fusion Middleware Control

To create a JDBC data source using Fusion Middleware Control: 1. From the navigation pane, expand the farm, then WebLogic Domain. 2. Select the domain to display the Domain home page. 3. From the WebLogic Domain menu, choose JDBC Data Sources. The JDBC Data Sources page is displayed, as shown in the following figure: 4. Click Create to open the Creating New JDBC Data Source wizard. 5. Follow the instructions in the wizard to set the properties of the data source and to target the data source for one or more of the Managed Servers in the domain. For help on individual fields and properties, use your mouse to give focus to a field. Fusion Middleware Control displays a popup definition of the field. Note that the data source properties you define in Fusion Middleware Control are similar to those you define when creating data sources in the Oracle WebLogic Server Administration Console. As a result, you can also refer to Creating a JDBC Data Source in Oracle Fusion Middleware Configuring and Managing JDBC for Oracle WebLogic Server for more information about the data source properties. See Also: ■ Oracle Fusion Middleware Configuring and Managing JDBC for Oracle WebLogic Server for information about creating and managing a data source using the Oracle WebLogic Server Administration Console or WLST ■ Oracle Fusion Middleware Configuring and Managing JDBC for Oracle WebLogic Server for more information about configuring multiple data sources