BEA Logo BEA WebLogic Server Release 6.1

  BEA Home  |  Events  |  Solutions  |  Partners  |  Products  |  Services  |  Download  |  Developer Center  |  WebSUPPORT

 

  |  

  WebLogic Server Doc Home   |     Installation   |   Previous Topic   |   Next Topic   |   Contents   |   Index   |   View as PDF

Performing Post-Installation Tasks

 

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

 


Understanding the WebLogic Server Directory Structure

During the WebLogic Server software installation, the installer program creates the following directory structure for a "Server with Examples" installation, which includes the WebLogic Server program files and examples files plus the secure sockets layer (SSL) encryption software packages.


 

The product directory shown here, wlserver6.1, is the default for the WebLogic Server 6.1. You can change the default name during the installation.

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

This directory . . .

Contains . . .

bin

Executable programs plus the libraries for Windows systems to support the following components:

  • JDBC drivers

  • Apache plug-ins

  • Internet Server (IS) API plug-ins

  • Netscape Server (NS) API plug ins

  • Other native code packages

config

A configuration repository for each of the domains in the configuration. Each domain is defined in a separate subdirectory, the name of which is the name of that domain. When you initially install WebLogic Server, three subdirectories are created in the /config directory:

  • domain_name (mydomain is the default)

  • examples

  • petstore

Each subdirectory contains the Extensible Markup Language (XML) configuration file (config.xml) and the security resources for that domain.

The mydomain subdirectory contains two configuration files:

  • config.xml

    On initial installation, config.xml reflects the values you enter during installation. As you modify your configuration, the changes are reflected in this file.

  • config.xml.FROM_INSTALLER

    This file is a duplicate of the initial config.xml file, reflecting the values you enter during installation. It remains unchanged, allowing you to restore your config.xml to the state immediately following an installation, if necessary.

ext

XML jar files.

lib

The jar files to run WebLogic Server plus the libraries for UNIX systems to support the following components:

  • JDBC drivers

  • Apache plug-ins

  • Internet Server (IS) API plug-ins

  • Netscape Server (NS) API plug ins

  • Other native code packages

samples

Sample code and resources designed to help you learn how to develop your own applications using WebLogic Server. The samples directory contains the following subdirectories:

  • examples

    A collection of simple applications that demonstrate many features of WebLogic Server.

  • petStore

    The WebLogic Server Pet Store application, which is a full-blown e-commerce application based on the Sun Microsystems, Inc. J2EE Blueprint example. The J2EE Blueprint example has been slightly modified to demonstrate some of the unique and powerful features of WebLogic Server.

  • eval

    An evaluation copy of the Cloudscape relational database management system (RDBMS), which is included so that you can run the examples and Pet Store application with a functional RDBMS.

uninstaller

Code required to uninstall the WebLogic Server 6.1 software.

uninstaller_servicepack

Code required to uninstall the WebLogic Server 6.1 Service Pack. This directory appears only if you have applied a Service Pack upgrade to the WebLogic Server 6.1 software.

servicepacks

A copy of each Service Pack installed on the WebLogic Server 6.1 software. (Currently, this directory is not being used; it is empty.) This directory appears only if you have applied a Service Pack upgrade to the WebLogic Server 6.1 software.


 

 


Verifying Your Installation

A WebLogic Server "Server with Examples" installation contains directory structures for three different servers, as shown in the following figure. One way to verify that your WebLogic Server software is installed correctly is to start one of these servers.

Figure 7-1 WebLogic Server Directory Structures for the Default, Examples, and Pet Store Servers


 
 
 

Note: The example and Pet Store applications reside in the wlserver6.1/samples directory structure.

 


Starting the Default, Examples, and Pet Store Servers

The following sections provide procedures for starting the default server, the examples server, and the Pet Store server on a Windows or UNIX system. The procedure for starting the Pet Store server also includes the procedure for starting the Pet Store application on the Pet Store server.

You cannot run these servers concurrently because they are configured to share the same ports that you entered in the Default Server Configuration window during the installation (by default, port 7001 for non-secure connections, and 7002 for SSL connections). However, you can change a server's port configurations by editing the server's start command script and specifying the following Java command-line options:

