B Installing WebLogic Server for Developers

The WebLogic Server development release includes all the necessary files to develop and test applications on WebLogic Server, but uses less disk space than a complete WebLogic Server installation. The development installation is intended only for development. It is supported on Windows, Linux and Mac OS X systems.

This section includes the following topics:

B.1 Files Included with WebLogic Server Development

The development installation has two JAR files.

  • Base development installer—Contains required WebLogic Server components:

    • Essential development files, such as Core Application Server and Coherence

    • WebLogic Server Administration Console

    • WebLogic client JAR files

    • TopLink

    • Jackson (open-source Java JSON processor)

    • Jersey (open-source RESTful Web Services framework)

    • Maven (open-source repository manager)

    • OPatch

    • OUI installation and deinstallation files

    The base installer does not include:

    • Native JNI libraries for unsupported platforms

    • Oracle Configuration Manager (OCM)

    • Web services clients

    • Server samples

    • Coherence examples

    • WebLogic Server Administration Console Language help files

    • Derby evaluation database

  • Supplement development installer—this JAR file adds the following optional WebLogic Server components to an existing base development installation:

    • Server examples

    • Derby evaluation database

    • WebLogic Server Administration Console Language help files

    • Coherence examples

    • Web services clients

    Note:

    For up-to-date information and known issues for WebLogic Server for Developers base and supplemental installers, see README files available for each development installer on the Oracle download site.

B.2 Downloading the Installers

This section details how to download the installers from the Oracle Technology Network.

To download the files:

  1. Create theORACLE_HOME directory in which to install WebLogic Server for Developers.
  2. Navigate to http://download.oracle.com. WebLogic Server for Developers JAR files are available only on Oracle Technology Network.
  3. Navigate to the WebLogic Server 12c (12.2.1.3.0) download page.
  4. Accept the license agreement.
  5. Navigate to the page that lists all WebLogic Server for Developers distributions.
  6. Right click on the link for each file you want to download and save the file to the directory you created in Step 1.

B.3 WebLogic Server for Developers Installation Prerequisites

The Developers installation has disk space and JDK requirements.

The WebLogic Server for Developers installation requires:

  • A minimum of 800MB of disk space

  • JDK 1.8 update or greater

Before you run the installer:

  • Set JAVA_HOME in the shell window you are using to run the installation.

    Operating System Example Commands

    Linux

    export JAVA_HOME=/myhome/jdk1.8.0_131

    Mac

    export JAVA_HOME= /Library/Java/JavaVirtualMachines/1.8.0.jdk/Contents/Home

    export USER_MEM_ARGS="-Xmx1024m"

    Windows

    set JAVA_HOME=C:\Program Files\java\jdk1.8.0_131

  • For Mac environments, Oracle recommends that you set the Xmx memory argument

  • Create the ORACLE_HOME directory prior to starting the installation. This directory must exist and must be empty before running the basic installer.

B.4 Installing WebLogic Server for Developers

The WebLogic Server for Developers installation uses Oracle Universal Installer to run a silent operation. No input is needed.

You must install the WebLogic Server for Developers base installation first. After it installs, if you want components included in the supplemental installer, run the WebLogic Server for Developers supplemental installation using the same steps.

Topics in this section include the following:

B.4.1 Installing from the ORACLE_HOME Directory

Follow these steps to run the installer from the ORACLE_HOME directory.

  1. Change to the ORACLE_HOME directory you created.
  2. Enter the following command to start the installation, where path is the directory location that you downloaded the installation JAR file to:
    java -jar path/installer_jar_filename
    

    For example, if you stored the JAR file in /myhome/downloads:

    java -jar /myhome/downloads/installer_jar_filename
    
  3. When installation completes, see Creating a Development Domain.

B.4.2 Installing from a Directory Other Than ORACLE_HOME

