LMS Collection Tool Measurement Instructions 1621

LMS Collection Tool Measurement Instructions ORACLE LMS WHITE PAPER

|

MARCH 2016

This document is intended to describe the technical steps to be performed by the Customer in order to properly collect data for Oracle Product license metrics usage tracking. This document and all information contained herein are STRICTLY CONFIDENTIAL and are for use by Oracle and Customers for the purposes of the Oracle products license usage measurement. They are not to be divulged in whole or in part whether electronically or as hard copy to any third party without the express permission of Oracle or authorized signatory.

Contents

Introduction .................................................................................................................................................................................. 3 1. Measurement Overview ..................................................................................................................................................... 3 1.1. Conventions .............................................................................................................................................................. 4 1.2. Files Overview .......................................................................................................................................................... 5 1.3. Base Script ............................................................................................................................................................... 5 1.4. Data Collection Scripts ............................................................................................................................................. 5 1.5. CPU Scripts .............................................................................................................................................................. 6 2. Data Collection ................................................................................................................................................................... 6 2.1. Technical Requirements ........................................................................................................................................... 6 2.2. Credentials Requirements ........................................................................................................................................ 8 2.3. Running the Scripts .................................................................................................................................................. 8 On Linux / UNIX Systems ........................................................................................................................................................ 9 Examples - Running the Tool on Linux / UNIX ...................................................................................................................... 11 On Windows Systems ............................................................................................................................................................ 12 Examples - Running the Tool on Windows ........................................................................................................................... 13 Partitioned Servers - LMSCPU Script .................................................................................................................................... 15 Multiplexing architecture ........................................................................................................................................................ 15 3. Troubleshooting Initial Phase .......................................................................................................................................... 15 Troubleshooting Executing Phase ............................................................................................................................................ 16 4. Collected Data Description .............................................................................................................................................. 16

2 | LMS Collection Tool Measurement Instructions

Introduction The LMS Collection Tool Measurement Instructions document is intended for system and middleware administrators as well as anyone else who wants to perform LMS measurement process. A basic knowledge of computers, and a minimal basic knowledge or experience with Windows or UNIX environments is required. This document is owned by Oracle License Management Services  – Global Business Services. Revisions may only be made with the written approval of appropriate Program Manager.

1. Measurement Overview This document describes the technical steps required to collect license measurement data for the following Oracle products:



Oracle Application Server (OAS) or Internet Application Server (iAS)



Oracle WebLogic Server or BEA WebLogic Server (WLS)



Oracle Service-Oriented Architecture (SOA) Suite



Oracle Tuxedo or BEA Tuxedo

This document and all information contained herein are STRICTLY CONFIDENTIAL and are for use by Oracle and Customers for the purposes of Oracle license usage measurement. They are not to be divulged in whole or in part whether electronically or as hard copy to any third party without the express permission of Oracle or an authorized signatory.

The Oracle LMS Collection Tool (referred to herein as the “LMS Collection Tool” or “tool”) is a collection of scripts that are executed from within the operating system of the server(s) where the Oracle Software is installed. In what follows, “Oracle Software” designates all the products listed above. This tool detects and collects measurement data for the Oracle Software

running on Windows servers and most versions of UNIX and Linux. Note: Running scripts outside of the LMS Collection Tool is not recommended or supported by Oracle LMS. In

addition, by accessing the scripts outside of the tool, you thereby agree to the Oracle LMS License Agreement. The document is structured as follows: 

Files Overview – Provides information on the files included in the LMS Collection Tool.



Technical Requirements – Provides an overview on the pre-requisite information (credentials, domain names, machine name, environment variable, etc…) required to run the tool



Credentials Requirements – Provides a summary of credentials needed to run the scripts



Running the Scripts - Provides information on running the tool on UNIX/Linux and Windows environments.



o

For UNIX/Linux deployments – Provides information on running the tool on UNIX/Linux environments

o

For Windows deployments – Provides information on running the tool on Windows environments

Troubleshooting initial phase – Provides troubleshooting information on how to start the script

3 | LMS Collection Tool Measurement Instructions



Troubleshooting executing phase – Provides troubleshooting information on how to run the script successfully



Collected Data  – Provides a description of the data collected by the tool

1.1.

Conventions

The following text conventions are used in this document:

