bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

Installing WebLogic Platform

Performing Post-Installation Tasks

The following sections describe the tasks you perform after installing and licensing your WebLogic Platform software:

- Using QuickStart

- Executing the Samples

- Switching to Other Databases

- Determining the SDK Version You Are Using

- Understanding the WebLogic Platform Windows Shortcuts

- Understanding the WebLogic Platform Product Directory Structure

Using QuickStart

If you installed WebLogic Platform using a typical installation, or used a custom installation to install all of the components and examples, the sample domains are automatically configured to run using the PointBase database, a database that is installed with WebLogic Server. When the installation is complete, a QuickStart application is displayed. QuickStart is designed to assist first-time users in evaluating, learning, and using WebLogic Platform. It also provides quick access to the WebLogic Platform tour and other samples, useful tools for accomplishing specific development tasks, and the online documentation.

After installation, you can launch QuickStart as follows:

- On Window systems, choose Start—>Programs—>BEA WebLogic Platform 7.0—>QuickStart

- On UNIX systems, perform the following steps:

1. Log in to the target UNIX system.

2. Open a command-line shell.

3. Go to the /common/bin subdirectory of the WebLogic Platform installation. For example:

cd /home/bea/weblogic700/common/bin

4. Enter the following command:

sh quickstart.sh

Executing the Samples

Before using the WebLogic Platform software, we recommend that you execute the sample applications provided with each component. These samples offer a variety of benefits. They verify that the software is installed correctly, they provide sample code, and they demonstrate implementation techniques. For details about the examples for the WebLogic Platform components, refer to the following table.

Table 8-1 Samples Descriptions

Product | Samples Descriptions
--- | ---
WebLogic Platform | http://e-docs.bea.com/platform/docs70/interm/samples.html
WebLogic Server | http://e-docs.bea.com/wls/docs70/samples.html
WebLogic Integration | http://e-docs.bea.com/wli/docs70/interm/samples.htm
WebLogic Portal | http://e-docs.bea.com/wlp/docs70/interm/samples.htm
WebLogic Workshop | http://e-docs.bea.com/workshop/docs70/help/index.html#guide/tutorial/tutFirstWebServiceIntro.html

Switching to Other Databases

When you install WebLogic Platform, all domains are preconfigured to use the PointBase database. However, you may want to switch to another supported database, such as Oracle or Microsoft SQL Server. To successfully run the examples using a database other than PointBase, you need to configure and initialize the new database. For details about switching or configuring the databases, refer to the following:

- For WebLogic Platform domains, follow the procedures described in "Customizing a Domain for a Database" in the BEA WebLogic Platform Release Notes at the following URL:

http://e-docs.bea.com/platform/docs70/relnotes/relnotes.html

- For WebLogic Portal domains, follow the procedures described in "Database Administration" in "System Administration" in the BEA WebLogic Portal Administration Guide at the following URL:

http://e-docs.bea.com/wlp/docs70/admin/sysadmin.htm

- For WebLogic Integration domains, use the Integration Database Wizard, or the wliconfig command, as described in "Customizing WebLogic Integration" in Starting, Stopping, and Customizing BEA WebLogic Integration at the following URL:

http://e-docs.bea.com/wli/docs70/config/custom.htm

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 8-2.

Table 8-2 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 at the following URL: http://e-docs.bea.com/wls/docs70/adminguide/logging.html 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.)

:

Understanding the WebLogic Platform Windows Shortcuts

When installing WebLogic Platform on a Windows system, the installation program automatically uses BEA WebLogic Platform as the parent folder for the installation. As additional BEA Home directories are added to the system, the installation program continues to create new BEA product folders using the convention shown in the following figure.

Figure 8-1 Tracking Multiple BEA Home Directories on the Same System

Each BEA Home directory has an associated BEA product folder. To differentiate between the products contained in different BEA Home directories, BEAHOMEn is appended to the folder name. The numbers associated with BEAHOME are sequential starting at 2; no number appears if only one BEA Home directory is created on a Windows system.

