3
Using the SmartUpgrade Command Line 3-1
3
Using the SmartUpgrade Command Line
In addition to using SmartUpgrade as an integrated Oracle JDeveloper extension, you can also use the SmartUpgrade command-line interface.
The command line interface can be run using the Java command line or as an Apache Ant task.
With the SmartUpgrade command-line, you can consider automating the analysis and generation of artifacts for multiple applications using scripts.
For more information, see the following sections:
■
Using the SmartUpgrade Java Command-Line
■
Integrating SmartUpgrade with Apache Ant
3.1 Using the SmartUpgrade Java Command-Line
The following sections describe how to use the command-line interface for SmartUpgrade:
■
Verifying Prerequisites and Locating the smartupgrade.jar File
■
Basic Syntax of the SmartUpgrade Command-Line Interface
■
Getting Help on the SmartUpgrade Command-Line Options
■
Summary of the SmartUpgrade Command-Line Options
■
Summary of the SmartUpgrade Command-Line Options Specific to Artifact Generation
■
Examples of Using the SmartUpgrade Command-Line Interface
3.1.1 Verifying Prerequisites and Locating the smartupgrade.jar File
Before you can run the SmartUpgrade command-line interface:
1.
Verify that you have installed the required Java software, as described in Section 1.7.4, Installing the SmartUpgrade Command-Line Interface
. Note that you should also make sure that the Java bin directory is defined as part
of the current PATH variable, so you can run the java command from any location on your system. Otherwise, you must include the path to the java
command every time you run the SmartUpgrade software.
2.
Verify that you have installed a supported version of Oracle WebLogic Server and that you have access to a local Oracle WebLogic Server home directory.
3-2 Oracle Fusion Middleware SmartUpgrade Users Guide
You specify the location of the Oracle WebLogic Server home directory using the -targetStackHome
command-line option. For more information, see
Table 3–3, Summary of the Command-Line Options Specific to Generating Artifacts
.
3.
Locate the smartupgrade.jar file, which you installed using the instructions in Section 1.7, Downloading and Installing SmartUpgrade
. Note that the instructions and examples in this chapter assume you are running
SmartUpgrade from the directory where the smartupgrade.jar resides.
3.1.2 Basic Syntax of the SmartUpgrade Command-Line Interface
To use the SmartUpgrade command-line interface, simply navigate to the directory where you unpacked the contents of the downloaded smartupgrade.zip file and use
the following syntax:
java -jar smartupgrade.jar options For more information, see
Section 3.1.5, Summary of the SmartUpgrade Command-Line Options
3.1.3 Optionally Increasing the Java Heap Size When Running SmartUpgrade