Table 1. Text conventions convention

Meaning

boldface

Boldface type indicates graphical user interface elements associated with an action, or terms defined in text or the glossary

italic

Italic type indicates book titles, emphasis, or placeholder variables for which you supply particular values.

monospace

Monospace type indicates commands within a paragraph, URLs, code in examples, text that appears on the screen, or text that you enter.

LMS

 Abbreviation for License Management Services

CPU

Central Processing Unit

LMSCPU

Acronym for LMS CPU query/script.

FMW

Acronym for Fusion Middleware.

WLS

Acronym for WebLogic Server. This will refer to Oracle WebLogic Server or BEA WebLogic Server throughout this document.

SOA

Acronym for Service-Oriented Architecture. This will refer to Oracle ServiceOriented Architecture Suite throughout this document.

OAS

Acronym for Oracle Application Server.

iAS

Acronym for Internet Application Server.

4 | LMS Collection Tool Measurement Instructions

1.2.

Files Overview

The Oracle_LMS_Collection_Tool.zip archive contains the scripts listed in the sections below. Refer to the Running the Scripts section for more information on the instructions for running the scripts.

1.3.

Base Script

The Base Script is the main/driver script that needs to be run. When you run the Base Script you will get the Oracle LMS License Agreement displayed and collect Oracle software configuration files. TABLE 2. BASE SCRIPT OPERATING SYSTEM

LOCATION

Windows

Oracle_LMS_Collection_Tool\LMSCollection\bin\LMSCollection.cmd

Linux / UNIX

Oracle_LMS_Collection_Tool/LMSCollection/bin/LMSCollection.sh

1.4.

Data Collection Scripts

These scripts are automatically called by the Base Script and collect individual product information. Running the tool to start a particular product measurement may automatically trigger supporting plug-in scripts to run as well. Dependencies amongst each product measurement are preset in the tool’s configuration files.

TABLE 3. COLLECTION SCRIPTS OPERATING SYSTEM

DESCRIPTION / CONFIGURATION FILES LOCATION

OAS AND IAS: THESE PLUGIN SCRIPTS COLLECT OAS INSTALLATION INFORMATION AT THE OPERATING SYSTEM LEVEL OF THE SERVER WHERE IAS OR OAS IS DEPLOYED Windows

Linux / UNIX

Oracle_LMS_Collection_Tool\LMSCollection\resources\util\OAS\run_opmnctl_status. cmd Oracle_LMS_Collection_Tool/LMSCollection/resources/OAS/run_opmnctl_status.sh WLS NUP: THESE SCRIPTS COLLECT NUP CONFIGURATION INFORMATION FROM THE RUNNING INSTANCES OF WEBLOGIC SERVER FOR BOTH WEBLOGIC AND ORACLE SOA SUITE PRODUCTS.

Windows

Oracle_LMS_Collection_Tool\LMSCollection\resources\util\WLST\WLSNUP\getWLS  _NUP.cmd

Linux / UNIX

Oracle_LMS_Collection_Tool/LMSCollection/resources/util/WLST/WLSNUP/getWLS  _NUP.sh

5 | LMS Collection Tool Measurement Instructions

WLS BASIC: THESE SCRIPTS COLLECT WLS BASIC CONFIGURATION INFORMATION FROM THE RUNNING INSTANCES OF WEBLOGIC SERVER FOR BOTH WEBLOGIC AND ORACLE SOA SUITE PRODUCTS. Windows

Linux / UNIX

Oracle_LMS_Collection_Tool\LMSCollection\resources\util\WLST\WLSBasic\wlsbasic-measurement.cmd Oracle_LMS_Collection_Tool/LMSCollection/resources/util/WLST/WLSBasic/wlsbasic-measurement.sh TUXEDO: THESE SCRIPTS COLLECT TUXEDO CONFIGURATION INFORMATION FROM THE RUNNING INSTANCES THE TUXEDO PRODUCT.

Windows Linux / UNIX

1.5.

Oracle_LMS_Collection_Tool\LMSCollection\resources\util\tuxedo\countclients.cmd Oracle_LMS_Collection_Tool/LMSCollection/resources/util/tuxedo/countclients.sh

CPU Scripts

These scripts collect information about the machine’s processor where the Oracle software is installed. Depending on the

