rw

Published May 2, 2025.

Introduction This post supports the master Real-World Performance Testing for Oracle Analytics Cloud with Apache JMeter blog and guides in preparing Apache JMeter on Linux for performance testing of Oracle Analytics Cloud. It is a companion post to Prepare Apache JMeter on Windows for Oracle Analytics Performance Testing and includes architectural diagrams, component descriptions, deployment guidance, and links to other references.

Oracle Analytics Cloud

OAC (Oracle Analytics Cloud) is a scalable and secure Oracle Cloud service that provides a full set of capabilities to explore and perform collaborative analytics for you, your workgroup, and your enterprise. Features include:

  • Data visualization and storytelling
  • Machine learning
  • Mobile analytics
  • Open data source connectivity
  • Data preparation and enrichment
  • Enterprise data modeling
Apache JMeter

Apache JMeter is an open-source tool for performance testing that allows you to simulate real-world OAC user experiences and measure the performance of your reports.

Prerequisites

Following the guidance in this post requires:

  • An existing OCI (Oracle Cloud Infrastructure) tenancy.
  • An OCI Administrator with the authority to:
    • Manage Compartments.
    • Manage Compute Instances.
    • Manage Analytics Platform Instances.
    • Manage Virtual Cloud Networks.
Topics
rw
Architecture

The various architectures JMeter uses with OAC are too numerous to describe in this post. The diagrams presented in this section depict three scenarios, each with a different analytics platform component.

Initial States

LJM_Slide2

This diagram depicts an OAC instance with a public endpoint.

LJM_Slide4

This diagram depicts an OAC instance with a private endpoint.

Prepared States

The diagrams in this section depict JMeter installed in a Linux compute instance in an OCI VCN (Virtual Cloud Network).

LJM_Slide5

This diagram depicts an OAC instance with a public endpoint.

LJM_Slide7

This diagram depicts an OAC instance with a private endpoint.

rw
Components

This section describes the components found in the architectural diagrams.

Initial Components
Oracle Services Network

The OSN (Oracle Services Network) is a conceptual network in OCI that is reserved for Oracle services. These services may have a public endpoint (IP address) and a publicly resolvable hostname, or a private endpoint and hostname resolvable from a VCN in a customer tenancy.

The OSN hosts the OAC instances depicted in the diagrams.

Virtual Cloud Network

A VCN is a virtual, private network that closely resembles a traditional network, with firewall rules and specific types of communication gateways that you can choose. A VCN resides in a single OCI region and covers one or more CIDR blocks (IPv4 and IPv6 if enabled). Each subnet consists of a contiguous range of IP addresses (for IPv4 and IPv6, if enabled) that do not overlap with other subnets in the VCN.

The VCN hosts the private OAC endpoint. It also supports private access to the OSN via a service gateway.

NAT Gateway

A NAT gateway gives cloud resources without public IP addresses access to the internet without exposing those resources to incoming internet connections.

The NAT gateway provides access to data sources not hosted in the OSN.

Service Gateway

A service gateway allows resources in a VCN to privately access services in the OSN without exposing the data to the public internet.

The service gateway provides access to the public OAC endpoint and the public data sources in the OSN.

Data Sources

The unspecified data sources in the diagram are used by the analytics platform services. They can exist in the OSN, on-premise, other clouds, and VCNs within OCI.

Prepared Components
Apache JMeter

The JMeter application is an open-source, 100% pure Java application designed to load test functional behavior and measure performance. It was originally designed for testing Web Applications but has since expanded to other test functions.

The diagrams show instances in a VCN in OCI.

OCI Virtual Machine

OCI compute instances, or VMs (Virtual Machines), run workloads securely at scale with flexible shapes and choices of operating systems.

In the diagrams, JMeter is in a Linux VM. Linux is a good choice for experienced JMeter users and requires additional preparation to enable a GUI (Graphical User Interface).

Oracle Java Development Kit

Oracle JDK (Java Development Kit) provides software for working with Java applications. The current version of Oracle JDK runs on Windows, MacOS, and Linux.

An Oracle JDK version 8 or higher is required by Apache JMeter. The next release of JMeter requires version 17 or higher.

rw
Deployment

A typical deployment sequence consists of:

  • OCI Configuration
  • Client Configuration
  • Linux Configuration
  • Validation
OCI Configuration
  1. Identify a VCN to contain the Linux VM hosting Apache JMeter.
    • If testing an OAC instance with a private endpoint, use the VCN hosting the service or endpoint.
    • If testing an OAC instance with a public endpoint, identify or create a VCN.
  2. The Linux VM hosting JMeter can reside in a public or private subnet within the VCN. This post’s examples use a public subnet.
    • If JMeter is accessible from a corporate network using VPN or FastConnect, identify or create a private subnet.
    • If JMeter is Internet accessible, identify or create a public subnet.
    • Ensure the subnet’s security rules allow outbound and inbound traffic to ports 22, 443, and 5901.
    • If using a public subnet and an OAC instance with a public endpoint, create an internet gateway and a corresponding route rule.
    • If using a private subnet:
      • If testing an OAC instance with a public endpoint in the same region, create a service gateway and a corresponding route rule.
      • If testing an OAC instance with a public endpoint in a different region, create a NAT gateway and a corresponding route rule.
  3. Create a Linux VM with an image and shape that meets the testing requirements. Note the SSH keys and the IP address.
Client Configuration
  1. Install a VNC viewer on your workstation.
  2. Create an entry in the SSH configuration file for the Linux VM using the IP address, username, and private key. Below is an example:

Host jmeter-linux
HostName 150.136.75.112
User opc
IdentityFile /Users/dcarley/SSH-KEYS/sshkeybundle/privateKey

Linux Configuration
  1. Connect to the Linux VM using SSH.
  2. Switch to the root account.
    • Install the Gnome desktop application.
    • Configure Gnome to start automatically.
    • Open ports 5901 and 443.
    • Assign VNC port 5901 to the opc user.
    • Create a Linux password for the opc user.
  3. Return to the opc account.
    • Create home directories for JMeter and Java.
    • Update the PATH environment variable to include JMeter and Java.
    • Create a VNC password.
    • Start VNC.
  4. Connect to Linux using VNC.
    • Download and install Apache JMeter.
    • Download and install an Oracle JDK.
Validation

Validate the JMeter installation by starting it.

  1. Connect to Linux using VNC.
  2. Start a terminal session.
  3. Start JMeter.

The JMeter GUI starts with an empty test plan.

rw
Explore More

Explore more about Oracle Analytics by visiting the community, blogs, and library.

Explore Analytics Platform Features
Explore Apache JMeter
Explore OCI Configuration
Explore Client Configuration
Explore Linux Configuration
rw
var coll = document.getElementsByClassName(“collapsible”); var i; for (i = 0; i < coll.length; i++) { coll[i].addEventListener("click", function() { this.classList.toggle("active"); var content = this.nextElementSibling; if (content.style.display === "block") { content.style.display = "none"; } else { content.style.display = "block"; } }); }