In the following listing, for example, the added Java command-line options highlighted in bold will change the examples server port configurations to 7005 (non-secure) and 7006 (SSL). These values become the run-time listen port values when you use the modified startExamplesServer.cmd/sh script to start the examples server, and the listen port values stored in the examples server config.xml file are ignored.

Listing 7-1 Modified startExamplesServer.cmd Script

.
.
.
"%JAVA_HOME%\bin\java" -hotspot -ms64m -mx64m -classpath 
    %CLASSPATH% -Dweblogic.Domain=examples 
    -Dweblogic.Name=examplesServer -Dbea.home="C:\bea" 
    -Dcloudscape.system.home=./samples/eval/cloudscape/data 
    -Djava.security.policy=="C:\bea\wlserver6.1/lib/weblogic.policy"
    -Dweblogic.ListenPort=7005 -Dweblogic.SSL.ListenPort=7006
    weblogic.Server
goto finish
:finish
cd config\examples
ENDLOCAL

The default, examples, and Pet Store servers all run under the system identity, which is the system account created during the WebLogic Server installation. As of WebLogic Server version 6.1, the system password for all three servers is the password that you specified during the installation. Although no password.ini files are included in the WebLogic Server 6.1 installation, WebLogic Server still supports the use of password.ini files for the examples and Pet Store servers.

After starting the default, examples, or Pet Store server, you can start the Administration Console to monitor the server and any application that the server is running. The Administration Console is the Web-based administrator front-end (administrator client interface) to WebLogic Server.

Bear in mind that HTTP tunneling is disabled by default for all servers. As a result, all WebLogic Java-based clients will fail to connect to the server over HTTP and HTTPS (HTTP using SSL). For example, if you run a Java-based client example (such as examples.ejb.basic.statelessSession) over HTTP/HTTPS, the example fails. Browser-based clients are not affected by this configuration because they do not use HTTP tunneling. To resolve this issue, you must enable HTTP tunneling. For information about how to enable HTTP tunneling, see "Configuring WebLogic Server Web Components" in the Administration Guide.

Starting the Default Server on a Windows System

Choose a method to start the default server:

The following table provides a procedure for each method.

To start the default server . . .

Perform the following steps . . .

By using a shortcut icon

  1. Choose Start—>Programs—>BEA WebLogic E-Business Platform—>WebLogic Server 6.1—>Start Default Server.

    The following prompt appears in the server window.

    Enter password to boot WebLogic server:

  2. Type the password that you specified in the Create System Password window (during installation) and press Enter. The default server starts under the system identity (system account).

Note: Starting the default server from the Start menu is equivalent to running the startWebLogic.cmd script.

By running the sample script startWebLogic.cmd

  1. Open a command-line shell.

  2. Go to the following directory:

    wls_6.1_prod_dir\config\domain_name

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software, and domain_name represents the name of the domain you specified during installation (mydomain by default).

  3. Enter startWebLogic at the prompt.

    The startWebLogic.cmd script ensures that the default server is started with the configurations in the config\domain_name\config.xml file and that the CLASSPATH variable is set correctly.

    The following prompt appears in the server window.

    Enter password to boot WebLogic server:

  4. Type the password that you specified in the Create System Password window (during installation) and press Enter. The default server starts under the system identity (system account).

From the command line

WebLogic Server is a Java class file, and like any Java application, you can start it by running the java command. Because you may need to include many arguments to start WebLogic Server, the command line may be long.

See "Starting the WebLogic Administration Server from the Command Line" in the Administration Guide for details about starting the default server from the command line.


 

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

Starting the Default Server on a UNIX System

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

  1. Go to the following directory:
    wls_6.1_prod_dir/config/domain_name
    

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software, and domain_name represents the name of the domain you specified during installation (mydomain by default).

  2. Complete one of these steps:

  3. Type the password that you specified in the Create System Password window (during installation) and press Enter. The default server starts under the system identity (system account).

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

Starting the Examples Server on a Windows System

The example applications are contained in the wls_6.1_prod_dir\samples\examples directory, where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software. The examples demonstrate a variety of features using WebLogic Server. Additional information for configuring and executing the examples server and the example applications is provided in the wls_6.1_prod_dir\samples\examples\example.html file.

Choose a method to start the examples server:

The following table provides a procedure for each method.

