|
|
Routing Emails, Sun One Messaging Server
08-20-2010
|
|
asupgrade(1m) Application Server Utility asupgrade(1m) NAME
asupgrade - migrates the configuration of a previously installed Sun Java System Application Server SYNOPSIS
asupgrade [-c | --console] [-V --version] [-h | --help]-s | -source applicationserver7.x_installation -t --target application- server8.x_installation [-d | --domain domain_name -n | --nsspwdfile NSS_password_filepath -j | --jkspwdfile JKS_password_filepath -p | --capwdfile CA_password_filepath] Use the asupgrade utility to migrate the server configration and its persisted state, J2EE services, and deployed J2EE applications. The configuration of an installed Sun Java System Application Server 7 is migrated to the Sun Java System Application Server 8 Application Server installation. If the domain contains information about a deployed application and the installed application components do not agree with the configuration information, the configuration is migrated as is without any attempt to reconfigure the incorrect configurations. asupgrade migrates the configuration and deployed applications of a previous version of the Application Server; however, the runtime bina- ries of the server are not updated. Database migrations or conversions are beyond the scope of the asupgrade command. Only those instances that do not use the Sun Java System Web Server specific features will be upgraded seamlessly. Configration files related to HTTP path, CGI bin, SHTML, and NSAPI plugins will not be upgraded. The upgrade process can also be initiated automatically at installation time using the Upgrade checkbox in the Application Server install- er. After completion of the upgrade, use the Application Server 7 Uninstaller to remove the previous version of the Application Server. Application archives (.ear) and component archives (.jar, .war, .rar) that are deployed in the Application Server 7 environment do not require any modification to run on Application Server 8. However applications and components deployed in the source server are repackaged into new J2EE archives in the target server's autodeploy directory and are deployed upon server startup. Applications that do not deploy successfully, must use Migrationtool (asmigrate) on the application and then manually redeploy the application. You must specify the source and target directories for the upgrade. If the upgrade includes certificates, you must also provide the pass- words for the source PKCS12 file and the target JKS keyfile for each domain that contains certificates to be migrated. Since Application Server 7 uses a different certificate store format (NSS) than Application Server 8 (JSSE), the migration keys and certificates are con- verted to the new format. Upon successful upgrade, an upgrate report is generated listing successfully migrated items along with a list of the items that could not be migrated. OPTIONS
-c --console launches the upgrade command line utility. -V--version displays the version of the UpgradeTool. -h--help displays the arguments for launching the UpgradeTool. -s--source identifies the installation directory for Sun Java System Application Server 7. -t--target identifies the installation directory for Sun Java System Application Server 8. -d--domain identifies the destination domain name for the migrated certificates. -n--nsspwdfile identifies the path to the NSS password file. -j--jkspwdfile identifies the path to the JKS password file. -p--capwdfile identifies the path to the CA certificate password file. EXAMPLES
Example 1: Using asupgrade example% upgrade -s /home/sunas7 -t /home/sunas8 SEE ALSO
asmigrate(1M) Sun Java System Application Server March 2004 asupgrade(1m)