This chapter describes how to provision WebLogic Server, including a fronting load balancer, on the Oracle Database Appliance using the Oracle WebLogic Server Configuration for Oracle Database Appliance utility (configuration utility).
The following sections are included in this chapter:
Oracle WebLogic Server on Oracle Database Appliance 2.9.1.0.0 is available on Oracle Database Appliance versions X4-2, X3-2, and V1.
Oracle WebLogic Server support is provided via Oracle Virtual Machine (OVM) template bundles which are pre-configured for the Oracle Database Appliance environment. Each bundle corresponds to an Oracle WebLogic Server version, either 11g (10.3.6) or 12c (12.1.1 or 12.1.2). Each of these bundles include:
Oracle Linux 5 Update 8
Oracle WebLogic Server (10.3.6, 12.1.1, or 12.1.2)
Oracle Traffic Director 11g (11.1.1.7)
Oracle WebLogic Server Configuration for Oracle Database Appliance utility
Oracle WebLogic Server on Oracle Database Appliance 2.9.1.0.0 OVM templates and the configuration utility can also be downloaded from Oracle Technology Network:
http://www.oracle.com/technetwork/middleware/weblogic-oda/downloads/index.html
The configuration utility provides an easy way to create and configure WebLogic domains with a choice of single or multiple clusters to serve your business applications, and configure Oracle Traffic Director, a software load balancer that can efficiently balance incoming requests to one of the WebLogic clusters.
Use the following procedure to download the OVM templates and the configuration utility. The configuration utility can be run on a local Windows, MacOS, or Linux client to create and save the configuration file for later use.
To download and install an updated configuration utility on a Windows or Linux client and on the Oracle Database Appliance:
Open a Web browser and access the following URL:
http://www.oracle.com/technetwork/middleware/weblogic-oda/downloads/index.html
In the Oracle WebLogic Server on Oracle Database Appliance section, right-click on the links and save the OVM templates and the Oracle WebLogic Server Configuration for Oracle Database Appliance utility file to any location on your Windows or Linux client machine.
Extract the file to any location on the client machine.
Copy the downloaded tar.gz file from the client to any location on the ODA_BASE domain of Node 0 using the following scp command:
scp filename root@ip_address:dest_dir
Replace filename with the name of the downloaded file, and replace ip_address with the IP address of ODA_BASE of Node 0 and replace dest_dir with the destination directory.
Extract the file to any directory on ODA_BASE.
Note:
When downloading an updated configuration utility to replace an existing one, Oracle recommends that you extract the updated files to the same directory as the original to avoid having multiple versions of the utility on the system.
For information on how to run the configuration utility, see "Using the Configuration Utility."
After completing the download, perform the following steps to install the WebLogic Server and Oracle Traffic Director OVM templates:
Extract the downloaded ZIP files to any location on the local client. After extraction, the following files are located in the directory, where version is either 1036, 1211, or 1212:
WLS_version_VMT.tar.gz
OTD_11117_VMT.tar.gz
wls_oda_configurator_2.9.1.0.0.tar.gz
Note:
You cannot upgrade from one version of Oracle WebLogic Server to another without re-provisioning. If you begin provisioning using Oracle WebLogic Server 12.1.1, you cannot automatically upgrade to Oracle WebLogic Server 12.1.2 without re-provisioning. You must download the 12.1.2 template and re-provision using the 12.1.2 template. Make sure you download the template with the appropriate Oracle WebLogic Server version.
Use scp to transfer the two template archives from the client to the /OVS/staging directory of Domain-0 on Node 0.
scp WLS_version_VMT.tar.gz root@ip_address:/OVS/staging
scp OTD_11117_VMT_tar.gz root@ip_address:/OVS/staging
Replace ip_address with the IP address of Domain-0 on Node 0.
Note:
For information about the architecture of the Oracle Database Appliance virtualized platform, see "Deploying Oracle Software on Oracle Database Appliance Virtualized Platform" in Oracle Database Appliance Getting Started Guide.
Do not extract the WLS and OTD tar.gz files.
Transfer the configuration utility file wls_oda_configurator_2.9.1.0.0.tar.gz to any location on the ODA_BASE domain on Node 0:
scp wls_oda_configurator_2.9.1.0.0.tar.gz root@ip_address:dest_dir
Replace ip_address with the IP address of the ODA_BASE domain on Node 0. Replace dest_dir with the destination directory.
Use ssh to log in as the root user to the ODA_BASE domain on Node 0, switch to the directory where you stored the configuration utility file, and extract the configuration utility file to any directory on the ODA_BASE domain of Node 0.
See "Using the Configuration Utility" for information on how to run the configuration utility.
Note:
If you want to run the configuration utility to create a configuration file on the local client, extract wls_configurator_version.tar.gz to any directory on the local client.
You can use either of the following methods to create a WebLogic domain configuration using configuration utility:
Download the configuration utility to a Windows, MacOS, or Linux client, and run the configuration utility on the client to create a configuration file. You can then copy the Configuration file to the Oracle Database Appliance at a later time, and run the configuration utility again to load the file and provision WebLogic Server Domains after you have downloaded the WebLogic Server and Oracle Traffic Directory software to the appliance.
After you have downloaded the WebLogic Server OVM templates to the Oracle Database Appliance, run the configuration utility directly on the Oracle Database Appliance to create a new configuration file (or load an existing configuration file) and provision WebLogic domains on Oracle Database Appliance.
Prior to running the configuration utility, collect the following network configuration information:
Hostnames and IP addresses to use for the WebLogic Server Administration Server VMs.
Hostname and IP address to use for each WebLogic Server Managed Server VM. Depending on the number of domains and the cluster size you choose, you will need two to sixteen of each.
Virtual IP addresses to use for the Oracle Traffic Directory load balancer, if you choose to provision a load balancer. With expanded multi domain/cluster configuration with WebLogic Server, the number of Virtual IP addresses for load balancer increases where each WebLogic Server domain requires a unique VIP address and each cluster in that domain requires a unique port.
Hostname and IP address to use for the Oracle Traffic Directory Administration Server VM.
Two hostnames and IP addresses to use for the two Oracle Traffic Directory Admin Node VMs.
If you need to create an additional data source for use by your application, you need the following information. The data source must be for an Oracle database that is running on this Oracle Database Appliance.
The JNDI name (data source name) for the data source
The Oracle database service name
The schema username and password to be used to connect the database
Before provisioning the WebLogic domains, you must ensure that you have enough CPU and memory resources available for the size of the cluster that you want to create.
Table 2-1 shows the total resource availability.
Table 2-1 Total Resource Availability
| Resources | V1 | X3-2 | X4-2 |
|---|---|---|---|
|
Total Cores |
24 |
32 |
48 |
|
Total vCPUs |
48 |
64 |
96 |
|
Total RAM (in GB) |
192 |
512 |
512 |
The sizing of the total number of cores includes the following components:
Note that the database that you create on Oracle Database Appliance uses some of the available machine resources. If the database is large, the machine resources that are available for your Managed Server cluster will be significantly smaller, thus impacting performance.
Plan your ODA_BASE size on the basis of your requirement. Table 2-2 shows the ODA_BASE sizes and their corresponding vCPUs and memory.
Table 2-2 Core Count and RAM Size for selecting ODA_BASE
| Core Count (per node) | vCPUs | RAM Size (in Gigabytes) |
|---|---|---|
|
2 |
4 |
32 |
|
4 |
8 |
64 |
|
6 |
12 |
96 |
|
8 |
16 |
128 |
|
10 |
20 |
160 |
|
12 |
24 |
192 |
|
14 |
28 |
224 |
|
16 |
32 |
244 |
|
24 |
48 |
244 |
You can have a maximum of 44 deployment cores for use by Oracle WebLogic Server and Oracle Traffic Director if you select the smallest ODA_BASE size of 2 cores per node.
Each Oracle WebLogic Server domain adds 1 Admin Server and requires at least 2 Managed Servers. Two vCPUs are used for each Admin Server and four vCPUs are used for each Managed Server. The maximum number of Managed Servers allowed for one domain is 13 in X3-2 and 16 in X4-2 if you configure only one domain. If you need more than one domain, the number of Managed Servers comes down accordingly.
Table 2-3 Minimum Resources for Oracle WebLogic Server Installation
| Usage | vCPUs | Number of Cores |
|---|---|---|
|
WLS Admin Server |
2 (only one Admin Server) |
1 |
|
WLS Managed Servers |
|
|
|
Total |
|
|
If you want to provision a load balancer, Oracle Traffic Director needs 10 VCPUs:
One Admin Server - 2 vCPUs or one core
Two Admin Nodes - 4 vCPUs each which equals to 8 vCPUs or 4 cores
While running the configuration utility, you must select the number of Planned Deployment Cores.
Decide the number of cores for ODA_BASE before determining the Planned Deployment Cores. Use the following formulae to determine your Planned Deployment Cores.
Table 2-4 Planning your Deployment Cores
| Cores | V1 | X3-2 | X4-2 |
|---|---|---|---|
|
Available Cores |
Total number of cores (24) - ODA_BASE Cores |
Total number of cores (32) - ODA_BASE Cores |
Total number of cores (48) - ODA_BASE Cores |
|
Planned Deployment Cores |
Cores for WLS provisioning + 5 Cores for OTD (if selected) |
Cores for WLS provisioning + 5 Cores for OTD (if selected) |
Cores for WLS provisioning + 5 Cores for OTD (if selected) |
|
Cores per domain for Oracle WebLogic Server |
2 Cores for Admin Server + 2 Cores for each Managed Server |
2 Cores for Admin Server + 4 Cores for each Managed Server |
2 Cores for Admin Server + 4 Cores for each Managed Server |
Note:
The following examples take into consideration Oracle Database Appliance X4-2 only.
To plan the smallest possible deployment in an ODA X4-2 machine:
Determine your ODA_BASE size. If you want to select the smallest size, you can select 2 cores per node or a total of 4 cores.
Available cores = Total Number of Cores - ODA_BASE Cores = 48-4 = 44
Use this information to make sure your Planned Deployment Cores fall within this range of remaining cores.
Determine the cores for WLS provisioning:
If you select one domain with two Managed Servers:
One Admin Server uses 2 vCPUs or 1 core and two Managed Servers use 8 vCPUs or 4 cores with a total of 5 cores.
Determine if you want a load balancer
If you choose to provision a load balancer, add 5 cores for Oracle Traffic Director with one Admin Server (2 vCPUs or one core) and two Admin Nodes (four vCPUs or two cores each).
Calculate the planned deployment cores:
Planned Deployment Cores = 5 cores for WLS provisioning + 5 cores for Oracle Traffic Director = 10 cores
If you choose not to provision a load balancer, the smallest Planned Deployment Cores is 5.
To plan the appropriate possible deployment in an X4-2 machine:
Determine your ODA_BASE size. If you want to select 4 cores per node or a total of 8 cores.
Available cores = Total Number of Cores - ODA_BASE Cores = 48-8 = 40
Use this information to make sure your Planned Deployment Cores fall within this range of remaining cores.
Determine the cores for WLS provisioning:
If you select two domains with the four Managed Servers in each:
Admin Servers uses 2*2=4 vCPUs or 2 cores
Managed Servers use 8*4 =32 vCPUs or 16 cores
Total WLS cores = 16+2 = 18 cores
Determine if you want a load balancer
If you choose to provision a load balancer, add 5 cores for Oracle Traffic Director with one Admin Server (2 vCPUs or one core) and two Admin Nodes (four vCPUs or two cores each).
Calculate the planned deployment cores:
Planned Deployment Cores = 18 cores for WLS provisioning + 5 cores for Oracle Traffic Director = 23 cores
If you choose not to provision a load balancer, the Planned Deployment Cores is 18.
To create a configuration file on a Windows or Linux client for later use on Oracle Database Appliance:
Change to the directory where you downloaded and extracted the configuration utility files.
Enter the following command to start the configuration utility:
config.bat (Windows)
./config.sh (Linux or Mac OSX)
If you want to load an existing configuration file, include the path to the file name in the command, for example:
./config.sh /config/myconfig.properties
Configure the WebLogic Server domain as described in "Configuration Utility Screens." On the Summary screen, click Save to save the configuration to a file.
Prior to running configuration utility on Oracle Database Appliance:
ensure that the Java bin directory is set in the classpath. JDK 1.6 is the minimum required JDK.
either launch XWindows or redirect the display on ODA_BASE of Node 0.
If you have already created a configuration file on a client as described in the previous section and you want to use that file to provision the WebLogic Server domains, ensure that you have already copied the file to the Oracle Database Appliance.
To run the configuration utility on the Oracle Database Appliance:
Use SSH to log in as root to ODA_BASE of Node 0 of the Oracle Database Appliance:
ssh root@ip_address
Replace ip_address with the IP address of ODA_BASE of Node 0.
Change to the directory where you extracted the configuration utility files.
Enter the following command:
./config.sh config_file
Replace config_file with the path and filename of the saved configuration file. Alternatively, you can omit this parameter and browse to the file from the Welcome screen.
To continue with the Configuration utility, refer to the section, "Configuration Utility Screens".
To install and provision in silent mode, see "Silent Provisioning".
After starting the configuration utility, enter the details in the following screens.
If you run the configuration utility offline, an alert appears asking to select the hardware. Depending on your configuration, select ODA V1, ODA X3-2, or ODA X4-2.
This alert prompt does not appear if you run the configuration utility on Oracle Database Appliance.
From this screen, you can create a new configuration or load an existing configuration from a previously saved file.
To create a new configuration, click Next. You can save the configuration later on the Summary screen.
Load an Existing Configuration
Click Browse to select and load an existing configuration file, which will be used to populate all fields on the subsequent screens.
If you created a configuration file on a remote machine and then transferred the file to Oracle Database Appliance, navigate to the directory where you stored the file and select it.
After loading the configuration file, click Next to continue.
Provide the following information. Click Next to continue.
Note:
If you run the configuration utility on a client machine to create a configuration file, you must select the machine type before the configurator begins. The options on the configurator screens depend on the Oracle Database Appliance machine selected.
Select the number of Planned Deployment Cores from the drop down list. The planned deployment core count now accounts for the cores available on both the ODA nodes.
Displays the number of deployment cores used currently.
Oracle Database Appliance X4-2 and X3-2: This field shows 5 by default as it is the smallest possible planned deployment cores.
Oracle Database Appliance V1: This field shows 3 by default as it is the smallest possible planned deployment cores.
This field will be updated as you select OTD and choose the number of Oracle WebLogic Server domains, clusters, and managed servers.
Provide the following network information. Enter the IP addresses for the respective entries.
Oracle Database Appliance X4-2 and X3-2: Eth1 and Eth2 networks will be available for use. Select one or both of the networks for use.
Note:
If you select Eth1 or Eth2 or both, the provided network information must match with the information on oda_base configured on Eth1 or Eth2 or both.
Oracle Database Appliance V1: Eth1 and Eth4 networks will be available for use. Select one or both of networks for use.
Provide the netmask for the subnet to which the IP addresses belong.
Provide the IP addresses for the gateways to your network.
Select whether you want to provision a fronting load balancer for the Oracle Weblogic Server cluster instances. The Oracle VM Template archive for OTD must be present in the /OVS/Staging directory of Domain-0 on Node 0 for the provisioning process to complete successfully.
Provide the following information. Click Next to continue.
Select the Oracle WebLogic Server version to provision on the Oracle Database Appliance.
The Oracle VM Template archive corresponding to the selected version must be present in the /OVS/staging directory of Domain-0 on Node 0 for the provisioning process to complete successfully.
From the drop down list, select the number of domains.
Enter the name for the Oracle WebLogic Server Domain. Domain names can consist of only alphanumeric characters, underscores (_), and hyphens (-). The domain name must contain at least one alphabetic character and cannot start with a number, and can be a maximum of 23 characters long.
Depending on the number of domains selected earlier, you must repeat the process and enter the domains and their corresponding clusters.
Note:
While naming the domains, make sure that a domain name is not a substring of another domain name as it might result in parsing errors. For example, Domain1 and Domain2 are accepted domain names while Domain and Domain1 will result in errors.
From the drop down list, select the number of managed servers you want to create in the domain.
From the drop down list, select the number of clusters for the domain from the drop down list.
Select the number of Managed Servers that you want to create in the clusters. For example, a cluster sizing of 3/2 means that the first cluster has three Managed Servers and the second cluster has two Managed Servers.
Note that once the domain is created, you will not be able to add additional Managed Server instances.
Select the network interface that you want to use for the Oracle WebLogic Server virtual machines.
Oracle Database Appliance X4-2 and X3-2: eth1(bond0) is a fiber-optic 10GbE interface for public network access. eth2(xbond0) is a fiber-optic 10GbE interface.
Oracle Database Appliance V1: eth1(bond0) is a 1GbE interface for public network access. eth4(xbond0) is a fiber-optic 10GbE interface.
Note that the same network interface cannot be mapped to multiple sub networks, so care must be taken while providing the network information for Oracle WebLogic Server, Oracle Traffic Director, and Oracle Database tiers on the machine.
Ensure that your network switch and cables can support the GbE speed that you select. All network addresses are bonded to ensure redundancy and throughput.
For more information, see "Oracle VM Network Infrastructure" in Oracle Database Appliance Getting Started Guide.
The netmask details that you entered in the General Information screen will appear here.
The gateway details you entered in the General Information screen will appear here.
Provide the port details for network connectivity. 7001 is selected by default.
Specify the hostname[1] for the Oracle WebLogic Server Administration Server.
Specify the IP address[2] for the Oracle WebLogic Server Administration Server.
Displays the default user name - root.
Enter the password to use for the Oracle WebLogic Server administration user (system) and the operating system user (root) for the virtual machines that are running Oracle WebLogic Server.
The currently selected domain and the managed server utilization will be displayed after you enter all the domain details.
[1]: All hostnames must conform to the RFC 952 standard. The network domain that is configured for database provisioning is used to form the fully qualified domain names (FQDN) for the hostnames.
[2]: Only IPV4 format addresses are supported.
This is a read-only field displaying cluster names that are created as Cluster-1, Cluster-2, and so on.
The number of Managed Servers depends on the value you selected for the cluster size in the Domains table.
For each of the Managed Server virtual machines, specify the host name of the Managed Server.
For each of the Managed Server virtual machines, specify the IP address.
This is a read-only field displaying cluster names. Specify the details of all the Managed Servers corresponding to each cluster.
JMS Distributed Destinations with DB Persistent Store
Select this option to configure JMS Distributed Destinations. If selected, sample JMS Distributed Queue and Topic backed by a highly available DB persistent store are created and targeted to the Oracle WebLogic Server cluster.
See Best Practices for JMS Beginners and Advanced Users for additional information on JMS Distributed Destinations.
If selected, a screen for collection of JMS Distributed Destination information is displayed. This store is used for WebLogic JTA TLOG as well.
Select this option to create a Data Source that can be used by applications deployed to the WebLogic Server clusters. The Data Source must be for an Oracle Database that is running on the same Oracle Database Appliance machine. If selected, a screen for collecting Data Source configuration is displayed.
Provide the following information for the database to be used for creating WebLogic persistent store. Note that the information is only for connecting to an Oracle Database instance running on the same ODA machine. Click Next to continue.
Enter the Database service name.
Specify the user name to log in to the database.
Specify the password to log in to the database.
Use this screen to configure a JDBC Data Source to be used by applications deployed to the Oracle WebLogic Server clusters. Note that the Data Source is only for connecting to an Oracle Database instance running on the same ODA machine.
Select whether the data source is a WebLogic multi data source, GridLink data source, or Generic data source.
For RAC database, you can select either GridLink or Multi Data Source.
For RACOne node, you can use only GridLink Data Source.
For Enterprise Edition database, you can use only a Generic Data Source.
Enter the JNDI name that you want to use for the data source. This name will also be used as the data source name.
Enter the Oracle Database service name.
Database User Name and Password
Enter a valid user name for accessing the database schema. Enter the password for the specified user name.
Select this option to enable global transactions on the data source. For more information about global transactions, see:
"Using Multi Data Sources with Global Transactions" in Configuring and Managing JDBC Data Sources for Oracle WebLogic Server (WebLogic Server 10.3.6)
"Using Multi Data Sources with Global Transactions" in Configuring and Managing JDBC Data Sources for Oracle WebLogic Server (WebLogic Server 12.1.1)
"Using Multi Data Sources with Global Transactions" in Using Multi Data Sources with Oracle RAC (WebLogic Server 12.1.2)
Provide the following information.
Provide the following network details.
Select the network interface that you want to use for the Oracle Traffic Director (OTD) virtual machines.
Oracle Database Appliance X4-2 and X3-2: eth1(bond0) is a fiber-optic 10GbE interface for public network access. eth2(xbond0) is a fiber-optic 10GbE interface.
Oracle Database Appliance V1: eth1(bond0) is a 1GbE interface for public network access. eth4(xbond0) is a fiber-optic 10GbE interface.
Ensure that your network switch and cables can support the GbE speed that you select. All network addresses are bonded to ensure redundancy and throughput.
For more information, see "Oracle VM Network Infrastructure" in Oracle Database Appliance Getting Started Guide.
Specify the Hostname[1] and IP Address[2] for the OTD Administration Server virtual machine.
For each of the Admin Node virtual machines, specify the Hostname[1] and IP Address[2].
Displays the netmask details entered in the General Information screen.
Displays the gateway details entered in the General Information screen.
Provide the following credentials.
Enter the password to use for OTD administrator user (admin) and the operating system users (root, oracle) for the virtual machines that are running OTD.
Press Enter or tab to view the password confirmation screen.
Provide the following information.
Lists the domains created in earlier screens.
Enter the public IP address[2] for the OTD instances linked to the selected domain. For each domain, enter a unique virtual IP address.
OTD instances will be configured in an Active-Passive configuration to ensure highly available traffic routing and load-balancing service for your enterprise applications and services. OTD has the ability to fail over on this virtual IP, thus providing high availability of the back-end applications that are deployed on Oracle WebLogic clusters.
For more information, see http://docs.oracle.com/cd/E23389_01/doc.11116/e21036/ha001.htm#CHDJGDJG in Oracle® Traffic Director Administrator's Guide.
OTD Port for First WebLogic Cluster
This is the listen port for the OTD instances linked to the first cluster of the domain. Clients can connect using the virtual IP address on this port.
Specify a single port for each domain which acts as the starting port. All subsequent clusters will be assigned port+1 value.
Every cluster within a domain must be assigned a unique port. You cannot duplicate ports within the same domain. However, you can use the same port across multiple domains as each domain has a unique virtual IP address to differentiate the clusters.
[1]: All hostnames must conform to the RFC 952 standard. The network domain that is configured for database provisioning is used to form the fully qualified domain names (FQDN) for the hostnames.
[2]: Only IPV4 format addresses are supported.
Review the configuration summary to ensure that it is accurate.
If you are running the utility on a local machine to generate a configuration file, or if you are running on the Oracle Database Appliance and you intend to use this configuration file to provision later, click Save and save the configuration file before exiting the utility. If you need to change the configuration, click Back to return to earlier screens.
Click Cancel to close without provisioning Oracle WebLogic Server or saving a configuration file.
If you are running Oracle Database Appliance Configuration Utility for WebLogic Server on an Oracle Database Appliance, and you want to proceed immediately with the provisioning, click Install.
The provisioning process clones, configures, and starts the needed virtual machines and the corresponding servers within them.
When provisioning process is complete, the Oracle WebLogic Administration Server and Managed Servers (along with Node Managers) are up and running. If a load balancer is configured, Oracle Traffic Director Administration Server and instances are also ready for use.
To run the configuration in silent mode without using the Configuration utility, you can perform silent provisioning.
To perform silent provisioning:
Use SSH to log in as root to ODA_BASE of Node 0 of the Oracle Database Appliance:
ssh root@ip_address
Replace ip_address with the IP address of ODA_BASE of Node 0.
Change to the directory where you extracted the configuration utility files.
Enter the following command:
./config.sh --silent config_file
Replace config_file with the path and filename of the properties file.
After completing the configuration, clicking Install initiates the domain creation process.
The domain creation process clones, configures, and starts the needed virtual machines and the corresponding servers within them.
When the creation process is complete, the Oracle WebLogic Administration Server and Managed Servers (along with Node Managers) are up and running. If a load balancer is configured, Oracle Traffic Director Administration Server and instances are also ready for use.
To avoid a single point of failure with a physical node, the virtual machines are spread across the both physical nodes (Node 0 and Node 1).
Notes:
At initial provisioning, the domain is configured for Production mode. When you change the domain to Development mode, you must restart the WebLogic servers.
Once provisioning is complete, you must allocate CPUs to each node based on the number of CPUs you have licensed. Refer to the next section, "CPU Allocation," for more information.
For Oracle WebLogic Server configured on Oracle Database Appliance, cores are already created during the provisioning process.
After creating the domain, all VMs are using the CPUs from the default-unpinned-pool. Based on the number of cores you have licensed, you must configure the virtual machines to ensure that only the licensed number cores are used by the provisioned WebLogic Server and OTD VMs. The simplest approach is to allocate half of the available cores to each node and configure the WebLogic Server and OTD VMs on a given node to use the cores from that node's CPU pool. See the example later in this section.
Note:
There are many ways to allocate the available CPU resources. For example, you could create a separate CPU pool for each VM. You could also allocate the CPU resources unevenly, for example, if you have 10 licensed cores, allocate one to be shared by both Administration Servers, one for each OTD VMs, and seven for the WebLogic Managed Server VMs. The example in this section describes the simplest approach.
For example, if you have licensed 8 cores, perform the following steps to allocate six cores to each node and configure the VMs on each node to use these CPU pools:
Use the following command to create CPU pools on each node (in this example, wlsCpuPool is the pool name; you can substitute any pool name you want to use):
oakcli create cpupool wlsCpuPool -numcpu 8 -node 0
oakcli create cpupool wlsCpuPool -numcpu 8 -node 1
For each WebLogic Server and OTD VM, enter the following command to configure the VM to use the CPU pool.
oakcli configure vm vm_name -cpupool wlsCpuPool
After executing this command, you need to restart each VM for the change to take effect.
For each VM, enter the following commands to restart the VMs:
oakcli stop vm vm_name
oakcli start vm vm_name
For more information about CPU licensing, see "Core Count and Pay-As-You-Grow" in Oracle Database Appliance Getting Started Guide.
For more information about OAKCLI commands, see "Oracle Database Appliance Command Line Interface (OAKCLI) Utility Reference" in Oracle Database Appliance Getting Started Guide.
This section describes the virtual machine (VM) configuration of the WebLogic domain. It contains the following sections:
The WebLogic Administration Server and Managed Server VM names, as well as the Oracle Traffic Director (OTD) VM names, are based on the physical host number on which the VM resides, the domain name, the cluster name, and in the case of Managed Servers, the Managed Server number. WebLogic Server VM names are prefixed by WLS_, while the OTD VM names are prefixed by OTD_.
The VM name of the WebLogic Administration Server is as follows:
WL_<DomainName>_AS
For example:
WL_Domain1_AS WL_Domain2_AS
The VM name of each Managed Server is as follows, where # is the number of the VM with regard to the cluster:
WLS_<DomainName>_C<cluster#>_MS_<MS#>
For example:
WL_Domain1_C2_MS_3 WL_Domain2_C1_MS_4
The number of Managed Servers is reset per domain. For example, if you have 2 domains of 4 Managed Servers each, you have 8 total Managed Servers. The VMs will be ordered 1-4 for domain1, then 1-4 again for domain2. The VMs can be differentiated by the domain name part of the VM name.
The VM name of the OTD Administration Server is as follows:
OTD_firstdomainname_AdminServer
The VM name of each OTD server is as follows, where # is the number of the VM:
OTD_firstdomainname_AdminNode_#
Table 2-5 shows the VM names for the Administration Server and Managed Servers in a domain called mydomain with four WebLogic Managed Servers.
Table 2-5 Example Virtual Machine Names
| VM | Physical Host | VM Name |
|---|---|---|
|
WebLogic Administration Server |
1 |
WL_Domain1_AS |
|
WebLogic Managed Server n |
1 |
WL_Domain1_C1_MS_n |
|
OTD Administration Server |
2 |
OTD_mydomain_AdminServer |
|
OTD AdminNode 1 |
1 |
OTD_mydomain_AdminNode_1 |
|
OTD AdminNode 2 |
2 |
OTD_mydomain_AdminNode_2 |
The examples of VM names in a cluster are as follows:
OTD_a_Domain1-1212_AdminNode_1
OTD_a_Domain1-1212_AdminNode_2
OTD_a_Domain1-1212_AdminServer
WL_a_Domain-1212_AS
WL_a_Domain-1212_C1_MS_1
WL_a_Domain-1212_C1_MS_2
WL_a_Domain-1212_C2_MS_3
WL_a_Domain-1212_C2_MS_4
WL_b_Domain-1212_AS
WL_b_Domain-1212_C1_MS_1
WL_b_Domain-1212_C1_MS_2
WL_c_Domain-1212_AS
WL_c_Domain-1212_C1_MS_1
WL_c_Domain-1212_C1_MS_2
Each VM hosts its own Oracle Enterprise Linux operating system in addition to any installed applications, such as WebLogic Server.
Table 2-6 shows the resources that are provided for each VM.
Table 2-6 VM Resource Allocation per VM in ODA X3-2 and X4-2
| VM | vCPU | MEM | JVM Heap |
|---|---|---|---|
|
OTD Administration Server |
2 |
1 GB |
n/a |
|
OTD Administration Instances |
4 |
6 GB |
n/a |
|
WebLogic Administration Server |
2 |
2 GB |
512 MB |
|
WebLogic Managed Server |
4 |
4 GB |
3 GB |
Note:
In ODA V1, the number of vCPUs allocated is 2 for each VM.
Each VM has an operating system disk (4GB total space). In addition to this, there are two additional virtual disks mounted at /u01 and /opt/oracle. The /u01 mounted disk contains the WebLogic Server domain configuration and OTD instance home, with 7.5GB total space. The /opt/oracle mounted disk contains the WebLogic Server and OTD installations
Table 2-7 shows key directory locations.
Table 2-7 Key Directory Locations
| Directory or File | Location |
|---|---|
|
WebLogic Server home |
Oracle WebLogic Server 12.1.2 - /opt/oracle/middleware/wlserver Oracle WebLogic Server 10.3.6 and 12.1.1 - /opt/oracle/middleware/wlserver_version |
|
WebLogic Server domain location |
/u01/domain_name |
|
WebLogic Server domain log file |
/u01/domain_name/servers/admin_server_name/logs/domain_name.log |
|
WebLogic Server server log |
/u01/domain_name/servers/server_name/logs/server_name.log |
|
Middleware home |
/opt/oracle/middleware |
|
Oracle Traffic Director home |
/opt/oracle/trafficdirector |
|
Oracle Traffic Director server instances |
/u01/OTDInstanceHome |
Once provisioning is complete, the individual VMs can be accessed via ssh.
The operating system password of each WebLogic Server VM for root is set to the WebLogic Server password that was specified in the Password field of the WebLogic VM Information screen of the configuration utility.
The operating system password of each OTD VM for root is set to the OTD administrator password that was specified in the Password field of the Load Balancer Configuration screen of the configuration utility.
You have the option to change these passwords afterwards.