To start the Examples server . . .

Perform the following steps . . .

By using a shortcut icon

  1. Choose Start—>Programs—>BEA WebLogic E-Business Platform—>WebLogic Server 6.1—>Examples—>Start Examples Server.

    The following prompt appears in the server window.

    Enter password to boot WebLogic server:

  2. Type the password that you specified in the Create System Password window (during installation) and press Enter. The examples server starts under the system identity (system account).

Note: Starting the examples server from the Start menu is equivalent to running the startExamplesServer.cmd script.

By running the sample script startExamplesServer.cmd

  1. Open a command-line shell.

  2. Go to the following directory:

    wls_6.1_prod_dir\config\examples

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software.

  3. Enter startExamplesServer at the prompt.

    The startExamplesServer.cmd script sets up the proper CLASSPATH variable for the examples server and loads the configurations in the config\examples\config.xml file by setting the weblogic.Domain property to examples.

    The following prompt appears in the server window.

    Enter password to boot WebLogic server:

  4. Type the password that you specified in the Create System Password window (during installation) and press Enter. The examples server starts under the system identity (system account).

From the command line

WebLogic Server is a Java class file, and like any Java application, you can start it by running the java command. Because you may need to include many arguments to start WebLogic Server, the command line may be long.

See "Starting the WebLogic Administration Server from the Command Line" in the Administration Guide for details about starting the examples server from the command line.


 

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

Starting the Examples Server on a UNIX System

The example applications are contained in the wls_6.1_prod_dir/samples/examples directory, where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software. The examples demonstrate a variety of features using WebLogic Server. Additional information for configuring and executing the examples server and the example applications is provided in the wls_6.1_prod_dir/samples/examples/example.html file.

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

  1. Go to the following directory:
    wls_6.1_prod_dir/config/examples
    

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software.

  2. Complete one of these steps:

  3. Type the password that you specified in the Create System Password window (during installation) and press Enter. The examples server starts under the system identity (system account).

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

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 Tour 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 Tour running on the server. Additional information for configuring and executing the Pet Store server and the Pet Store application is provided in the wls_6.1_prod_dir\samples\petStore\petstore.html file.

Choose a method to start the Pet Store server and application:

The following table provides a procedure for each method.

To start the Pet Store server and application . . .

Perform the following steps . . .

By using a shortcut icon

  1. Choose Start—>Programs—>BEA WebLogic E-Business Platform—>WebLogic Server 6.1—>WebLogic Server Tour—>Run Pet Store.

    The following prompt appears in the server window.

    Enter password to boot WebLogic server:

  2. Type the password that you specified in the Create System Password window (during installation) and press Enter. The Pet Store server starts under the system identity (system account).

Note: Starting the Pet Store server from the Start menu is equivalent to running the startPetStore.cmd script.

By running the sample script startPetStore.cmd

  1. Open a command-line shell.

  2. Go to the following directory:

    wls_6.1_prod_dir\config\petstore

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software.

  3. Enter startPetStore at the prompt.

    The startPetStore.cmd script sets up the proper CLASSPATH variable for the Pet Store server and loads the configurations in the config\petstore\config.xml file by setting the weblogic.Domain property to petstore.

    The following prompt appears in the server window.

    Enter password to boot WebLogic server:

  4. Type the password that you specified in the Create System Password window (during installation) and press Enter. The Pet Store server starts under the system identity (system account).

From the command line

WebLogic Server is a Java class file, and like any Java application, you can start it by running the java command. Because you may need to include many arguments to start WebLogic Server, the command line may be long.

See "Starting the WebLogic Administration Server from the Command Line" in the Administration Guide for details about starting the Pet Store server from the command line.


 

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

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 Tour 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 Tour running on the server. Additional information for configuring and executing the Pet Store server and the Pet Store application is provided in the wls_6.1_prod_dir/samples/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:
    wls_6.1_prod_dir/config/petstore
    

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software.

  2. Complete one of these steps:

  3. Type the password that you specified in the Create System Password window (during installation) and press Enter. The Pet Store server starts under the system identity (system account).

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

 


Starting the Administration Console

