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

You download the installers from 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) 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 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_40

    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_40

  • 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 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 Administering Server Startup and Shutdown for Oracle WebLogic Server.

For more about the WebLogic Server Administration Console, refer to the 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 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 information on the Reconfiguration Wizard, click the Help button or see Upgrading Oracle WebLogic Server.

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 information about deinstallation, see Deinstalling Oracle WebLogic Server and Coherence.