6 Post-Installation Information

This chapter describes common post-installation tasks and information, including how to use QuickStart and how create a WebLogic domain. It also describes how to determine your JDK version, the Node Manager service, Windows shortcuts, upgrading, and patch installation. It also includes a section on how to configure domains to use the latest JRockit version.

The following sections are included in this chapter:

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/quickstart subdirectory of your installation. For example:

      cd /MW_HOME/wlserver_10.3/common/quickstart

    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.

Note:

If the Node Manager Windows Service is already installed, the following message is displayed instead:
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.

Note:

If the user performing the installation has Administrator privileges, the shortcut entries can be created in the All Users Start menu folder or in the Local User Start menu folder. For more information, see Administrator Privileges.

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 you can use to install patches that you downloaded from My Oracle Support.

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

Note:

After you create domains, the name of the directory in which your domain directories are stored is also displayed on the Oracle WebLogic menu. The default is user_projects. This menu entry allows you to start and stop the Administration Server, or start the Administration Console, for a given domain.

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

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 to your WebLogic Server installation. When support makes a patch available for an installed version of WebLogic Server, you download the patch from My Oracle Support and then use Oracle Smart Update to 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 are applied and managed in your environment.For information about using Smart Update, see Oracle Smart Update Installing Patches and Maintenance Packs.

Note:

As of WebLogic Server 10.3.4, you can no longer use Smart Update to download and install WebLogic Server patch set releases.

You can also install all currently available patches by using an Upgrade installer. When using a WebLogic Server Upgrade installer to upgrade an existing WebLogic Server installation on Linux or UNIX operating systems, you must run the Upgrade installer using the same user ID as was used to perform the initial WebLogic Server installation. See Types of Installers, and Downloading an Upgrade Installer From My Oracle Support, for more information.

Note:

If you also need to install patches for other Fusion Middleware 11g Release 1 products, such as SOA or WebCenter, that are installed in your WebLogic Server environment, refer to the Oracle Fusion Middleware Patching Guide before installing WebLogic Server patches or updating your WebLogic Server installation.

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.