Middleware

Oracle WebLogic 12c on Windows User Guide

| Product: Oracle WebLogic 12c on Windows

Overview

This guide covers the deployment and configuration of Oracle WebLogic Server 12c (12.2.1.4.0) on Windows Server using cloudimg AMIs from the AWS Marketplace.

What's included in this AMI:

  • Oracle WebLogic Server 12c (12.2.1.4.0) with Java EE 7 support
  • Oracle JDK 8 LTS
  • Pre-configured WebLogic domain with Admin Server on port 7001
  • Traditional web-based Administration Console at /console
  • Scheduled Task for automatic startup at boot
  • Oracle software installed on separate D: drive (20GB EBS volume)
  • AWS CLI, Systems Manager Agent, and CloudWatch Agent

Supported Operating Systems: Windows Server 2022, Windows Server 2019

Prerequisites

Before launching this AMI, ensure you have:

  1. An active AWS account
  2. An active subscription to the Oracle WebLogic 12c on Windows listing on AWS Marketplace
  3. An RDP client (Remote Desktop Connection) on your local machine
  4. Familiarity with EC2 instance management

Recommended Instance Type: m5.large (2 vCPU, 8 GB RAM) or larger for production workloads.

Step 1: Launch the AMI

  1. Navigate to the AWS Marketplace and search for "Oracle WebLogic 12c Windows cloudimg"
  2. Click Continue to Subscribe, accept the terms, then Continue to Configuration
  3. Select your preferred Region and Software Version (Windows Server 2022 or 2019)
  4. Click Continue to Launch
  5. Choose Launch through EC2 for full control over instance configuration
  6. Select your instance type (m5.large recommended)
  7. Configure your Security Group with the following inbound rules:
Port Protocol Source Purpose
3389 TCP Your IP RDP access
7001 TCP Your IP WebLogic Administration Console
7002 TCP Your IP WebLogic Server (SSL)

Important: Restrict all ports to your IP address only. Do not open these to 0.0.0.0/0.

Step 2: Connect via RDP

  1. In the EC2 console, select your instance and click Connect
  2. Choose the RDP client tab
  3. Click Get password and upload your key pair (.pem file) to decrypt the Administrator password
  4. Download the Remote Desktop file or note the Public DNS
  5. Open your RDP client and connect using:
  6. Computer: Your instance's Public IP or DNS
  7. Username: Administrator
  8. Password: The decrypted password from the EC2 console

Alternatively, use SSM Session Manager for console access without opening port 3389:

https://us-east-1.console.aws.amazon.com/systems-manager/session-manager/<instance-id>?region=us-east-1

Step 3: Retrieve WebLogic Credentials

The WebLogic admin password is unique to each AMI instance. To retrieve it, open a Command Prompt or PowerShell window and run:

type C:\CREDENTIALS.txt
  • Username: weblogic
  • Password: (unique per instance, see C:\CREDENTIALS.txt)

Important: Change the password after first use. See the Security Hardening section below.

Step 4: Verify the Installation

Open PowerShell and verify the WebLogic installation:

# Check JDK version
& "$env:JAVA_HOME\bin\java.exe" -version

# Check WebLogic home exists
Test-Path D:\Oracle\Middleware\wlserver\server\bin\setWLSEnv.cmd

# Check domain exists
Test-Path D:\Oracle\Middleware\user_projects\domains\base_domain\config\config.xml

# Check scheduled task
Get-ScheduledTask -TaskName OracleWebLogicServer | Select TaskName, State

# Check D: drive
Get-Volume -DriveLetter D

Step 5: Start WebLogic Server

WebLogic is configured to start automatically at boot via a Scheduled Task. To start it manually:

Start-ScheduledTask -TaskName OracleWebLogicServer

Wait approximately 60 to 90 seconds for the server to start. You can verify it's running:

# Check the scheduled task state
Get-ScheduledTask -TaskName OracleWebLogicServer | Select State

# Check if port 7001 is listening
Get-NetTCPConnection -LocalPort 7001 -ErrorAction SilentlyContinue

Step 6: Access the Administration Console

Open a web browser and navigate to:

http://<public-ip>:7001/console

You will see the Oracle WebLogic Server Administration Console login page.

Enter your credentials: - Username: weblogic - Password: The password from C:\CREDENTIALS.txt

Click Login to access the console.

After logging in, you will see the Administration Console dashboard showing the Domain Structure, server status, and configuration options.

Directory Structure

Path Description
D:\Oracle\Java\jdk1.8.0_XXX\ Oracle JDK 8 LTS (JAVA_HOME)
D:\Oracle\Middleware\ Middleware Home (MW_HOME / ORACLE_HOME)
D:\Oracle\Middleware\wlserver\ WebLogic Server Home (WL_HOME)
D:\Oracle\Middleware\user_projects\domains\base_domain\ Default Domain (DOMAIN_HOME)
D:\Oracle\oraInventory\ Oracle Inventory
C:\CREDENTIALS.txt Admin credentials file

Environment variables are set system-wide:

JAVA_HOME = D:\Oracle\Java\jdk1.8.0_XXX
MW_HOME = D:\Oracle\Middleware
WL_HOME = D:\Oracle\Middleware\wlserver
DOMAIN_HOME = D:\Oracle\Middleware\user_projects\domains\base_domain

Using the Administration Console

The WebLogic Administration Console is a web-based interface for managing all aspects of your WebLogic domain.

Accessing the Console

