6 Post-Installation Information

Using QuickStart

When the product installation is completed using graphical-mode installation, the QuickStart application is launched automatically by default. If you do not want to run QuickStart at the completion of the installation process, you can clear the Run QuickStart check box in the Install Complete screen. QuickStart is not invoked for console-mode or silent-mode installations.

QuickStart is designed to help first-time users evaluate, learn, and use WebLogic Server.

For example, the QuickStart application for WebLogic Server provides quick access to the following tasks:

• Getting started with WebLogic Server

• Starting the WebLogic Server samples domain

• Upgrading WebLogic domains to the current version

• Accessing documentation online

After installation, you can launch QuickStart as follows:

• On Windows systems, choose Start > Programs > Oracle WebLogic > QuickStart.

• On UNIX systems:

  1. Log in to the target UNIX system.

  2. Go to the /common/bin subdirectory of your installation. For example:

     cd /MW_HOME/wlserver_10.3/common/bin

  3. Enter the following command:

     sh quickstart.sh

Determining Which JDK Version You Are Using

You can determine which version of the JDK you are using by issuing a command, as follows:

1. Open a command prompt window and go to the appropriate directory:

   Windows system:

   WL_HOME\server\bin

   UNIX system:

   WL_HOME/server/bin

2. Make sure that your environment is set up properly by entering the following command at the prompt:

   Windows:

   setWLSenv.cmd

   UNIX:

   . ./setWLSenv.sh

3. Enter the following command at the prompt:

   java -version

   If you are using JRockit, JRockit(R) is displayed in the output.

Creating a WebLogic Domain

After you install WebLogic Server, you can create a WebLogic domain. There are several ways to create a WebLogic domain:

• Use the Fusion Middleware Configuration Wizard to create a domain using one or more domain templates.

  If you are installing other Fusion Middleware products, such as SOA or WebCenter, this is the recommended method. For example, after you complete the SOA product installation, it includes domains templates that make it easy for you to create a WebLogic domain for SOA that contains the required domain resources, such as an Administration Server, Managed Servers, clusters, and JDBC resources.

  If you are not installing other Fusion Middleware products, you can create a new domain by using the starter domain template, wls_starter.jar, which is available in the following folder.

  WL_HOME\common\templates\domains

  The wls_starter.jar template contains the default domain configuration settings and an application that provides a welcome page to help you get started.

  For more information about creating a WebLogic domain by using an existing domain template, see "Creating a WebLogic Domain" in Creating Domains Using the Configuration Wizard.

• Use the WebLogic Scripting Tool to create a domain. See "Creating WebLogic Domains Offline" in Oracle WebLogic Scripting Tool.

• Use the unpack command to create a domain. You can use this command to create a WebLogic domain from the command line, by using a template that is compatible with your current installation. See "The unpack Command" in Creating Templates and Domains Using the Pack and Unpack Commands.

  Note:

  You cannot use unpack to extend an existing domain.

Installing and Uninstalling the Node Manager Service

On Windows machines, if you did not install the Node Manager Windows Service when you initially installed WebLogic Server, you can use the following steps to install it:

1. Log in to the machine with Administrator privileges.

2. Open a DOS command prompt window.

3. Change to the WL_HOME\server\bin directory, where WL_HOME is the WebLogic Server home directory (C:\Oracle\Middleware\wlserver_10.3 by default).

4. Enter the following command:

   installNodeMgrSvc.cmd

5. After a few seconds, the following message is displayed:

   Oracle WebLogic NodeManager (C_Oracle_Middleware_wlserver_10.3) installed.
   

   The service is installed using the default Node Manager listen port (5556). If this listen port is already in use, the program prompts you to enter a different listen port.

CreateService failed - The specified service already exists.

If you want to uninstall the Node Manager Windows Service, use the following steps:

1. Log in to the machine with Administrator privileges.

2. Open a DOS command prompt window.