operating system deployed, the operating system-specific commands will return the hardware information. TABLE 4. CPU SCRIPTS OVERVIEW OPERATING SYSTEM Windows Linux / UNIX

FILES LOCATION

Oracle_LMS_Collection_Tool\LMSCollection\resources\util\LMSCPU\lms_cpuq.cmd Oracle_LMS_Collection_Tool/LMSCollection/resources/util/LMSCPU/lms_cpuq.sh

2. Data Collection This chapter describes the technical steps required to be executed by the operating system and middleware admin in order to collect LMS Collection Tool measurement data. If you require any assistance with the information presented in this chapter, please contact your LMS representative.

2.1.

Technical Requirements

Identification of the following operating system credentials by the respective administrator is required in order to run the Oracle LMS Collection Tool. Products measured by the Oracle LMS Collection tool include: All BEA WebLogic Server Editions and versions. WebLogic versions 5.1-10.0 o WebLogic Express, WebLogic Advantage, WebLogic Premium, WebLogic Platform. o All Oracle WebLogic Server Editions and versions. WebLogic versions 10.3-12.x. o o WebLogic Standard Edition, WebLogic Enterprise Edition, WebLogic Suite 11g and 12c. 



6 | LMS Collection Tool Measurement Instructions



BEA Tuxedo Tuxedo versions 6.4-10 o Tuxedo Add-On products o   Jolt   TSAM   WTC   SALT Tuxedo Adapters Message Q Oracle Tuxedo o Tuxedo 11g and 12c o Tuxedo Add-On products   Jolt   TSAM   WTC   SALT Tuxedo Adapters Message Q Oracle SOA Suite Versions 10g, 11g, and 12c o Components of SOA Suite o Oracle Service Bus Oracle BPEL Oracle Application Server o Version 10g o All editions      



     



 



TABLE 5. TECHNICAL REQUIREMENTS FOR THE DATA COLLECTION SCRIPTS PRODUCT

REQUIREMENTS

OAS and iAS

The OAS and iAS data collection process does not have specific technical requirements.

WLS and SOA

The following application server’s connection details must be identified by the WebLogic Server

administrator if the instance is running WebLogic Basic or licensed under the Named User Plus (NUP) metric. In order to measure NUP, the WebLogic Server being measured must be version 10.3 or greater. For processor based WebLogic or SOA measurement, WebLogic Home and domain configuration information is not needed. WL_HOME   – This environment variable must be set in the shell that is running the LMSCollection script.

WL_HOME is the directory where WebLogic is installed. You can set this location in the LMSCollection\resources\util\WLST\wlstInput.txt file. Target_Machine_Name_or_IP   – Name of machine to connect to via WLST, set in

LMSCollection\resources\util\WLST\wlstInput.txt file. W e b L o g i c _ D o m a i n N a m e –   Name of the WebLogic domain to connect to, set in

LMSCollection\resources\util\WLST\wlstInput.txt file. WebLogic_DomainHostURL_or_IP:Port  – URL of the Domain administrator’s host and port, set in

LMSCollection\resources\util\WLST\wlstInput.txt file. W e b L o g i c _ D o m a i n A d m i n I D –   Administrative ID for the WebLogic Domain, set in

LMSCollection\resources\util\WLST\wlstInput.txt file. W e b L o g i c _ D o m a i n A d m i n I D P a s s w o r d –    Password of the Admin User of the WebLogic Domain, set in

LMSCollection\resources\util\WLST\wlstInput.txt file. In the wlstInput.txt file you would write the above information on a comma separated line. For example

7 | LMS Collection Tool Measurement Instructions

Target_Machine_Name_or_IP,WebLogic_DomainName,WebLogic_DomainHostURL_or_IP:7001,WebLo gic_DomainAdminID,WebLogic_DomainAdminIDPassword

127.0.0.1, base_domain,127.0.0.1:7001,weblogic,weblogic1

NOTE: After execution off the LMS Collection Tool it is recommended to remove the information above as a standard security measure. By default the LMS Collection tool will delete the wlstInput.txt file upon completion and replace it with a template file. Tuxedo

The following Tuxedo environment variables must be identified and set. TUXDIR   – This environment variable must be set in the shell that is running the LMSCollection script.

TUXDIR is the directory where Tuxedo is installed. TUXCONFIG   – Environment variable pointing to the Tuxedo configuration file.