You must start the default server before you can access the default server via the default console. Similarly, you must start the examples server before you can access the examples server via the examples console, and you must start the Pet Store server before you can access the Pet Store server via the Pet Store console. The default console, examples console, and Pet Store console are instances of the Administration Console, which is the Web-based administrator front-end (administrator client interface) to WebLogic Server.

Note: For details about starting the WebLogic Server servers, see Starting the Default, Examples, and Pet Store Servers.

To start the default, examples, or Pet Store Administration Console, follow these steps:

  1. Open the following URL in a supported browser:
    http://hostname:port/console
    

    where:

  2. When starting the default, examples, or Pet Store Administration Console, you are prompted for a username and password to log in to the server. Enter system as the username, and enter the password you created during installation as the password.

For complete details about using the Administration Console to configure a WebLogic Server server, see "Starting and Stopping WebLogic Servers" in the Administration Guide.

 


Shutting Down the Default, Examples, and Pet Store Servers

The following sections provide procedures for shutting down the default server, the examples server, and the Pet Store server on a Windows or UNIX system. The procedure for shutting down the Pet Store server includes the procedure for shutting down the Pet Store application running on the Pet Store server.

Shutting Down the Default Server

You can shut down the default server from the console or command line as described in the following table.

To shut down the default server from the . . .

Complete the following procedure . . .

Administration Console

  1. In the Administration Console domain tree (in the left pane), click the + in front of Servers to display the list of servers.

  2. Right-click the name of the server that you want to stop and choose Stop this server.

Command line

  1. Open a command-line shell.

  2. Set the PATH and CLASSPATH variables to include the location in which the JDK 1.3 (or higher) is installed. You can include them as arguments on the java command line, or by executing a sample script provided with your software. To execute the script, go to the following directory:

    wls_6.1_prod_dir\config\domain_name (Windows)

    wls_6.1_prod_dir/config/domain_name (UNIX)

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software, and domain_name represents the name of the domain you specified during installation (mydomain by default).

    On a Windows system, enter the following command:

    setEnv

    On a UNIX system, enter the following command:

    . ./setEnv.sh

  3. Enter the following command:

    java weblogic.Admin -url localhost:port -username username -password password SHUTDOWN

    The arguments in this command line are defined as follows:

    port is the default server listen port (default is 7001).

    username is the system username created during installation.

    password is the password that you specified in the Create System Password window during installation.


 

Shutting Down the Examples Server

You can shut down the examples server from the console or command line as described in the following table.

To shut down the examples server from the . . .

Complete the following procedure . . .

Administration Console

  1. In the Administration Console domain tree (in the left pane), click the + in front of Servers and then select the server you want to shut down.

  2. Right-click the name of the server that you want to stop and choose Stop this server.

Command line

  1. Open a command-line shell.

  2. Set the PATH and CLASSPATH variables to include the location in which the JDK 1.3 (or higher) is installed. You can include them as arguments on the java command line, or by executing a sample script provided with your software. To execute the script, go to the following directory:

    wls_6.1_prod_dir\config\examples (Windows)

    wls_6.1_prod_dir/config/examples (UNIX)

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software.

    On a Windows system, enter the following command:

    setExamplesEnv

    On a UNIX system, enter the following command:

    . ./setExamplesEnv.sh

  3. Enter the following command:

    java weblogic.Admin -url localhost:port -username username -password password SHUTDOWN

    The arguments in this command line are defined as follows:

    port is the examples server listen port (default is 7001).

    username is the system username created during installation.

    password is the password that you specified in the Create System Password window during installation.


 

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

Shutting Down the Pet Store Server and Application

You can shut down the Pet Store server from the console or command line as described in the following table.

To shut down the Pet Store server from the . . .

Complete the following procedure . . .

Administration Console

  1. In the Administration Console domain tree (in the left pane), click the + in front of Servers and then select the server you want to shut down.

  2. Right-click the name of the server that you want to stop and choose Stop this server.

Command line

  1. Open a command-line shell.

  2. Set the PATH and CLASSPATH variables to include the location in which the JDK 1.3 (or higher) is installed. You can include them as arguments on the java command line, or by executing a sample script provided with your software. To execute the script, go to the following directory:

    wls_6.1_prod_dir\config\examples (Windows)

    wls_6.1_prod_dir/config/examples (UNIX)

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software.

    On a Windows system, enter the following command:

    setExamplesEnv

    On a UNIX system, enter the following command:

    . ./setExamplesEnv.sh

  3. Enter the following command:

    java weblogic.Admin -url localhost:port -username username -password password SHUTDOWN

    The arguments in this command line are defined as follows:

    port is the Pet Store server listen port (default is 7001).

    username is the system username created during installation.

    password is the password that you specified in the Create System Password window during installation.


 

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

 