3. Change to the WL_HOME\server\bin directory, where WL_HOME is the WebLogic Server home directory (C:\Oracle\Middleware\wlserver_10.3 by default).

4. Enter the following command:

   uninstallNodeMgrSvc.cmd

5. After a few seconds, the following message is displayed:

   Oracle WebLogic NodeManager (C_Oracle_Middleware_wlserver_10.3) removed.
   

Understanding the Windows Shortcuts

When you install your software on a Windows system, the installation program automatically creates shortcut entries on the Start Menu.

The options in the Start > Programs > Oracle WebLogic menu vary, according to the components you installed.

• WebLogic Server 11gR1—Contains a shortcut for launching the default WebLogic domain, examples, tools, and online documentation.

  • The WebLogic Server domain enables you to run pre-built WebLogic Server code samples, deploy Java EE applications, and quickly serve JSPs or HTML pages. You can also use this domain as a place to test your applications during development.

  • If you installed the Server Examples, the Examples folder contains shortcuts for starting and stopping the example servers, as well as a shortcut to launch the WebLogic Server Code Examples documentation.

  • The Tools folder contains shortcuts to launch the WebLogic Server tools (Configuration Wizard, Domain Template Builder, Domain Upgrade Wizard, Node Manager, and WebLogic Scripting Tool).

• Online Documentation—Provides a link to the online documentation.

• QuickStart—Starts the QuickStart application designed to assist first-time users with evaluating, learning, and using the software.

• Smart Update—Launches the Smart Update program, which checks for any available updates (such as patches) for installed products, and installs the selected updates.

• Uninstall Oracle WebLogic—Launches the uninstallation program. For more information, see Chapter 7, "Uninstalling the Software."

Upgrading WebLogic Server

If you are upgrading your WebLogic Server installation from an earlier version (for example from a 9.x release to a 10.x release), see Upgrade Guide for Oracle WebLogic Server. This document explains how to upgrade the entire WebLogic Server environment, including applications, the WebLogic domains in which they are deployed, and any application data associated with the domain. This may include external resources, such as database servers, firewalls, load balancers, and LDAP servers.

Installing Patches and Maintenance Updates

Oracle Smart Update is a standalone Java application that is automatically installed in the Middleware home utils/bsu directory. Smart Update simplifies the process of applying patches and maintenance updates to your WebLogic Server installation. When support makes a patch or maintenance update available for an installed version of WebLogic Server, you use Oracle Smart Update to obtain the update and apply it to your installation. Smart Update organizes all available updates for you, and has several features that allow a great deal of customizing in the way various patches and other maintenance updates are applied and managed in your environment.For information about using Smart Update, see Oracle Smart Update Installing Patches and Maintenance Packs.

You can also install all currently available patches by using an Upgrade installer. See Types of Installers, and Downloading an Upgrade Installer From My Oracle Support, for more information.

Configuring Domains to Use the Latest Version of JRockit

If you are using the JRockit SDK, after you install an upgrade patch or run an Upgrade installer, Oracle recommends that you upgrade your domains to use the latest production version of the JRockit SDK. Although the latest version of the JRockit SDK is installed by the upgrade patch or upgrade installer, your domains are not automatically configured to use it.

To configure your domains to use the latest production version of the JRockit SDK, edit the following file:

• For Windows:

  MW_HOME\domain_location\domains\domain_name\bin\setDomainEnv.cmd

• For UNIX:

  MW_HOME/domain_location/domains/domain_name/bin/setDomainEnv.sh

Replace all occurrences of the existing JRockit version with the latest production version of the JRockit SDK.

For example, if you are upgrading from WebLogic Server 10.3.2 to WebLogic Server 10.3.3, replace

jrockit_160_14_R27.6.5-32

with

jrockit_160_20_D1.0.1-2119

You can determine the JRockit SDK version number to use for your WebLogic Server version by looking at the JRockit directory name in MW_HOME. The number to use is identical to the directory name.