2.2.

Credentials Requirements

The following operating system credentials must be identified by the operating system administrator in order to run the Discovery and CPU scripts: Table 6. Technical operating system requirements Operating System

credentials

Windows NT /

Windows Administrator username and password. WebLogic, Tuxedo, or OAS

Windows

administrator username and password. NOTE: Administrator username is recommended but another account can be used given that it is part of the Administrators group.

Linux / UNIX / AIX

Root username and password. WebLogic, Tuxedo, or OAS administrator username and password. NOTE: Root username is recommended but another account can be used given that it has Root’s privileges.

2.3.

Running the Scripts

This section describes how to run the Oracle LMS Collection Tool for the products listed in the Measurement Overview section of the document. Running the LMS Collection Tool requires the acceptance of the Oracle LMS License Agreement (included in the script).

8 | LMS Collection Tool Measurement Instructions

Note: Running LMS Collection Tool with the  –L Y  option, indicates that you have read and accepted the Oracle

LMS License agreement, which can be found in LMSCollection\resources\util\license_agreement.txt In what follows, we provide instructions on running the tool on Linux/UNIX or Windows environments for each product. Customers can also choose to run the tool to collect data for multiple (or all) products at once on a given machine. If you are unsure of the products installed on a given server, run the LMS Collection Tool to collect data for all the Oracle Software products listed in the Measurement Overview. Details on this option are provided in the sections below. On Linu x / UNIX Systems

1.

Copy the Oracle_LMS_Collection_Tool.zip file to the target system.

2.

Open a Terminal window.

3.

Log into the target system as root, if you log on as another user the search may not pick up all of the necessary Oracle Software Files.

4.

Go to the directory where you placed the Oracle_LMS_Collection_Tool.zip file and extract the files. $unzip Oracle_LMS_Collection_Tool.zip.

5.

Go to the Oracle_LMS_Collection_Tool directory. $ cd Oracle_LMS_Collection_Tool/LMSCollection Note: It is recommended to change permissions to execute for all files prior to usage.

$ chmod –R +x * 6.

Create the output directory where the output files will be stored. $ mkdir /tmp/LMS_Review

7.

Go to the bin directory and type ‘LMSCollection.sh’ with the proper options to run.

$ cd bin $ ./LMSCollection.sh Refer to Table 6 below for instructions on the proper options that you need to include. Refer to Table 7 for specific examples. Note: the syntax of all available command line options is as follows

[-d search_dir] [-fsall true|false] [-o dir_name] [-follow true|false] [-debug true|false] [-m all|ip|user] [-L Y|N] [-p product] [-fastsearch] TABLE 7. LINUX AND UNIX OPTIONS OPTION

DESCRIPTION

-d search_dir

Specifies the directories to be searched for Oracle Software installations. A quoted string of directory names separated by a comma is required when more than one directory is to be searched. The default is the root directory

-fsall true | false

When specified, all file systems (including remote ones) are searched, otherwise only the local file system is searched. Default is true.

9 | LMS Collection Tool Measurement Instructions

-o dir_name

Option to output the file to the directory specified by dir_name. The file will be named LMSCollection-.tar(.z or .bz2). If not specified, the default is the local directory.

-follow true | false

Follow symbolic links during file search. Some older versions of AIX do not allow the find command to follow symbolic links, so this must be set to false for the script to work with those systems. Default is true.

-debug true | false

Option to turn on debugging information. Default is false.

-m all|ip|user

Option to turn on masking of sensitive information for WebLogic license and configuration files. Refer to the README.txt for details. Perl needs to be in the system path for this to run. Default is off. Applicable to WebLogic, SOA and Tuxedo only.

-L Y | N

Option to agree to license agreement without having it displayed. Default is off, so the License Agreement will be printed on the screen.

-p product

Option to pass in a list of Oracle products to look for. Valid options are one or more of the following: LMSCPU, FormsReports, OAS, SOA, Tuxedo, WLS, WLSBasic, WLSNUP, all If you are uncertain of the products installed on a given server, run the LMS Collection Tool to collect data for all the Oracle Software products listed in the Measurement Overview by using the –p all option. Refer to the README.txt for more details.

-fastsearch