Navigate to http://<PUBLIC_IP>:7001/console in your web browser and log in with the weblogic user.

Editing Configuration

The console operates in a lock and edit mode. To make changes:

  1. Click Lock & Edit in the Change Center panel on the left.
  2. Make your configuration changes.
  3. Click Release Configuration to save and apply.

This ensures that multiple administrators do not make conflicting changes simultaneously.

Key Console Sections

  • Domain Structure in the left panel shows the overall domain tree including Environment, Deployments, Services, Security Realms, and Diagnostics.
  • Environment > Servers displays all configured server instances.
  • Deployments allows you to deploy and manage Java EE applications and modules.
  • Services > Data Sources is where you configure JDBC connections to databases.
  • Security Realms manages users, groups, roles, and authentication providers.
  • Diagnostics provides access to log files, images, and performance data.

Deploying an Application

  1. Click Lock & Edit.
  2. Navigate to Deployments in the left panel.
  3. Click Install and browse to your WAR, EAR, or JAR file.
  4. Follow the wizard to select targeting options and deployment settings.
  5. Click Release Configuration to activate the deployment.

WLST Command Line

WebLogic Scripting Tool (WLST) provides command line administration:

# Launch WLST
& "D:\Oracle\Middleware\wlserver\common\bin\wlst.cmd"

# In WLST shell:
connect('weblogic', '<your-password>', 't3://localhost:7001')
serverRuntime()
print('Server State: ' + cmo.getState())

Managing WebLogic Server

Using Scheduled Task

# Start WebLogic
Start-ScheduledTask -TaskName OracleWebLogicServer

# Stop WebLogic (graceful)
Stop-ScheduledTask -TaskName OracleWebLogicServer

# Check status
Get-ScheduledTask -TaskName OracleWebLogicServer | Select TaskName, State

Using Domain Scripts Directly

# Start
& "D:\Oracle\Middleware\user_projects\domains\base_domain\bin\startWebLogic.cmd"

# Stop
& "D:\Oracle\Middleware\user_projects\domains\base_domain\bin\stopWebLogic.cmd"

Security Hardening

Change the Default Admin Password

Option 1: Via the Administration Console (Recommended)

  1. Log in to the console at http://<PUBLIC_IP>:7001/console
  2. Click Lock & Edit in the top left pane.
  3. In the left hand navigation, click Security Realms.
  4. Click myrealm to open the security realm settings.
  5. Select the Users and Groups tab.
  6. Click on the weblogic user.
  7. Select the Passwords tab.
  8. Enter your new strong password in both the New Password and Confirm New Password fields.
  9. Click Save.
  10. Click Release Configuration to apply the changes.

Option 2: Via WLST

& "D:\Oracle\Middleware\wlserver\common\bin\wlst.cmd"

# In WLST:
connect('weblogic', '<your-password>', 't3://localhost:7001')
cd('/SecurityConfiguration/base_domain/Realms/myrealm/AuthenticationProviders/DefaultAuthenticator')
cd('Users/weblogic')
cmo.setPassword('YourNewSecurePassword')
disconnect()
exit()

After changing the password, update boot.properties:

Set-Content -Path "D:\Oracle\Middleware\user_projects\domains\base_domain\servers\AdminServer\security\boot.properties" -Value "username=weblogic`npassword=YourNewSecurePassword"

Delete the credentials file:

Remove-Item C:\CREDENTIALS.txt

Restrict Network Access

Ensure your Security Group only allows access from trusted IP addresses:

  • Port 3389 (RDP): Your IP only
  • Port 7001/7002 (WebLogic Server): Your IP or VPN CIDR only

Troubleshooting

WebLogic Server fails to start

Check the server log:

Get-Content "D:\Oracle\Middleware\user_projects\domains\base_domain\servers\AdminServer\logs\AdminServer.log" -Tail 50

Common causes: - Insufficient memory: Use an instance type with at least 4 GB RAM - Port conflict: Ensure port 7001 is not in use - Scheduled Task not running: Get-ScheduledTask -TaskName OracleWebLogicServer

Cannot connect via RDP

  1. Verify the instance is running in the EC2 console
  2. Check Security Group allows port 3389 from your IP
  3. Verify you have the correct Administrator password (decrypt via EC2 console)
  4. Use SSM Session Manager as an alternative

Administration Console is not accessible

  1. Confirm the WebLogic server is running: Get-NetTCPConnection -LocalPort 7001 -ErrorAction SilentlyContinue
  2. Verify your Security Group allows inbound traffic on port 7001
  3. Ensure you are using http:// (not https://) and the correct port in the URL
  4. Allow 2 to 3 minutes after startup for the Administration Console to fully initialise

Cannot log in to the Administration Console

  • Verify you are using the username weblogic (case sensitive)
  • Retrieve the correct password from C:\CREDENTIALS.txt
  • If you have changed the password and forgotten it, you will need to reset it using WLST from the command line

Oracle WebLogic 12c Key Features

  • Java EE 7 Platform: Full support for Java EE 7 standards including Servlet 3.1, JAX-RS 2.0, JPA 2.1, and WebSocket 1.0
  • JDK 8 LTS: Long term support Java runtime
  • Administration Console: Traditional web-based management interface for complete server administration
  • Dynamic Clustering: Elastic server instances for horizontal scaling
  • Oracle Coherence Integration: In-memory data grid for distributed caching
  • WLST Scripting: WebLogic Scripting Tool for automated administration and deployment

Support

cloudimg provides 24/7/365 support for all AWS Marketplace products.