1. Manuals
  2. Brands
  3. VMware Manuals
  4. Software
  5. VCENTER APPLICATION DISCOVERY MANAGER 6.1 -...
  6. Reference manual

VMware VCENTER APPLICATION DISCOVERY MANAGER 6.1 - REPOSITORY Reference Manual

Hide thumbs Also See for VCENTER APPLICATION DISCOVERY MANAGER 6.1 - REPOSITORY:
Table of Contents

Advertisement

Quick Links

Download this manual See also: Administration Manual, User Manual
Application Discovery Manager
Repository Reference Guide
vCenter Application Discovery Manager 6.1
This document supports the version of each product listed and
supports all subsequent versions until the document is replaced
by a new edition. To check for more recent editions of this
document, see http://www.vmware.com/support/pubs.
EN-000452-00

Advertisement

Table of Contents
loading

Related Manuals for VMware VCENTER APPLICATION DISCOVERY MANAGER 6.1 - REPOSITORY

Summary of Contents for VMware VCENTER APPLICATION DISCOVERY MANAGER 6.1 - REPOSITORY

  • Page 1 Application Discovery Manager 6.1 This document supports the version of each product listed and supports all subsequent versions until the document is replaced by a new edition. To check for more recent editions of this document, see http://www.vmware.com/support/pubs. EN-000452-00...
  • Page 2 VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.

  • Page 3: Table Of Contents

    Manually Loading Data to the External Database 23 Checking the Status of the External Database Load Process 24 Upgrading the External Database 24 Upgrading for MS SQL 24 Upgrading for Oracle 25 ADM ERD Schema 27 Overview of External Database Tables 28 Database Structure and Dependencies 28 Address 30 Change_Log 30 CPU 30 Database 31 Dependency 31 Group_Membership 32 Installed_Software 33 IP_Route 33 Java_EE 34 Network_Element 34 Network_Interface 36 VMware, Inc.
  • Page 4 ADM Repository Reference Guide Port 36 Property 37 Service 37 Storage_Device 38 Switch_Address_Forwarding 38 Time Dimension 39 Usage Metric 39 Usage_Metric_Baseline 40 Virtual_System_Settings 40 ADM Custom Reports 41 Creating Custom Reports 41 Host Inventory 41 Connection Inventory 41 Most Used Services 41 Application Dependency 42 VMware, Inc.

  • Page 5: About This Book

    About This Book The VMware vCenter™ Application Discovery Manager (ADM) Repository Reference Guide provides  information about setting up and configuring the ADM external repository. It describes the table structure and  dependencies within the ADM external database and also illustrates the tables. To help you with the custom  reports, the book provides examples of reports that can be generated from the ADM external database. Intended Audience This document is part of the VMware vCenter Application Discovery Manager documentation set, and is  intended for use by corporate Information Technology (IT) personnel who need to monitor enterprise  applications and resources and make decisions about acquiring, allocating, and modifying these resources.  Readers of this guide are expected to be familiar with these topics:  Oracle database  VMware Technical Publications Glossary ® VMware  Technical Publications provides a glossary of terms that might be unfamiliar to you. For definitions  of terms as they are used in VMware technical documentation go to http://www.vmware.com/support/pubs. Document Feedback VMware welcomes your suggestions for improving our documentation. If you have comments, send your  feedback to docfeedback@vmware.com. Technical Support and Education Resources The following sections describe the technical support resources available to you. To access the current version  of this book and other books, go to http://www.vmware.com/support/pubs. Online and Telephone Support To use online support to submit technical support requests, view your product and contract information, and ...
  • Page 6 ADM Repository Reference Guide VMware Professional Services VMware Education Services courses offer extensive hands‐on labs, case study examples, and course materials  designed to be used as on‐the‐job reference tools. Courses are available onsite, in the classroom, and live  online. For onsite pilot programs and implementation best practices, VMware Consulting Services provides  offerings to help you assess, plan, build, and manage your virtual environment. To access information about  education classes, certification programs, and consulting services, go to http://www.vmware.com/services. VMware, Inc.

  • Page 7: Introduction

    Table 1-1. ADM Components Component Description Active Discovery‐  Collects data from the configuration objects in your data center. The following discovery types  Unix apply:  IP discovery — Detects hosts or other configuration items with a specific IP address when  passive discovery fails to discover them.  Detail discovery — Extends the information obtained using passive and IP discovery. It uses  common network protocols to remotely query servers in the managed network and obtains  supplementary information about network hosts that is added to the database. Active Discovery‐  A discovery engine that uses WMI based discovery policies for performing active discovery on  Windows Windows machines. Passive Discovery Passively observes the network traffic by performing a deep‐packet analysis to discover  applications and component relationships in physical and virtual environments. Passive discovery also allows you to do the following:  Map dependencies.  Count the activity of these dependencies.  Identify services. Aggregator Receives data from the discovery components and reconciles the data before transferring it to the  database component. The aggregator also provides the user interface for using ADM and is the  integration point for various integrations, for example, ERDB. Database An Oracle RDBMS used to store discovered data and ADM configuration. Figure 1‐1 illustrates how data is collected and stored in the ADM database. VMware, Inc.

  • Page 8: Synchronizing The External Database

    ETL (Extract‐Transform‐Load) process. Extraction and transformation is done through ADM and loading is  done by the adm_olap component on the external database host. Figure 1-2. External Database Synchronization Process flat files flat files data download data upload FTP server database server load flat files into ADM_OLAP Schema ADM_OLAP Reporting Schema The synchronization process comprises of the following steps: The synchronization is triggered according to the settings in the External Reports Scheme Configuration  policy. ADM checks the status of the replication to ensure that the previous synchronization and that any report  requests against the external database has completed.  ADM extracts the data files for the load process as follows: The Report Schema is extracted and translated to .csv files. The data files are compressed and placed together in a single Zip archive. The Zip file is uploaded to the assigned FTP server. VMware, Inc.
  • Page 9 Chapter 1 Introduction The system running the external database periodically checks the FTP server for data files based on the  synchronization schedule defined on the external database system.  When a data file is found, the following process takes place on the external database system:  The latest Zip file is downloaded. The Zip file is extracted to the decompressed .csv data files. The database loading is performed using the database specific loader. Performance and Scalability The following steps indicate the amount of time required to complete each process:  Extraction and flat file creation — This step utilizes the ADM resources to the maximum. Therefore, it is  scheduled to extract the data at night or some other period of low resource consumption and to allow  enough time to complete.  Transferring the data files — This step involves uploading of the flat files from the ADM Repository  appliance to the external database host. This step does not consume many ADM resources. However, the  transfer time might vary greatly because of network conditions at the external database host site.  Loading the database — This step might take few hours to complete. VMware, Inc.
  • Page 10 ADM Repository Reference Guide VMware, Inc.

  • Page 11: Set Up The External Reports Scheme Configuration Policy

    Set Up and Monitor the External Reports Scheme Configuration Policy The External Reports Scheme Configuration policy defines the FTP site where the database files are sent and  how often extraction is performed. The External Reports Scheme Configuration provides functionality for  running the policy automatically at a scheduled time, or starting the synchronization now. This policy only controls the following steps of the synchronization process:  Database data extraction  Database files creation  Posting the database files to the FTP site You must configure the external database host to retrieve the data files from the FTP site and complete the  synchronization process. Chapter 3, “External Database Setup,” on page 15 provides complete details.  Creating the External Reports Scheme Configuration Policy To set up the External Reports Scheme Configuration policy Log in to the ADM Console as admin user. From the ADM Console, navigate to Connectors > Reports and click Configuration in the left pane. VMware, Inc.
  • Page 12  Target Host — the system hosting the FTP server.  Target Directory — the directory on the FTP server host to which the files are sent.   User Name — the name of a user with access to the FTP server.  Password — the password associated with the user name.    Ensure that the user name and password are the same, as used to configure the  synchronization on the external database system as described in “Installing and Configuring the  External Database for Oracle” on page 16 for Oracle databases user and “Installing and Configuring  the External Database for MS SQL” on page 20 for MS SQL Server users.  Transport Channel — allows user to choose between FTP and Secured FTP (SFTP) for data upload  from the drop‐down menu.  Number of Retries — the number of times the synchronization process attempts, in case of failure. Click Test Connection to test the connection to the FTP server based on the publishing credential you  entered. If you have entered invalid credentials or if the FTP server is down, the test times out or fails. Click Create policy. If you have previously defined the policy, click Update. Running the Synchronization Process at Scheduled Times To schedule the synchronization process After creating the External Reports Scheme Configuration policy, select the Enable Automatic  Scheduling option at the bottom of the page as shown below.  In the Scheduling tab, select one or more days of the week to schedule the start of the synchronization. VMware, Inc.

  • Page 13: Check The Status Of The Synchronization Process

     Creation of the database file.  Posting the database files to the FTP site. To check the status of the synchronization process Log in to the ADM Console as admin user. From the ADM Console, navigate to Connectors > Reports and click Status in the left pane. The display pane lists the following parameters:  Last Sync. Time — the last time the external database was synchronized with the ADM repository.  The time is based on the location of the appliance.  Synchronization Status — the status of the synchronization process, which is one of the following:  Idle — the process is idle. Nothing is currently running.  Complete — the ADM synchronization is complete and the FTP files are loaded to the FTP  Server.  Sync in progress — the ADM synchronization process is in progress.  Scheduled Synchronization Status — the status of the synchronization schedule, which is one of the  following: Active — the synchronization schedule is set and runs at the scheduled time. Not Active — there is no schedule associated with the policy.  Populated Elements — lists the elements that were populated to the external database during the last  synchronization.  Count — gives the number of elements that were populated to the external database. Click Log in the left pane to view the messages, describing the events of the synchronization process. VMware, Inc.
  • Page 14 ADM Repository Reference Guide VMware, Inc.

  • Page 15: External Database Setup

    “Upgrading the External Database” on page 24 External Database System Requirements To incorporate an external database into your ADM environment, you need the following components:  Access to an FTP server.  The external reporting database client has to be installed on the same server as the database.  The hardware and software requirements as follows. Minimum Hardware Requirements Ensure that your system meets the following hardware requirements:  2 GB memory.  Dual core 1.8 GHZ CPU.  500 MB for the client installation. If the data Zip files are retained on the server, more disk space is needed.  1 GB for the database instance. Software Requirements The software requirements for each type of database are as follows: Oracle as the External Database Ensure the system meets the following requirements when using Oracle as external database:   Red Hat Enterprise Linux 4.0  Oracle 10g R2 (10.2.0.1.0) VMware, Inc.

  • Page 16: Installing And Configuring The External Database For Oracle

     Perl with the Archive::Zip module Common Perl distribution for Windows is ActivePerl from ActiveState. The necessary Archive::Zip  module is bundled with ActivePerl. Installing and Configuring the External Database for Oracle Use the following procedures to install and configure the external database for Oracle. Install the Client-Side Script To install the Client-side script Copy the ADM external database installation file (adm_olap_ v.X.X-XXX .zip, where  v.X.X-XXX  is the  ADM version and build number) from http://downloads.vmware.com/Application Discovery Manager. Log in to the Linux Server. Change directories to the location of the installation file. Unzip the adm_olap_v.X.X-XXX.zip to a directory of your choice.  A directory named adm_olap is created with all the client‐side scripts in it. Change the adm_olap directory permission to allow read access to all users.  To enable read permission, in Linux run: chmod 777 -R adm_olap VMware, Inc.

  • Page 17: Create The External Reporting Database User

    Oracle Database 10g Release 10.1.0.2.0 - Production Verify that the instance is running, the database is mounted, and the listener is started.  Run the SQL script to create the adm_olap user: sql> @create_olap_user.sql User created. Grant succeeded.    The user created here must be the same user that was defined when setting up the External Reports  Scheme Configuration policy. The External Reports Scheme Configuration defines the FTP server where  the extracted data files are transferred and how often the synchronization occurs. Type quit to exit the sqlplus prompt. Create the adm_olap Tables To create the adm_olap tables    The adm_olap schema creation is meant to be managed by the client Database Administrator (DBA).  Simple SQL scripts are provided to support the basic ADM tables. To support additional information add  external tables. Changes to the tables provided with ADM are overwritten with each load. The scripts are  located where the adm_olap_v.x.X-XXX.zip file was extracted followed by/schema/oracle.  Log in to SQLplus as adm_olap: sqlplus adm_olap/adm_olap Run the SQL script to create the tables: SQL> @create_tables.sql Type quit to exit the sqlplus prompt.     Do not add constraints. With the constraints turned on, the loader fails to load the data. VMware, Inc.

  • Page 18: Configure The Synchronization Process

    # This can be used, for example, to remove indexes before the data loading # and re-create the indexes after the load is complete. #hook.before.load= #hook.after.load= Configure the database loader for Oracle. The Oracle loader script is configured using the oracle.properties file, that is located in the  unzip_path /adm_olap/load/ directory. An example file, oracle.properties.example, has been  unzip_path provided in  /adm_olap/load/:  Make a copy of the oracle.properties.example file and name it oracle.properties: cp oracle.properties.example oracle.properties VMware, Inc.
  • Page 19 <cron expression><install dir>/adm_olap/sync_adm_olap.pl >> install_dir < >/adm_olap/log/sync.log 2>&1    For secure ftp, use the sync_adm_olap_sftp_oracle.pl script instead of  sync_adm_olap.pl and for more information about cron expression please contact your unix admin. The following is an example of a cron entry in Linux, where the process is scheduled to run after every  15 minutes: PATH=... ORACLE_SID=... ORACLE_HOME=... */15 * * * * <install dir>/adm_olap/sync_adm_olap.pl >> < install dir >/adm_olap/log/sync.log 2>&1 VMware, Inc.

  • Page 20: Installing And Configuring The External Database For Ms Sql

    Run the create_database.sql script to create the ADM external database: <serverName> sqlcmd -S -i create_database.sql Run the create_olap_schema.sql script to create the adm_olap schema: <serverName> sqlcmd -S -i create_olap_schema.sql Run the create_adm_olap_login.sql script to create the login: serverName sqlcmd -S < > -i create_adm_olap_login.sql Run the create_user_for_login.sql script to create the login user: sqlcmd -S <serverName> -i create_user_for_login.sql    The user created here, must be the same user that was defined when setting up the External  Reports Scheme Configuration policy. The External Reports Scheme Configuration policy defines the FTP  server where the extracted data files are transferred and how often the synchronization occurs.  Run the create_tables.sql script to create the adm_olap tables: <serverName> sqlcmd -S -i create_tables.sql    Do not add constraints. With the constraints turned on, the loader fails to load the data. VMware, Inc.

  • Page 21: Configure The Synchronization Process

    # archive option will save a local copy of the compressed data at the specified directory archive=true archive.dir=archive archive and archive.dir defines whether or not to store the zipped files locally for history  tracking. If necessary add the hooks, hook.before.load= and hook.after.load= allow custom behavior just  before the data loading and after the loading is complete. Such hooks are used to add or drop  indices, to add client specific data for loading together with ADM data, or any other desired  actions. The property contains the path to an executable script: # This can be used, for example, to remove indexes before the data loading # and re-create the indexes after the load is complete. #hook.before.load= #hook.after.load= VMware, Inc.
  • Page 22 Synchronization Process Now” on page 13.  After the upload completes perform the following steps on the system on which the database is  installed: Log in as a user with administrator permissions. From the Windows Start menu, select Run and type cmd. The command prompt appears. unzip_path Change directories to  \adm_olap\and run the synchronization process: <unzip_path> \adm_olap\ <perl_dir> <install_dir> \bin\perl.exe \adm_olap\sync_adm_olap.pl    For secure ftp, use the sync_adm_olap_sftp_sqlserver.pl script instead of   sync_adm_olap.pl Avoid id key verification for the first time by creating the id key as follows: Run psftp manually against the ftp server using command line psftp -pw password user@host   and then type yes when prompted.  Schedule the synchronization process to run automatically for the MS SQL database:    For the Windows scheduled task functionality, the flexibility to schedule tasks is limited. The  schedules available are daily, weekly, monthly, and one time only, when the computer starts, or when the  user logs in.  From the Windows Start menu, navigate to Setting > Control Panel > Scheduled tasks. Double‐click Add Scheduled Task to open the Schedule Task Wizard. Click Next to select the task you are scheduling. Browse to the  unzip_path/ adm_olap directory and select sync_adm_olap.pl.    For secure ftp use the sync_adm_olap_sftp_sqlserver.pl script instead of   sync_adm_olap.pl Enter a name for the syn_adm_olap.pl task schedule.  VMware, Inc.

  • Page 23: Manually Loading Data To The External Database

    To load the zip files manually for Oracle Unzip the contents of the zip file to the  unzip_path /adm_olap/data directory: unzip adm_olap_v.X.X-XXX.zip -d adm_olap/data/ Change directories to the loader base directory and run the loader script: <unzip_path> /adm_olap/load/ ./load_oracle.pl To load the zip files manually for MS SQL Server unzip_path From Windows Explorer, copy the adm_olap_v.X.X-XXX.zip file to  \adm_olap\data\  folder. Right‐click the adm_olap_v.X.X-XXX.zip file and unzip it to the same location.  From the Windows Start menu, select Run and type cmd. The command prompt appears. Change directories to the loader base directory and run the loader script: <unzip_path> \adm_olap\load\ load_sqlserver.pl VMware, Inc.

  • Page 24: Checking The Status Of The External Database Load Process

    Upgrading for MS SQL When upgrading the external database for MS SQL: Optionally, record the Scheduled Task configuration: From the Windows Start menu, navigate to Setting > Control Panel > Scheduled tasks and open the  sync_adm_olap task. Record the configuration for later use. Delete the sync_adm_olap task. From the Windows Start menu, navigate to Setting > Control Panel > Scheduled tasks and open the  sync_adm_olap task. Right‐click the sync_adm_olap task and click Delete. Ensure that synchronization is not currently running as follows: Log in to the ADM Console as admin user. From the ADM Console, navigate to Connectors > Reports > External Reports Scheme Integration  Status. If Synchronization Status indicates synchronization in progress, wait till it completes and then  proceed with the upgrade.    The following step clears the data in the external report database. The data is recovered  MPORTANT once you perform a full synchronization after the upgrade is complete. Ensure that SQL scripts are associated with SQL Server Management Studio before continuing. Execute the following SQL scripts located in the adm_olap/scheme/sqlserver folder using the  user/password adm_olap/adm_olap (To execute, double‐click the script):   drop_constraints.sql  truncate_data.sql  drop_tables.sql Execute the following SQL scripts located in the adm_olap/scheme/sqlserver folder using a user with  administrator permissions (To execute, double‐click the script):   drop_olap_schema.sql  drop_database.sql Backup the old adm_olap folder that includes the sync.properties and sqlserver.properties files  (It contains your configuration settings). VMware, Inc.

  • Page 25: Upgrading For Oracle

    -e Delete the task from the file. Save and exit. Log in to the ADM Console as admin user. From the ADM Console, navigate to Connectors > Reports > External Reports Scheme Integration Status  and check if the Synchronization Status is complete. If the status is sync in progress, wait for it to  complete. Backup the folder in which you originally installed the adm_olap files. This folder includes the  sync.properties and the oracle.properties files, that contains your configuration settings.  Backup the folder in which you originally installed the adm_olap files. This folder includes the  sync.properties and the oracle.properties files, that contains your configuration settings.    The data in the external report database is lost as a result of the following step. The data is  MPORTANT recovered once you perform a full synchronization after the upgrade is complete. Execute the following scripts located in adm_olap/scheme/oracle:   sqlplus adm_olap/adm_olap @ drop_constraints.sql  sqlplus adm_olap/adm_olap @ truncate_data.sql  sqlplus adm_olap/adm_olap @ drop_tables.sql Backup the old adm_olap folder (includes the sync.properties and oracle.properties files, and contains  your configuration settings). Proceed with the installation instructions in “Installing and Configuring the External Database for  Oracle” on page 16.    Do not copy the new configuration files over the backed up configuration files. Use the backed  AUTION up configuration files only as a reference to manually update the new file. VMware, Inc.
  • Page 26 ADM Repository Reference Guide VMware, Inc.

  • Page 27: Adm Erd Schema

    “IP_Route” on page 33  “Java_EE” on page 34  “Network_Element” on page 34  “Network_Interface” on page 36  “Port” on page 36  “Property” on page 37  “Service” on page 37  “Storage_Device” on page 38  “Switch_Address_Forwarding” on page 38  “Time Dimension” on page 39  “Usage Metric” on page 39  “Usage_Metric_Baseline” on page 40  “Virtual_System_Settings” on page 40 VMware, Inc.

  • Page 28: Overview Of External Database Tables

    ADM Repository Reference Guide Overview of External Database Tables This chapter provides information about the external database tables.  Database Structure and Dependencies Figure 4‐1 illustrates the structure and dependencies of the ADM external database. Arrow heads are used to  identify the table keys. It is important to note that some of the commonly accessed data is duplicated in many tables to avoid  unnecessary joins.  For display purposes, some data is aggregated to a comma‐separated list. For example:   hostnames – a flat list of one or more host names.   host_ips – a flat list of all IPs of a host.   groups – a flat list of groups the entity belongs to.   A single relation called entity_id (in group membership, usage metric, etc.) could be joined with all three  “entity” tables (network_element, service, and dependency) although it is not shown in the ERD as a  foreign key.  VMware, Inc.
  • Page 29 Chapter 4 ADM ERD Schema Figure 4-1. External Database Structure and Dependencies VMware, Inc.

  • Page 30: Address

    Time of change CHANGE_TYPE VARCHAR2(10) Type of change (added, modified, removed) PATH VARCHAR(22048) “Path” of changed data from the containing  entity DISPLAY_NAME VARCHAR2(255) Name of the data property changed OLD_VALUE VARCHAR2(1024) Old value NEW_VALUE VARCHAR2(1024) New value Where: ID is a Primary key ENTITY_ID is a Foreign key This table contains the processor information of a network element. The information is identical to what is in  the network element table unless the machine has multi‐processor types (more than one different architecture  on the same machine). Table 4‐3 lists the contents of the CPU table. Table 4-3. CPU Table Name Datatype Description NUMBER Unique Identifier NE_ID NUMBER Network Element Identifier MODEL VARCHAR2 VMware, Inc.

  • Page 31: Database

    VARCHAR2(256) Database instance IS_AUTO_START VARCHAR2(1) Autostart flag (Y/N) Where: ID is a Primary key NE_ID and SERVICE_ID are Foreign keys Dependency This table represents the relationship between a source host/service and target host/service (capturing  topology). Table 4‐5 lists the contents of the Dependency table. Table 4-5. Dependency Table Name Datatype Description NUMBER(19) Unique identifier DEPENDENCY_TYPE VARCHAR2(100) Network Connection, Documented Dependency PROTOCOL VARCHAR2(1024) Network connection protocol (HTTP, FTP, etc.) PROTOCOL_VERSION VARCHAR2(1024) Protocol version TRANSPORT_PROTOCOL VARCHAR2(100) Transport protocol (TCP, UDP) VARCHAR2(512) Documented Dependency URL DOC_DEP_TYPE VARCHAR2(256) Type of the documented dependency VMware, Inc.

  • Page 32: Group_Membership

    TRG_SERVICE_ID NUMBER(19) Target service TRG_MODULE_ID NUMBER(19) Target module (java_ee, database) usually of a  documented dependency GROUPS VARCHAR2(4000) DISCOVERY_TIME TIMESTAMP KNOWLEDGE_LEVEL NUMBER(10) Where: ID is a Primary key SRC_NE_ID is a Foreign key (network_element (id) ) SRC_SERVICE_ID is a Foreign key (service (id)) SRC_MODULE_ID is a Foreign key (java_ee, database (id)) Group_Membership ADM Groups contain entities as members. This table marks an entity (network element, service, dependency)  as a member of a group. Table 4‐6 lists the contents of the Group_Membership table. Table 4-6. Group_Membership Table Name Datatype Description NUMBER(19) Group identifier (unique to groups, not  to entity memberships) GROUP_TYPE VARCHAR2(255) Group type GROUP_NAME VARCHAR2(255) Group name VMware, Inc.

  • Page 33: Installed_Software

    VARCHAR2(256) VENDOR VARCHAR2(256) INSTALL_PATH VARCHAR2(1024) SHARED_INSTALL_PATH VARCHAR2(1024) INSTALL_DATE TIMESTAMP TYPE VARCHAR2(256) Type of software (application, driver,  patch) Where: ID is a Primary key NE_ID is a Foreign key IP_Route This table contains IP (layer 3) routing information of a network element. Table 4‐8 lists the contents of the  IP_Route table. Table 4-8. IP_Route Table Name Datatype Description NUMBER(19) Unique Identifier NE_ID NUMBER(19) Network Element NIC_ID NUMBER(19) Network Interface  DEST_IP VARCHAR2(100) Destination IP VMware, Inc.

  • Page 34: Java_Ee

    APP_PATH VARCHAR2(1024) Application path MODULE_NAME VARCHAR2(256) JEE module name MODULE_TYPE VARCHAR2(256) JEE module type (jar, war, ear, etc) MODULE_DEPLOYMENT_DESC VARCHAR2(256) Deployment descriptor MODULE_CONTEXT_ROOT VARCHAR2(256) Context root (war only) Where: ID is a Primary key NE_ID and SERVICE_ID are Foreign key Network_Element This table contains computer system information, that could be any combination of host, router, and switch.  Table 4‐10 lists the contents of the Network_Element table. Table 4-10. Network_Element Table Name Datatype Description NUMBER(19) Unique identifier PRIMARY_HOSTNAME VARCHAR2(1024) Primary (single) hostname PRIMARY_HOST_IP VARCHAR2(100) Primary (single) IP address in dot notation string  (192.168.2.5). VMware, Inc.
  • Page 35 OS_SWAP_MEMORY NUMBER(19) Swap memory size used by the OS (in Byte) OS_PHYS_MEMORY NUMBER(19) Physical memory size as seen by the OS (in Byte) OS_REGISTRATION_KEY VARCHAR2(256) Operating system registration key OS_SERIAL_NUMBER VARCHAR2(256) Operating system serial number CPU_MODEL VARCHAR2(256) Processor model CPU_VENDOR VARCHAR2(256) Processor vendor CPU_FAMILY VARCHAR2(256) Processor family CPU_CLOCK_SPEED_HZ NUMBER(19) Processor maximum speed (Hz) CPU_CACHE_SIZE NUMBER(19) Processor cache size (Byte) CPU_STEPPING VARCHAR2(256) Processor stepping CPU_DESCRIPTION VARCHAR2(256) Processor description CPU_COUNT NUMBER(10) Processor count as seen by the OS (multi‐core  CPU is usually seen by the OS as several separate  CPUs) VMware, Inc.

  • Page 36: Network_Interface

    VARCHAR2(256) Switch port label MODULE_LABEL VARCHAR2(256) Switch module label V_LAN NUMBER(10) Where: ID is a Primary key NE_ID is a Foreign key SPEED_BIT_PS was speed_mb in version 5.3 Port This table represents a logical network port to which a Service binds to (e.g., HTTP Server binds to port 80).  Table 4‐12 lists the contents of the Port table. Table 4-12. Port Table Name Datatype Description NUMBER(19) Unique Identifier NE_ID NUMBER(19) Network element SERVICE_ID NUMBER(19) Service VARCHAR2(100) IP Address PORT NUMBER(5) Port number TRANSPORT_PROTOCOL VARCHAR2(100) TCP/UDP VMware, Inc.

  • Page 37: Property

    PRIMARY_HOST_IP VARCHAR2(100) Primary IP address of the containing host (see  network element). HOSTNAMES VARCHAR2(4000) Host names list of the containing host (see  network element). HOST_IPS VARCHAR2(4000) IP list of the containing host (see network  element). PORTS VARCHAR2(4000) Ports which the service is consumed by GROUPS VARCHAR2(4000) Comma‐separated list of all groups the element  belongs to. DISCOVERY_TIME TIMESTAMP Time the element was first introduced to the  system. VENDOR VARCHAR2(1024) Vendor of the service. VERSION VARCHAR2(1024) Version of the service. CATEGORY VARCHAR2(100) Category of the service. TIER VARCHAR2(100) Tier of the service. INSTALL_PATH VARCHAR2(512) Installation path. VMware, Inc.

  • Page 38: Storage_Device

    VARCHAR2(256) CAPACITY NUMBER(19) Size In bytes FILE_SYSTEM VARCHAR2(256) MOUNT_DESTINATION VARCHAR2(256) MOUNT_POINT VARCHAR2(256) Where: ID is a Primary key NE_ID is a Foreign key Switch_Address_Forwarding This table contains address forwarding information of a switch (layer 2). Table 4‐16 lists the contents of the  Switch_Address_Forwarding table. Table 4-16. Switch_Address_Forwarding Table Name Datatype Description NUMBER(19) Unique Identifier NE_ID NUMBER(19) Origin Network element NIC_ID NUMBER(19) Origin network interface MODULE VARCHAR2(256) Switch module PORT VARCHAR2(256) Switch port VMware, Inc.

  • Page 39: Time Dimension

    NUMBER(10) 1‐52 HOUR NUMBER(10) 0‐23 Where: TIME_ID is a Primary key Usage Metric This table is a multi‐dimensional OLAP fact table for capturing the demand of Dependency, Service, and  Network Element. The granularity of the data is of a single hour. Together with the time dimension and the  related entities, it is sliced and diced as needed. Table 4‐18 lists the contents of the Usage metric table. Table 4-18. Usage Metric Table Name Datatype Description ENTITY_ID NUMBER(19) The entity of the usage metric. The data contains  foreign keys to all entity types: network_element,  service, and dependency. TIME_ID NUMBER(19) The time dimension id: numeric value but human  readable: yyyymmddhh. BASELINE_TIME_ID NUMBER(19) Baseline time id contains the hour part of the time_id  (baseline is for 24 hours).  VALUE NUMBER(19) The number of network transactions in the given time  (hour granularity). VMware, Inc.

  • Page 40: Usage_Metric_Baseline

    VARCHAR2(256) Unique id of the virtual host. STATE VARCHAR2(256) State of the virtual host. VM_NAME VARCHAR2(256) Name of the virtual host. OS_FAMILY VARCHAR2(256) OS family of the virtual host. OS_NAME VARCHAR2(256) OS name of the virtual host. OS_TYPE VARCHAR2(256) OS type of the virtual host. TOOLS_STATUS VARCHAR2(256) VM tools status. TOOLS_VERSION VARCHAR2(256) VM tools version. TOTAL_MEM_SIZE NUMBER(19) Total memory size of the virtual host. VARCHAR2(1024) List of IPs that reside on the virtual host. MACS VARCHAR2(4000) List of MACs that reside on the virtual host. VIRTUAL_NE_ID  NUMBER(19) Network element id of the virtual host connected on  the other side. Where: ID is a Primary key CONTAINER_ID and VIRTUAL_NE_ID are Foreign keys (network_element) VMware, Inc.

  • Page 41: Adm Custom Reports

    = metric.entity_id where metric.time_id between 2006102916 and 2007101317 and service.name is not null group by service.name, service.version, service.vendor, service.category, service.primary_hostname, primary_host_ip where rownum <= 10 VMware, Inc.

  • Page 42: Application Dependency

    1 as degree, grp.group_name, service.name, service.version, service.vendor, service.category, service.primary_host_ip, service.primary_hostname, service.discovery_time from dependency dep inner join group_membership grp on grp.entity_id = dep.id inner join service service on service.id =dep.trg_service_id where service.name is not null and grp.group_name = '111' VMware, Inc.

Table of Contents