Option to have the tool search for default Oracle environments from well known file locations, environment variables and command line options. Note: The fast search option of the tool is intended to gather information from the

system with minimal file searching.

8.

Length of Scan. The Oracle LMS Collection Tool searches for several possible configuration, registry, and log files on the target machine. To verify that the Oracle LMS Collection Tool is running, you can use the following UNIX commands: $ ps -ef | grep find $ tail -a //FMWfiles.*

9.

After the tool has finished running the data collection process, an output directory and a .tar or .tar.bz2 (or .tar.Z if bzip2 or compress is found on your UNIX system) file that contains Oracle Software related files will be created.

10. Return the output file ‘LMSCollection-.tar ’ (.tar.bz2 or .tar.Z), to your LMS representative per the instructions that were provided to you.

10 | LMS Collection Tool Measurement Instructions

E x a m p l e s - R u n n i n g t h e T o o l o n L i n u x / U N IX

Table 8 below provides examples on the options that could be passed as parameters to step 7 above. TABLE 8. LINUX AND UNIX OPTIONS EXAMPLES PRODUCT

OPTIONS

OAS

$ ./LMSCollection.sh -d / -p OAS -o /tmp/LMS_Review -p product collects the OAS product files -o dir_name in this case the output directory will be the LMS_Review folder

FormsReports

$ ./LMSCollection.sh -d / -p FormsReports -o /tmp/LMS_Review -p product collects the FormsReports product files -o dir_name in this case the output directory will be the LMS_Review folder

WLS

$ ./LMSCollection.sh -d / -p WLS -o /tmp/LMS_Review -p product collects the WLS product files -o dir_name in this case the output directory will be the LMS_Review folder For customers who need data masking, they can run the tool with the following options: $ ./LMSCollection.sh -d / -p WLS -o /tmp/LMS_Review -m all For customers who are running WebLogic Basic or own WebLogic Named User Plus licenses, run the tool by adding the appropriate options and value the input file wlstInput.txt. The wlstInput.txt file is required to be valued correctly in order for the WebLogic NUP or WebLogic Basic script to run. Example Commands: WebLogic and WLBasic: -p WLS,WLSBasic WebLogic, and WLS NUP: -p WLS,WLSNUP

SOA

$ ./LMSCollection.sh -d / -p SOA -o /tmp/LMS_Review -p product collects the SOA product files -o dir_name in this case the output directory will be the LMS_Review folder For customers who need data masking, run the tool with the following options: $ ./LMSCollection.sh -d / -p SOA -o /tmp/LMS_Review -m all For customers who are using WebLogic Basic or own SOA Suite licenses under the Named User Plus metrics, run the tool by adding the appropriate options and value the input file wlstInput.txt. The wlstInput.txt file is required to be valued correctly in order for the WebLogic NUP or WebLogic Basic script to run. Example Commands: SOA, WLBasic and WLS NUP: -p SOA,WLSBasic, WLSNUP

Tuxedo

$ ./LMSCollection.sh -d / -p Tuxedo -o /tmp/LMS_Review -p product collects the Tuxedo product files -o dir_name in this case the output directory will be the LMS_Review folder For customers who need data masking, run the tool with the following options: $ ./LMSCollection.sh -d / -p Tuxedo -o /tmp/LMS_Review -m all

11 | LMS Collection Tool Measurement Instructions

Multiple Products

$ ./LMSCollection.sh -p WLS,Tuxedo,SOA,OAS -d "/opt/software, /home/software" -o /tmp/LMS_Review -L y -p product Collects WLS, Tuxedo, SOA, and OAS product files -d search_dir in this case the /opt/software AND /home/software paths will be searched -o dir_name in this case the output directory will be the LMS_Review folder -L Y denotes that the LMS License Agreement was read and accepted

 All products

$ ./LMSCollection.sh -d / -p all -o /tmp/LMS_Review -p all collects all product files -d search_dir searches all file directories starting from / -o dir_name in this case the output directory will be the LMS_Review folder

On Windows Systems

1.

Copy the Oracle_LMS_Collection_Tool.zip file to the target system.

2.

Log into the target Windows system as Administrator, if you log on as another user the search may not pick up all of the necessary Oracle Software Files.

3.

Unzip the file using to the same directory.

4.

Open a command prompt window. Go to Windows ‘Start’ > ‘Run’ menu and type ‘cmd’