Follow these steps to run the installer from a directory other than ORACLE_HOME directory

  1. Change to the directory that contains the installer JAR file.
  2. Enter the following command to start the installation, setting the ORACLE_HOME parameter to the ORACLE_HOME directory you created.
    java -jar installer_jar_filename ORACLE_HOME=path_to_MW_HOME
    

    For example, if ORACLE_HOME is /myhome/wls1221:

    java -jar installer_jar_filename ORACLE_HOME=/myhome/wls1221
    
  3. When installation completes, see Creating a Development Domain.

B.5 Creating a Development Domain

You create a development domain in the same way you normally do for WebLogic Server using either the Configuration Wizard or WebLogic Scripting Tool (WLST).

Oracle recommends that you create the domain outside the ORACLE_HOME directory.

To create a domain using the Configuration Wizard:

  1. Change to the oracle_common/common/bin directory in your ORACLE_HOME:
    cd ORACLE_HOME/oracle_common/common/bin
    
  2. Start the Configuration Wizard:
    Environment Command

    UNIX or Mac

    ./config.sh
    

    Windows

    config.cmd
    

For detailed information about Configuration Wizard screens, click Help or see Overview of the Configuration Wizard in Creating WebLogic Domains Using the Configuration Wizard.

To create a domain using WLST, see Create WebLogic Domains Using WLST Offline in Understanding the WebLogic Scripting Tool.

B.6 Starting and Accessing the Domain

You start your domain before accessing the Administration Console.

To start your WebLogic domain and access the Administration Console:

  1. Change to the domain directory.
  2. Enter the following command:
    Environment Command

    UNIX or Mac

    ./startWebLogic.sh
    

    Windows

    startWebLogic.cmd
    
  3. When the domain is in a RUNNING state, open a Web browser and enter the domain's URL. Use the Administration Port value you entered when creating the domain. For example:
    http://localhost:7001/console/
    
  4. Log in to the Administration Console using the Administrator user name and password you entered when you created the domain.

For more about starting and stopping WebLogic Server, see Starting and Stopping Servers in Administering Server Startup and Shutdown for Oracle WebLogic Server.

For more about the WebLogic Server Administration Console, see Start the Console in Oracle WebLogic Server Administration Console Online Help.

B.7 Upgrading a Development Installation

To upgrade a development installation, you must download and install the new distribution to a new location. After installing the new distribution, use the Fusion Middleware Reconfiguration Wizard or WLST to associate an existing domain with the new installation.

To upgrade a domain by using the Reconfiguration Wizard:

  1. Change to the oracle_common/common/bin directory in the new ORACLE_HOME:
    cd ORACLE_HOME/oracle_common/common/bin
    
  2. Start the Reconfiguration Wizard:
    Environment Command

    UNIX or Mac

    ./reconfig.sh
    

    Windows

    reconfig.cmd
    

For more details on the Reconfiguration Wizard, click Help or see Introduction in Online Help.

To upgrade a domain using WLST, see Reconfiguring a WebLogic Domain Using WebLogic Scripting Tool in Upgrading Oracle WebLogic Server.

B.8 Patching a Development Installation

You use the Oracle Patching tool (OPatch) to apply patches to a WebLogic Server development installation.

For information about upgrading WebLogic Server, see About Rolling Updates in Upgrading Oracle WebLogic Server.

For information about using OPatch, see Patching with OPatch.

B.9 Removing the WebLogic Server for Developers Installation

Use the Oracle Universal Installer (OUI) deinstallation tool to remove a WebLogic Server for Developers installation.

To remove a WebLogic Server for Developers installation:

  1. Go to the oui/bin directory:
    cd ORACLE_HOME/oui/bin
    
  2. Run the deinstaller:
    Environment Command

    UNIX or Mac

    ./deinstall.sh
    

    Windows

    deinstall.cmd
    
  3. Click Next.
  4. Click Deinstall. Wait for deinstallation to complete.
  5. Click Finish
  6. Navigate up three directory levels:
    cd ../../..
    
  7. Remove the ORACLE_HOME directory:
    Environment Command

    UNIX or Mac

    rm -r ORACLE_HOME
    

    Windows

    rmdir ORACLE_HOME
    

    For example:

    rm -r /myhome/wls1221
    

For more about deinstallation, see Uninstalling Oracle WebLogic Server and Coherence.