The clientUpgrade command

Use the clientUpgrade command to migrate V4.0.x and V5.x client resources to V6.0 level resources. In the process of migrating these resources, the client-resources.xmi file located in the client jars will be migrated to the latest level. A backup of the client-resources.xmi file will also be located in the client jar. If this command is not executed against the client EAR files before they are installed on V6.0, the client EARs will not operate or install correctly.

Note:

The command file is located in the bin subdirectory of the WAS_install_root, or the ND_install_root directory. By default, the WAS_install_root for WebSphere Application Server is:

• Windows operating platforms - drive\WebSphere\AppServer directory

• AIX or UNIX-based operating platforms - /usr/WebSphere/AppServer directory

By default, the ND_install_root for WebSphere Application Server Network Deployment is:

• Windows operating platforms - drive\WebSphere\DeploymentManager directory

• AIX or UNIX-based operating platforms - /usr/WebSphere/DeploymentManager directory

Linux and UNIX-based platforms:

clientUpgrade.sh EAR_file [-clientJar client_jar ]
                                  [-logFileLocation logFileLocation]
                                  [-traceString trace_spec [-traceFile file_name ]]

Windows platforms:

clientUpgrade.bat EAR_file [-clientJar client_jar ]
                                   [-logFileLocation logFileLocation]
                                   [-traceString trace_spec [-traceFile file_name ]]

 

Parameters

Supported arguments include the following:

EAR_file

Use this parameter to specify the fully qualified path to the EAR file that contains client JAR files to process.

-clientJar

Use this optional parameter to specify a JAR file for processing. If not specified, the program transforms all client JAR files in the EAR file.

-logFileLocation log_file_location

Use this optional parameter to specify an alternate location to store the log output.

-traceString trace_spec -traceFile file_name

Use these optional parameters to gather trace information for IBM Service personnel. Specify a trace_spec of "*=all=enabled" (with quotation marks) to gather all trace information.

 

Example

clientUpgrade EAR_file -clientJar ejbJarFile

---

 

Related Tasks

Installing Application Client for WebSphere Application Server

 

---