5.

Go to the Oracle_LMS_Collection_Tool bin folder. > cd Oracle_LMS_Collection_Tool\LMSCollection\bin

6.

Create the output directory where the output files will be stored. >mkdir C:\LMS_Review

7.

Type ‘LMSCollection.cmd’ with the proper options to run.

>LMSCollection.cmd Refer to Table 8 below for instructions on the proper options that you need to include. Refer to Table 9 for specific examples. Note: the syntax of all available command line options is as follows.

-d search_dir [-p product] [-o dir_name] [-debug true|false] [-m all|ip|user] [-L Y|y|N|n][-fastsearch] TABLE 9. WINDOWS OPTIONS OPTION

DESCRIPTION

-d search_dir

Specifies the folders to be searched for Oracle software installations. A string of directory names separated by a comma is required when more than one directory is to be

12 | LMS Collection Tool Measurement Instructions

searched. The default is all fixed or local drives. i.e. c:,d: (not the CDROM or NFS drives). -o dir_name

Option to output the collected files to the directory given by . The file will be named LMSCollection-.zip. If not specified, the default is the %TEMP% directory.

-debug true | false

Option to turn on debugging information. Default is false.

-m all|ip|user

Option to turn on masking of sensitive information. Refer to the README.txt for details. Perl needs to be in the system path for this to run. Default is off. Applicable to WebLogic, SOA and Tuxedo only.

-L Y|y|N|n

Option to agree to the license agreement without having it displayed. Default is off, the License Agreement will be printed on the screen.

-p product

Option to pass in a list of Oracle products to look for. Valid options are one or more of the following: LMSCPU, FormsReports, OAS, SOA, Tuxedo, WLS, WLSBasic, WLSNUP, all If you are unsure of the products installed on a given server, run the LMS Collection Tool to collect data for all the Oracle Software products listed in the Measurement Overview by using the –p all option. Refer to the README.txt for more details.

-fastsearch

Option to have tool search for default Oracle environments from well known file locations, environment variables and command line options. Note: The fast search option of the tool is intended to gather information from the system

with minimal file searching.

8.

Length of Scan. The Oracle LMS Collection Tool searches for several possible configuration, registry and log files on the target machine. To verify that Oracle LMS Collection Tool is running, you can use the Windows Task Manager.

9.

After the tool has finished running the data collection, an output folder and a .zip file that contains Oracle Software related files will be created.

10. Return the output file ‘LMSCollection-.tar ’ (.tar.bz2 or .tar.Z), to your LMS representative per the instructions that were provided to you. Examples - Running the Tool on Wind ows

The table 10 below provides examples on the options that could be passed as parameters to step 7 above.

13 | LMS Collection Tool Measurement Instructions

TABLE 10. WINDOWS OPTIONS EXAMPLES PRODUCT

OPTIONS

OAS

> LMSCollection.cmd -p OAS -d c:\,d:\ -o C:\LMS_Review -p product collects the OAS product files -o dir_name in this case the output directory will be the LMS_Review folder

FormsReports

> LMSCollection.cmd -d / -p FormsReports -o C:\LMS_Review -p product collects the FormsReports product files -o dir_name in this case the output directory will be the LMS_Review folder

WLS

> LMSCollection.cmd -p WLS -d c:\,d:\ -o C:\LMS_Review -p product collects the WLS product files -d search_dir by searching the c: and d: drives -o dir_name in this case the output directory will be the LMS_Review folder For customers who are running WebLogic Basic or own WebLogic Named User Plus licenses, run the tool by adding the appropriate options and value the input file wlstInput.txt. The wlstInput.txt file is required to be valued correctly in order for the WebLogic NUP or WebLogic Basic script to run. For example: WebLogic and WLBasic: -p WLS,WLSBasic WebLogic, and WLS NUP: -p WLS,WLSNUP

SOA

> LMSCollection.cmd -p SOA -d c:\,d:\ -o C:\LMS_Review -p product collects the SOA product files -d search_dir by searching the c: and d: drives -o dir_name in this case the output directory will be the LMS_Review folder For customers who are using WebLogic Basic or own SOA Suite licenses under the Named User Plus metrics, run the tool by adding the appropriate options and value the input file wlstInput.txt. The wlstInput.txt file is required to be valued correctly in order for the WebLogic NUP or WebLogic Basic script to run. For example: SOA, WLBasic and WLS NUP: -p SOA,WLSBasic,WLSNUP