WebLogic Platform Start Menu

The WebLogic Platform 7.0 folder (Start—>Programs—>BEA WebLogic Platform) contains the shortcut files shown in the following figure.

Figure 8-2 WebLogic Platform 7.0 Start Menu

- User Projects—contains a folder for each domain that you create using the Configuration Wizard. The domain folders contain shortcuts for launching the server if you chose to create a start menu option when you created the domain. If you configured a domain for WebLogic Integration, a shortcut for the Integration Database Wizard is installed. For details about creating domains using the Configuration Wizard, see Using the Configuration Wizard.

- WebLogic Integration 7.0—contains shortcuts to launch the WebLogic Integration Tools and examples. For details about using WebLogic Integration, see the WebLogic Integration documentation set at the following URL:

>     http://e-docs.bea.com/wli/docs70/index.htm

- WebLogic Portal 7.0—contains shortcuts to launch the WebLogic Portal tools and examples. For details about using WebLogic Portal, see the WebLogic Portal documentation set at the following URL:

>     http://e-docs.bea.com/wlp/docs70/index.htm

- WebLogic Server 7.0—contains shortcuts to launch the Examples and Pet Store servers, the WebLogic Builder, and a page containing introductory information about WebLogic Server. For details about using WebLogic Server, see the WebLogic Server documentation set at the following URL:

>     http://e-docs.bea.com/wls/docs70/index.html

- WebLogic Workshop—contains shortcuts to launch the WebLogic Workshop and examples. For details about using WebLogic Workshop, see the WebLogic Workshop documentation set at the following URL:

>     http://e-docs.bea.com/workshop/docs70/index.html

- Domain Configuration Wizard—starts the Configuration Wizard to assist you in creating user domains. For information about the Configuration Wizard, see Using the Configuration Wizard at the following URL:

>     http://e-docs.bea.com/platform/docs70/confgwiz/index.html

- Online Documentation—provides a link to the BEA WebLogic Platform online documentation on the e-docs Web site.

- QuickStart—starts the WebLogic Platform QuickStart application designed to assist first-time users in evaluating, learning, and using WebLogic Platform.

- Smart Update—launches Smart Update to check for updates available for installed BEA products, and installs the updates as required.

- Uninstall WebLogic Platform 7.0—launches the WebLogic Platform 7.0 uninstallation program. For more information, see Uninstalling WebLogic Platform.

Understanding the WebLogic Platform Product Directory Structure

During the WebLogic Platform 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 Choosing a BEA Home Directory. For a typical installation, the installation program creates the following directory structure for WebLogic Platform software, which may or may not be in the BEA Home directory. Table 8-3 describes the contents of each directory.

Table 8-3 Product Installation Directory Structure

This directory . . . | Contains . . .
--- | ---
weblogic700 | Folders for files shared by all WebLogic Platform components, as well as individual folders for each installed WebLogic Platform component. WebLogic Platform components include WebLogic Server, WebLogic Integration, WebLogic Portal, and WebLogic Workshop.
common | Files shared by WebLogic Platform components, including a template directory that contains 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. For details on the Configuration Wizard, see Using the Configuration Wizard.
ebcc | E-Business Control Center program files.
integration | WebLogic Integration program files.
portal | WebLogic Portal program files.
samples | Sample code, resources, and preconfigured sample domains designed to help you learn how to develop your own applications using the WebLogic Platform software. Samples are organized by components installed on the system. For example, the platform folder in this directory contains the e2eDomain source code for executing the WebLogic Platform Tour. Similarly, the server folder contains the examples and petstore domains, source code for the examples and Pet Store sample applications, and the PointBase evaluation software, located in the server/eval folder.
server | WebLogic Server program files.
uninstall | Code required to uninstall the WebLogic Platform software.
workshop | WebLogic Workshop application and documentation files.