Uninstalling WebLogic Server

Uninstalling WebLogic Server does not remove the BEA Home directory associated with the installation but does remove all WebLogic Server components installed by the installer program. The uninstallation also removes the product directory associated with the installation unless one of the following is true:

If the WebLogic Server installation was upgraded with a Service Pack at the customer site, you must uninstall the Service Pack before uninstalling WebLogic Server. For information about uninstalling Service Packs, see Uninstalling a Service Pack.

To uninstall WebLogic Server, complete the procedures for the appropriate platform, provided in the following table.

To uninstall WebLogic Server on this platform . . .

Complete the following procedure . . .

Windows

  1. Shut down any servers that are running. For instructions, see Shutting Down the Default, Examples, and Pet Store Servers.

  2. From the Windows Start menu, choose Start—>Programs—>BEA WebLogic E-Business Platform—>WebLogic Server 6.1—>Uninstall WebLogic Server 6.1 (or Uninstall WebLogic Server 6.1(spx)).

    The BEA Installation program Uninstaller window appears.

  3. Click Uninstall to start the uninstall program.

  4. Click Exit in the Uninstall Complete window.

UNIX

  1. Shut down any servers that are running. For instructions, see Shutting Down the Default, Examples, and Pet Store Servers.

  2. Set the PATH and CLASSPATH variables to include the location in which the JDK 1.3 (or higher) software is installed. You can include them as arguments on the java command line, or by executing a sample script provided with your software. To execute the script, go to the following directory:

    wls_6.1_prod_dir/config/domain_name

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software, and domain_name represents the name of the domain you specified during installation (mydomain by default).

    Enter the following command at the prompt:

    . ./setEnv.sh

  3. Go to the following directory:

    wls_6.1_prod_dir/uninstaller

    where wls_6.1_prod_dir represents the product directory in which you installed the WebLogic Server software.

  4. Choose one of two methods for uninstalling the software:

    • To use the GUI-mode installation program, go to step 5.

    • To use the console-mode procedure, go to step 6.

  5. (GUI-mode method) Enter the sh uninstall command at the prompt. In the Uninstaller window, click Uninstall to start the uninstall program, then click Exit in the Uninstall Complete window to complete the uninstallation.

  6. (Console-mode method) Enter the sh uninstall -i console command at the prompt. When the uninstall process is complete, press Enter to exit the uninstaller.

 

 


Reinstalling WebLogic Server

When you start the BEA Installation program on a system on which a copy of WebLogic Server 6.1 is already installed, the BEA Installation program detects the existing installation and provides you with the prompts shown in the following table.

Click . . .

To . . .

Cancel

Return to the Choose BEA Home Directory window. You cannot install multiple copies of WebLogic Server 6.1 having the same BEA Home directory. To continue installing the software using a different BEA Home directory, select an existing BEA Home directory that does not contain a WebLogic Server installation or create a new BEA Home directory.

Exit

Exit the installation program and uninstall the previous installation. You can invoke the uninstall program as described in Uninstalling WebLogic Server, and reinstall the software as described in one of the following:


 

As of WebLogic Server version 6.1, you are not allowed to reinstall WebLogic Server over a previous WebLogic Server 6.0 or 6.1 installation. To reinstall WebLogic Server, you must first uninstall the previous installation.

Note About Machine Names When Resinstalling WebLogic Server

If you reinstall WebLogic Server 6.1 on a machine after uninstalling it, the installation program checks the primary name of the machine and compares it to the name of the machine in the registry.xml file. If the names do not match (for example, if you changed the primary name of the machine), the installation will fail. As a work-around, you can update the machine name in the registry.xml file.

The installation program expects the format of the machine name to be the value returned by the following Java method:

InetAddress.getLocalHost().getHostName()

You can write a short Java program that uses this method to get the machine name in the proper format to update the registry.xml file.

 

back to top previous page