Tuxedo

> LMSCollection.cmd -p Tuxedo -d c:\,d:\ -o C:\LMS_Review -p product collects the Tuxedo product files -d search_dir by searching the c: and d: drives -o dir_name in this case the output directory will be the LMS_Review folder

Multiple Products

> LMSCollection.cmd -p WLS,Tuxedo,SOA,OAS -d c:\,d:\ -o C:\LMS_Review -L y -p product collects the WLS, Tuxedo, SOA, and OAS product files -d search_dir by searching the c: and d: drives -o dir_name in this case the output directory will be the LMS_Review folder -L Y denotes that the LMS License Agreement was read and accepted

14 | LMS Collection Tool Measurement Instructions

 All Products

> LMSCollection.cmd –p all -d c:\,d:\ -o C:\LMS_Review -p all collects all product data -d search_dir by searching the c: and d: drives -o dir_name in this case the output directory will be the LMS_Review folder

Partitioned Servers - LMSCPU Script

If server partitioning is in use, in addition to running the Oracle LMS Collection Tool from within the partition on which the Oracle software is deployed, the Oracle LMS Collection Tool needs to be run on the operating system of the underlying server hardware to collect the relevant CPU information (an exception to this would be when an Oracle-approved hard partitioning technique is used). If an embedded hypervisor, such as VMware, is used, then screenshots of the embedded hypervisor administration interface are required. These screenshots must show the underlying base server hardware for each virtual guest. If screenshots are not provided, then the hardware specifications are needed along with mappings of each virtual guest to its underlying base server hardware. Table 11 below provides an example on running the script to collect the CPU information of the underlying server hardware. TABLE 11. LMSCPU OPTIONS PRODUCT

OPTIONS

LMSCPU

> LMSCollection.cmd -p LMSCPU -o C:\LMS_Review -p product collects the CPU information -o dir_name in this case the output directory will be the LMS_Review folder

M u l t i p l ex i n g a r c h i t e c tu r e

If Oracle software is part of an environment in which multiplexing hardware or software is used and individual connections cannot be identified, then all users and/or devices must be declared at the multiplexing front end.

3. Troubleshooting Initial Phase 

Invalid script options. If invalid options are given to the script at startup, the script will not start. Please review the startup command line options listed above. o

Use comma separated directories for the  –d search dir option.

o

Make sure there is one space after the options, not two nor tab character.

o

Make sure that the directory you used for the  –o output directory option is writable by the user running the script.

o

Use the correct options to the  –p Product option.

o

If you are not sure of the options to use, you can choose not to give any options and have the script prompt you for values. At this time the script will use default values for the output directory and search directory.



Not accepting the license agreement. The license agreement must be accepted before continuing on with the script. If you don’t accept the prompt or use the –L Y license agreement option, the script will not continue.

15 | LMS Collection Tool Measurement Instructions



Not having the correct permissions to search or write to the output directory.

Troubleshooting Executing Phase 

Running the script with the WLNUP and/or the WLSBasic Product options without setting up your environment. Please make sure that you value the LMSCollection\resources\util\WLST\wlstInput.txt file correctly before running the script. o

If you do not update the wlstInput.txt file and are running a search for a product that needs to run the WLST commands for WLNUP and/or WLSBasic, the script will pause (if not using the  –L option) and request that you update the file. The message shown will be: 

The file wlstInput.txt has not been updated to include the values needed to connect to your WebLogic domain(s). Please do so at this time in a separate text editor.



o

While the script is paused you can correctly value the wlstInput.txt file.

In the wlstInput.txt file you would write the information from the Technical Requirements table on a comma separated line. You can have lines for multiple servers. For example  



Target_Machine_Name_or_IP,WebLogic_DomainName,WebLogic_DomainHostURL_or_IP:700 1,WebLogic_DomainAdminID,WebLogic_DomainAdminIDPassword



o

127.0.0.1, base_domain,127.0.0.1:7001,weblogic,weblogic1

In addition to the WebLogic domain variables, if you do not have the WLS_HOME environment variable set, you can value it in the wlstInput.txt file.  





