bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Installation Guide

Performing Post-Installation Tasks

The following sections describe the tasks you perform after installing WebLogic Server:

- Understanding the WebLogic Server Windows Shortcuts

- Understanding the WebLogic Server Directory Structure

- Starting the Examples, Pet Store, and Workshop Examples Servers

- Starting the Administration Console

- Determining the SDK Version You Are Using

Understanding the WebLogic Server Windows Shortcuts

When you install WebLogic Server on a Windows system, the installation program automatically creates shortcut files on the Start Menu. Options on the Start Menu vary according to options you select during installation. The WebLogic Platform 7.0 folder (Start—>Programs—>WebLogic Platform 7.0) contains the shortcut files shown in Figure 7-1.

Figure 7-1 BEA WebLogic Platform Start Menu

- User Projects—Contains a folder for each domain that you create using the Configuration Wizard and for which you choose to create a Start Menu option. You use the shortcuts in these folders to start servers in each domain.

- WebLogic Server 7.0—Contains shortcuts to launch the Examples and Pet Store servers, introductory documentation about WebLogic Server, and so forth. See Figure 7-2.

- WebLogic Workshop—Contains shortcuts to launch the WebLogic Workshop and examples. For details about using WebLogic Workshop, see the WebLogic Workshop documentation.

- Domain Configuration Wizard—Launches the Configuration Wizard to create and configure WebLogic domains and servers. See "Creating New Domains Using the Configuration Wizard" in Creating and Configuring WebLogic Server Domains.

- Online Documentation—Opens the WebLogic Platform online documentation. WebLogic Server is a component in WebLogic Platform.

- Smart Update—Runs Smart Update to check for and install available software updates for installed BEA products. See WebLogic Server Service Packs and Rolling Patches.

- Uninstall WebLogic Platform 7.0—Launches the uninstall program to uninstall individual WebLogic Platform components or all of WebLogic Platform.

Figure 7-2 shows the options on the WebLogic Server 7.0 menu (Start—>Programs—>WebLogic Platform 7.0—> WebLogic Server 7.0).

Figure 7-2 WebLogic Server 7.0 Start Menu

- Server Tour and Examples—Contains the following shortcuts:

  - About Examples—Opens the WebLogic Server Examples Guide in a Web browser.

  - About Pet Store—Opens instructions in a Web browser for running the Pet Store sample application.

  - Launch Examples Server—Starts the Examples server so you can run example applications installed with WebLogic Server.

  - Launch Pet Store—Starts the Pet Store server to run the Pet Store sample application.

  - Launch Weblogic Server Tour—Starts the WebLogic Server Tour, along with the Pet Store server. The WebLogic Server Tour can help you quickly learn about the features in WebLogic Server.

  - Start Admin Console—Opens the WebLogic Server Administration Console for the Examples or Pet Store server in a Web browser.

  - PointBase Console—Opens the PointBase Administration Console. The Examples and Pet Store domains use an evaluation copy of the PointBase relational database management system.

- About WebLogic Server 7.0—Opens About WebLogic Server in a Web Browser. The document contains important information about WebLogic Server.

- WebLogic Builder—Starts WebLogic Builder, which is a graphical tool for assembling a J2EE application module, creating and editing its deployment descriptors, and deploying it to a WebLogic server. For more information about WebLogic Builder, see "WebLogic Builder".

Understanding the WebLogic Server Directory Structure

WebLogic Server 7.0 has a new directory structure for WebLogic Server and a new location for your applications that run on WebLogic Server. This new directory structure provides added flexibility and promotes best practices for application development.

Files and Directories Installed

During the WebLogic Server installation, you are asked to select or create a BEA Home directory and a product installation directory. For information about the BEA Home directory, see BEA Home Directory. For a typical installation, the installer program creates the following directory structure for WebLogic Platform software, which may or may not be in the BEA Home directory:

The contents of each directory are described in the following table.

This directory . . . | Contains . . .
--- | ---
weblogic700 | Folders for files shared by all WebLogic Platform components, as well as individual folders for each installed WebLogic Platform component.
common | Files shared by WebLogic Platform components, including template jar files used by the Configuration Wizard when creating domains. The Configuration Wizard reads the contents of this folder and displays template options based on the jar files in the directory. See Configuring Domains, Servers, and Clusters with the Configuration Wizard for more information about using the Configuration Wizard.
samples | Sample code, resources, and preconfigured domains designed to help you learn how to develop your own applications using WebLogic Platform. Samples are organized by component installed on the system. Each WebLogic Platform component has its own folder within the samples folder. The server folder in the samples folder contains the examples and petstore domains, source code for the examples and petstore sample applications, and PointBase evaluation software.
server | WebLogic Server program files.
uninstall | Code required to uninstall the WebLogic Server software.
workshop | WebLogic Workshop application and documentation files and files to support the Workshop sample domain.

