i

ii

1

This documentation describes in detail how to install and use Oracle WebLogic SmartUpgrade

for upgrading Java EE applications from Oracle Application Server to WebLoigc Server.

Oracle WebLogic SmartUpgrade is part of the Oracle Fusion Middleware 11g upgrade tools that

were designed to maximize the automation of the upgrade process, minimize the application

downtime and allows for rapid and seamless uptake of the Oracle Fusion Middleware 11g

features and capabilities.

The comprehensive documentation and guides could be found here:

http://www.oracle.com/technology/products/middleware/upgrade/index.html

Currently, WebLogic SmartUpgrade is general available as 11g Release 1 Patchset 1 (11.1.1.2.0).

Oracle WebLogic SmartUpgrade 11.1.1.0.0 could be downloaded according to the Oracle

Technology Network development license.

http://www.oracle.com/technology/software/products/middleware/smartupgrade.html

Oracle WebLogic SmartUpgrade download package contains both command line tool and the

JDeveoper extensions. The command line upgrade tool is packaged as smartupgrade.zip; and the

JDeveloper extensions are packaged as jdeveloper_smartupgrade.zip.

Each zip file includes a readme.txt in which it gives the details of how to install and use the

upgrade tool through its respective interface.

If WebLogic SmartUpgrade has been installed previously, the environment will need to be

cleaned by deleting both C:\ WLS1031\ jdeveloper\ modules\ oracle.smartupgrade.weblogc and

C:\ WLS1031\ jdeveloper\ jdev\ extensions\ oracle.jdeveloper.smartupgrade.weblogic.jar before

unzipping the new zip file.

http://www.oracle.com/technology/products/middleware/upgrade/index.htmlhttp://www.oracle.com/technology/software/products/middleware/smartupgrade.html

2

The option of

A new upgrade application could be started b -

selecting .

The application could be named with the desired value or with the default.

3

The project could be named with the desired value or with the default.

4

report identifies artifacts and metadata that need to be upgraded to WebLogic proprietary forms

and provides assistance where possible.

Any Java EE application that was deployed to OracleAS 10.1.3.x or 10.1.2.x could be used for

the upgrade project. All the Java EE applications that were deployed to OracleAS 10.1.3.x or

10.1.2.x could be upgraded with WebLogic SmartUpgrade.

5

There are different options that could be selected on this page.

When generating an upgrade report into an existing project, an Oracle Application Server

configuration home could be specified to be included as part of the report. Additionally, both the

server home and OracleAS enterprise archives can be localized into the JDevelopoer project file

system by checking "Copy OC4J Deployment Archives Into Project".

6

The advanced options give the capability of specifying categories to be executed during the

generation process. It also gives the option of upgrading OracleAS versions.

the default settings.

7

The advisory reports and the configuration artifacts will be generated. The generated artifacts will

be located at the JDeveloper project mywork directory.

If the Web Services applications were detected in the specified deployment archive(s); some

additional properties will need to be specified.

8

Here are some sample properties to select and some of them are mandatory.

Generate Instrumented Code for Performance Analysis -- The flag (true/false) to indicate if the generated wrapper ("glue") code should be instrumented for performance analysis.

Package Upgraded Application -- The flag (true/false) to indicate if the target upgraded application needs to be packaged into a deployable archive.

Target Server Home Directory This is a mandatory property. It should point to the location of a Weblogic Server installation, for example, C:\ wlhome\ wlserver_10.3. Note: you cannot use Weblogic Server bundled with JDeveloper. You can specify 'targetStackHome' property before invoking artifact generation. Alternatively, you can set environment variable WL_HOME before starting your upgrade tool (command line or JDeveloper), which will be the default target server location for all upgrade actions.

There are many other properties that could be used for debugging, logging, and some advanced operations.

9

At the reporting page, the upgrade metrics summary shows the details of the upgrade point

findings with detailed information provided on priorities and complexities. These will help the

customers planning the upgrade project accordingly.

10

Using the report of the data-sources.xml findings as the example. This high complexity finding

tells the customer that the managed data source used with OracleAS will need to be converted to

a WebLogic Server data source; so the application could be successfully deployed to a WebLogic

environment. The Reason, Advice and Implication sections give all the details of the actions that

will need to take to be able to make the correct changes. After a new data source created for the

WebLogic Server, some of the configuration elements will need the additional tuning to keep all

the existing functionalities for the application.

Some of the configuration options with OracleAS may not have the equivalents in WebLogic,

these are also covered in the implication section with further advices.

Here is the example reporting:

An OC4J Managed Data Source named 'jdev-connection-managed-INSDB' was encountered. The OC4J Data Source Connection Pool inactivity-timeout is the amount of time (in seconds) that an unused connection is inactive before it is removed from the pool. It is set to '1000'. It does not have a direct equivalent in Oracle WebLogic Server. However, you may be able to use the shrink-frequency-seconds to achieve the same behavior.

http://download.oracle.com/docs/cd/B32110_01/web.1013/b28958/datasrc.htm#CHDJFEDH

11

All the OracleAS public, private dependencies and the third-party dependencies are covered in

the advisory report as well.

The artifacts generated could be found at the Jdeveloper project directory.

For example: C:\ JDeveloper\ mywork\ Application20\ Project1\ gen_src\ itweb-ins-app_ear.d\ it-

web-view_war.d

Here is the example of the generated deployment descriptor, weblogic.xml.

The automated Web Services migration tool was designed to help the customers dealing with the most time consuming efforts in the upgrade projects. It can migrate an Oracle 10.1.2.x, 10.1.3.x

-

-

-

-

Artifact: C: \ upgrade \ itweb - ins -app.ear:it -web -view.war:WEB -

INF/orion -web.xml

Location Details: /orion -web -app[@persistence -path]

-- >

applicationStore/

file

-

-

Artifact: C: \ upgrade \ itweb - ins -app.ear:it -web -view.war:WEB -

INF/o rion -web.xml

Location Details: /orion -web -app/virtual -directory

-- >

/lib/icons/

/icons/

12

web services into WLS 10.3 JAX-RPC web service, by generating glue code around the existing implementation. Current supported features:

Upgrading POJO based Oracle 10.1.3.* web service into Weblogic 10.3 JAX-RPC web service* - Aimed at zero code change. EAR to EAR and WAR to WAR.

Upgrading POJO based Oracle 10.1.2.* web service into Weblogic 10.3 JAX-RPC web service* - Aimed at zero code change. EAR to EAR and WAR to WAR.

Upgrading EJB2.* based Oracle 10.1.3.* web service into Weblogic 10.3 JAX-RPC web service* - Aimed at zero code change. EAR to EAR and WAR to WAR.

o EJB2.* is migrated to run on WLS Web service becomes POJO that delegates the call to EJB

Upgrading Oracle 10.1.3.* EJB30 based web services.

Note:

1. The JDK 1.6 is required for Web Services migration. 2. You will need to set up the environment variable for JAVA_HOME by doing following.

Right click on My Computer -> Properties -> Advanced -> Environment Variables and set JAVA_HOME=\ jrockit_160_05_R27.6.2-20

Here, it shows the sample output:

13

26:05 WARNING - Detecting policy is not yet supported; Please use :qos 26:05 INFO - Unzipping file:C:\ upgrade\ WS\ ..\ AgentService.ear at:C:\ upgrade \ WS\ Agent.out\ exploded\ AgentService 26:05 INFO - No of wars found:1 26:05 INFO - No of EJB JARS found:0 26:05 INFO - Source application stack is:OC4J1013 26:08 INFO - Source migration plan successfully generated at:C:\ upgrade\ WS \ Agent.out\ config.xml 26:08 INFO - ================================================== 26:09 INFO - The classpath has been successfully validated. 26:09 INFO - Using WLS wsdlc to generate wsdl to java artifacts. 26:09 INFO - This may take a while if you have more services.. 26:34 INFO - Generating Weblogic web service deployment descriptors. 27:06 INFO - Target migration plan generated successfully at:C:\ upgrade\ WS \ Agent.out\ outConfig.xml 27:06 INFO - ================================================== 27:11 INFO - Generating glue code... 27:11 INFO - Creating file at:C:\ upgrade\ WS\ Agent.out\ intermediate \ AgentService\ AgentService_AgentServicePort\ com\ oracle \ webservices\ interop\ AgentServicePortImpl.java 27:11 INFO - Creating file at:C:\ upgrade\ WS\ Agent.out\ intermediate \ AgentService\ AgentService_AgentServicePort\ com\ oracle \ webservices\ interop\ AgentServicePortImplCopyUtils.java 27:12 INFO - Glue code implementations successfully generated. 27:12 INFO - Compiling glue code for port AgentServicePort 27:22 INFO - Compilation is successful. 27:22 INFO - Merging web.xml at C:\ upgrade\ WS\ Agent.out\ final\ AgentService \ AgentService-web\ WEB-INF\ web.xml 27:22 INFO - Merging weblogic-webservices.xml at C:\ upgrade\ WS\ Agent.out \ final\ AgentService\ AgentService-web\ WEB-INF \ weblogic-webservices.xml 27:22 INFO - Merging webservices.xml at C:\ upgrade\ WS\ Agent.out\ final \ AgentService\ AgentService-web\ WEB-INF\ webservices.xml 27:23 INFO - -> Creating war at :C:\ upgrade\ WS\ Agent.out\ final\ AgentService \ AgentService-web.war 27:33 INFO - -> Created C:\ upgrade\ WS\ Agent.out\ final\ AgentService.ear

14

The AgentService.ear, as the example deploy it to WebLogic Server.

The upgraded application could be deployed to any WebLogic Admin or Managed Servers. On the deployments page, c .

15

Browse your application and load it to the deployment Path.

16

17

this page.

18

At the Deployments page, click to open AgentService and click the Web Services

19

20

Go back to the Testing page,

21

At the bottom of the WLS server started DOS window, the following url for performance analysis will show: file:///C:/WLS1031/user_projects/domains/auctionDev/AgentServicePortImpl.html Open this page at the browser.