WLS_HOME=C:\Oracle\Middleware\wlserver_10.3

WLST output errors with the WLNUP and/or the WLSBasic Product options. Depending on the server security setup we may not always be able to connect to the running WebLogic Server. Make sure that the wlstInput.txt is set up correctly. If it is and you still have WLST errors, then those errors are acceptable. Please contact your LMS representative if you require further assistance. o

If there is an error during the WLST product run, you will be notified with a message at the end of the entire script run. Make sure that the values in wlstInput.txt are correct and try again. If the error persist contact your LMS representative for further assistance.



Running the script with the Tuxedo Product options without setting up your environment. Please make sure that you set up the Tuxedo TUXDIR and TUXCONFIG environment variables correctly when running the script.

4. Collected Data Description The scripts collect the following files and information.  After the LMS Collection tool finishes, all results will be placed in a file named _.zip (.tar, .bz2), where is the dns name of the machine that the script is run on. is a list of the Oracle Fusion Middleware products searched for during the execution of the script. .zip is the output name extension when running on Windows. .tar.bz2 is the output name extension when running the script on Unix and bzip is used for compression. .tar is the output name extension when running the script on Unix and compression is not able to be completed. Some examples: LMSCollection-WindowsMachine_WLS_SOA.zip o  LMSCollection-LinuxMachineB_all.tar o  LMSCollection- LinuxMachineC_all.tar.bz2 o  

  

16 | LMS Collection Tool Measurement Instructions

TABLE 12. COLLECTED DATA DESCRIPTION PRODUCT

FILE

DESCRIPTION

 All Products

-info.txt lms_cpuq.txt

These files contain the Operating System and machine information.

LMSCollection-Actions-txt

This file contains a listing of the files run and the actions taken by the LMS Collection tool

LMSCollection-.txt

This file contains a listing of files collected by the LMS Collection tool.

_.zip(.tar,.bz2)

Compressed archive of the contents to be collected.

WLS SOA OAS

comps.xml opmn.xml ias.properties ear-deployer.xml ejb-deployer.xml server.xml domain.xml config.xml *jdbc.xml *jms.xml Module-.xml deployment.xml setupinfo.txt

These files contain elements that are used by J2EE  Application Servers to configure and deploy FMW applications.

WLS SOA Tuxedo OAS

registry.xml domain.xml install*.out installActions*.log installProfile*.log oraInstall*.log

These files are created or updated by FMW product installers when a product is installed and includes information such as the date when the FMW product was installed.

WLS SOA

domain-registry.xml

This registry file contains the location of all domains currently registered with this WebLogic Server installation. Whenever you add a new domain, it is registered in this file.

WLS SOA

startWebLogic.sh startWLS.sh startManagedWebLogic.sh startNodeManager.sh startup.properties

 Application Server start up scripts and properties.

WLS SOA

tangosol-coherence.xml cache-config.xml

Coherence configuration files.

Tuxedo

lic.txt *ubb* tuxconfig* dmconfig* tuxwsvr.ini bdmconfig*

Tuxedo license configuration and log files.

OAS SOA

results-oas-query.txt

Oracle Process Management Notification process names

17 | LMS Collection Tool Measurement Instructions

Oracle Corporation, World Headquarters

Worldwide Inquiries

500 Oracle Parkway

Phone: +1.650.506.7000

Redwood Shores, CA 94065, USA

Fax: +1.650.506.7200

CONNECT WITH US

blogs.oracle.com/oracle facebook.com/oracle twitter.com/oracle oracle.com

Copyright © 2015, Oracle and/or its affiliates. All rights reserved. This document is provided for   information purposes only, and the contents hereof are subject to change without notice. This document is not warranted to be error-free, nor subject to any other warranties or conditions, whether expressed orally or implied in law, including implied warranties and conditions of merchantability or fitness for a particular purpose. We specifically disclaim any liability with respect to this document, and no contractual obligations are formed either directly or indirectly by this document. This document may not be reproduced or transmitted in any form or by any means, electronic or mechanical, for any purpose, without our prior written permission. Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered trademark of The Open Group. 0615 LMS Collection Tool Measurement Instructions March 2016  Author: Dan Pipitone Contributing Authors: Iulian Zagan, Octavian Soimu, Cornel Panait

18 | LMS Collection Tool Measurement Instructions