New Structure for Domain Directories

In previous releases of WebLogic Server, domains were created within the directory structure of the Weblogic Server installation, including application code for each domain. With WebLogic Server 7.0, you can and are encouraged to create domains in their own directory structure anywhere you choose. Scripts and applications in the domain must have access to the Weblogic Server installation and the JDK.

This new directory structure provides for greater flexibility when storing application code and configuring server systems. It also promotes best practices for application development. That is, application code should not be stored with the application server code.

For more information about domains and domain directories, see Overview of WebLogic Server Domains in Creating and Configuring WebLogic Server Domains.

Starting the Examples, Pet Store, and Workshop Examples Servers

The examples optionally installed with WebLogic Server demonstrate a variety of features using WebLogic Server and WebLogic Workshop. The source files and Javadoc files for the WebLogic Server examples are installed in SAMPLES_HOME\server\src\examples and SAMPLES_HOME\server\src\petstore. Additional information for configuring and executing the examples server and the example applications is provided in the SAMPLES_HOME\server\src\examples\examples.html file. The WebLogic Workshop Samples project source files are installed in SAMPLES_HOME\workshop\applications\samples. For information about the Samples project in WebLogic Workshop, see the WebLogic Workshop documentation.

The following sections provide instructions for starting the Examples, Pet Store, and cgServer (for the WebLogic Workshop Samples project) servers on a Windows or UNIX system.

- Starting the Examples Server on a Windows System

- Starting the Examples Server on a UNIX System

- Starting the Pet Store Server and Application on a Windows System

- Starting the Pet Store Server and Application on a UNIX System

- Starting the WebLogic Workshop Examples Server

Note: You cannot start the Examples, Pet Store, and Workshop Examples servers at the same time (as installed) because all of them are configured to use port 7001 as the non-secure listening port and 7002 as the secure listening port. To run them concurrently, you must reconfigure the listening ports as described in Setting the Listen Port in the Administration Console Online Help

Starting the Examples Server on a Windows System

To start the Examples server on a Windows system:

- Choose Start—>Programs—>WebLogic Platform 7.0—> WebLogic Server 7.0—>Server Tour and Examples—>Launch Examples Server.

After the server starts, a Web browser automatically opens. Click the Go to Administration Console text link or enter the following URL in a browser window to start the Administration Console: http://hostname:7001/console.

For complete information about starting and stopping WebLogic Server, see "Starting and Stopping WebLogic Servers" in the Administration Guide.

Note: You cannot start the Examples, Pet Store, and Workshop Examples servers at the same time (as installed) because all of them are configured to use port 7001 as the non-secure listening port and 7002 as the secure listening port. To run them concurrently, you must reconfigure the listening ports as described in Setting the Listen Port in the Administration Console Online Help

Starting the Examples Server on a UNIX System

To start the examples server on a UNIX system, follow these steps:

1. In a command shell, go to the following directory:

   >     SAMPLES_HOME/server/config/examples

   where SAMPLES_HOME represents the location of all examples for the WebLogic Platform—for example, bea/weblogic700/samples.

2. Enter the following command:

   >     startExamplesServer.sh

   The startExamplesServer.sh script sets up the proper CLASSPATH variable for the Examples server and loads the configuration in the SAMPLES_HOME/server/config/examples/config.xml file.

For complete information about starting and stopping servers, see "Starting and Stopping WebLogic Servers" in the Administration Guide.

Note: You cannot start the Examples, Pet Store, and Workshop Examples servers at the same time (as installed) because all of them are configured to use port 7001 as the non-secure listening port and 7002 as the secure listening port. To run them concurrently, you must reconfigure the listening ports as described in Setting the Listen Port in the Administration Console Online Help

Starting the Pet Store Server and Application on a Windows System

The Pet Store server runs the Pet Store application, which is provided in the WebLogic Server Pet Store Demo to demonstrate the capabilities of the J2EE platform and WebLogic Server. After the server boots, your browser should automatically launch and point to the WebLogic Server Petstore Demo running on the server. Additional information for configuring and executing the Pet Store server and the Pet Store application is provided in the WL_HOME\samples\server\src\petstore\petstore.html file.

To start the Pet Store server on a Windows system:

- Choose Start—>Programs—>WebLogic Platform 7.0—> WebLogic Server 7.0—>Server Tour and Examples—>Launch Pet Store.

For complete information about starting and stopping WebLogic Server, see "Starting and Stopping WebLogic Servers" in the Administration Guide.

Note: You cannot start the Examples, Pet Store, and Workshop Examples servers at the same time (as installed) because all of them are configured to use port 7001 as the non-secure listening port and 7002 as the secure listening port. To run them concurrently, you must reconfigure the listening ports as described in Setting the Listen Port in the Administration Console Online Help

Starting the Pet Store Server and Application on a UNIX System

The Pet Store server runs the Pet Store application, which is provided in the WebLogic Server Pet Store Demo to demonstrate the capabilities of the J2EE platform and WebLogic Server. After the server boots, your browser should automatically launch and point to the WebLogic Server Pet Store Demo running on the server. Additional information for configuring and executing the Pet Store server and the Pet Store application is provided in the SAMPLES_HOME/server/src/petStore/petstore.html file.

To start the Pet Store server and application on a UNIX system, follow these steps:

1. Go to the following directory:

   >     SAMPLES_HOME/server/src/petStore

   where SAMPLES_HOME represents the location of all examples for the WebLogic Platform—for example, bea/weblogic700/samples.

2. Enter the following command:

   >     startPetStore.sh

   The startPetStore.sh script sets up the proper CLASSPATH variable for the Pet Store server and loads the configuration in the SAMPLES_HOME/server/config/petstore/config.xml.

For complete information about starting and stopping servers, see "Starting and Stopping WebLogic Servers" in the Administration Guide.

Note: You cannot start the Examples, Pet Store, and Workshop Examples servers at the same time (as installed) because all of them are configured to use port 7001 as the non-secure listening port and 7002 as the secure listening port. To run them concurrently, you must reconfigure the listening ports as described in Setting the Listen Port in the Administration Console Online Help

Starting the WebLogic Workshop Examples Server

WebLogic Workshop is installed with a project named Samples. The samples project contains many example web services that demonstrate specific features or capabilities of WebLogic Workshop web services. To support the Samples project, WebLogic Workshop is installed with the Workshop domain preconfigured and ready to run.

To start the Workshop Examples server on a Windows system:

- Choose Start—>Programs—>WebLogic Platform 7.0—> WebLogic Workshop—>WebLogic Workshop Examples—>Start Examples Server.

Note: You cannot start the Examples, Pet Store, and Workshop Examples servers at the same time (as installed) because all of them are configured to use port 7001 as the non-secure listening port and 7002 as the secure listening port. To run them concurrently, you must reconfigure the listening ports as described in Setting the Listen Port in the Administration Console Online Help

Starting the Administration Console

The Administration Console is the Web-based administration tool for WebLogic Server. You must start the server before you can access the Administration Console for a server.

Note: For details about starting the WebLogic Server servers, see Starting the Examples, Pet Store, and Workshop Examples Servers. For more information about the Administration Console, see the Administration Guide.

To start the Administration Console, follow these steps:

1. Open the following URL in a supported browser:

   >     http://hostname:port/console

   where:

   - hostname is the name or IP address of the machine on which you installed the WebLogic Server software.

   - port is the listening port of the server you want to administer. The default non-secure listen port for WebLogic Server is 7001. For the Examples, Pet Store, and Workshop Examples servers, the non-secure listen port is configured as 7001 by default.

2. The Administration Console prompts you for a username and password. Enter a username and password for the server you want to administer. For the Examples and Pet Store servers, weblogic (username and password) is the default administrative user. For the Workshop Examples server, installadministrator (username and password) is the default administrative user.

Determining the SDK Version You Are Using

You can determine the version of the SDK you are using in either of two ways: on the command line or by examining the contents of the log file created for the server. Instructions for both methods are provided in Table 7-1.

Table 7-1 Determining the SDK Version

To determine the SDK . . . | Perform the following steps . . .
--- | ---
From the command line | 1. Open a command prompt window and go to the following directory: WL_HOME\server\bin (Windows) WL_HOME/server/bin (UNIX) In these pathnames, WL_HOME represents the directory in which you installed WebLogic Platform. 2. Make sure that your environment is set by entering the following command at the prompt: setWLSenv.cmd (Windows) setWLSenv.sh (UNIX) 3. Enter the following command at the prompt: java -version If you are using WebLogic JRockit, BEA WebLogic JRockit(R) Virtual Machine is displayed in the output.
Using the server log file | 1. In a text editor, open the server log file for your domain. The location of the server log file may vary. For some domains, the log file is called weblogic.log and is located in the domain_name\logs directory, where domain_name is one of the following: the name of the domain you provided when you created the domain using the Configuration Wizard, or, the name of a sample domain. For example, C:\bea\user_projects\mydomain\logs\weblogic.log. For details about server log files, see "Using Log Messages to Manage WebLogic Server" in the BEA WebLogic Server Administration Guide. Note: The server log file is created the first time the server is started. 2. Search the log file for the following values: java.vm.version java.vm.vendor These entries in the log file provide the build version of the JVM and the JVM vendor (for example Sun Microsystems Inc. or BEA Systems, Inc.)

: