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

VMware VCENTER APPLICATION DISCOVERY MANAGER 6.1.1 - RESPOSITORY Reference Manual

Hide thumbs Also See for VCENTER APPLICATION DISCOVERY MANAGER 6.1.1 - RESPOSITORY:
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.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-01

Advertisement

Table of Contents
loading

Related Manuals for VMware VCENTER APPLICATION DISCOVERY MANAGER 6.1.1 - RESPOSITORY

Summary of Contents for VMware VCENTER APPLICATION DISCOVERY MANAGER 6.1.1 - RESPOSITORY

  • Page 1 Application Discovery Manager 6.1.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-01...
  • 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 23 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 29 Change_Log 29 CPU 29 Database 30 Dependency 30 Group_Membership 31 Installed_Software 32 IP_Route 32 Java_EE 33 Network_Element 33 Network_Interface 34 VMware, Inc.
  • Page 4 ADM Repository Reference Guide Port 35 Property 35 Service 36 Storage_Device 36 Switch_Address_Forwarding 37 Time 37 Usage_Metric 38 Usage_Metric_Baseline 38 Virtual_System_Settings 38 ADM Custom Reports 41 Creating Custom Reports 41 Host Inventory 41 Connection Inventory 41 Most Used Services 41 Application Dependency 42 Index 43 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

    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. 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.  VMware, Inc.
  • Page 9 Chapter 1 Introduction 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

     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.    Status of the synchronization process is one of the following:  Idle: The process is idle. Nothing is currently running.  Sync in progress: The ADM synchronization process is in progress.  Complete: The ADM synchronization is complete and the FTP files are loaded to the FTP Server.   Scheduled Synchronization Status: the status of the synchronization schedule.    Status of the synchronization schedule 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

    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)  Perl with the Archive::Zip module: 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 v.X.X-XXX Copy the ADM external database installation file (adm_olap_ .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  provided in unzip_path/adm_olap/load/: Make a copy of the oracle.properties.example file and name it oracle.properties: cp oracle.properties.example oracle.properties If you had defined a custom adm_olap user name and password when you had created the database  user as described in “Create the External Reporting Database User” on page 17, then change the user  name and password credentials accordingly: VMware, Inc.
  • Page 19    For secure FTP, use the sync_adm_olap_sftp_oracle.pl script instead of  sync_adm_olap.pl Schedule the synchronization process on Linux. Log in as a user with oracle permissions and enter: crontab -e Verify the following information. It has to be part of the crontab for it to run properly: PATH=... <oracle home full path/bin> ORACLE_SID=<> ORACLE_HOME=<> <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

    Change directories to unzip_path/adm_olap/schema/sqlserver/: cd <path>\adm_olap\schema\sqlserver Run the create_database.sql script to create the ADM external database: sqlcmd -S <serverName> -i create_database.sql Run the create_olap_schema.sql script to create the adm_olap schema: sqlcmd -S <serverName> -i create_olap_schema.sql Run the create_adm_olap_login.sql script to create the login: sqlcmd -S <serverName> -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: sqlcmd -S <serverName> -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. You can add the hooks if necessary. 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 Load the time data. The current adm_olap schema has a time dimension table that is static. Fill the time table once and leave  it unchanged thereafter. To have the loader load the time data upon initiation: Unzip the static_data/time.csv.zip file into the unzip_path/adm_olap/data directory. The time.csv data is loaded the next time the synchronization process runs. Test your configuration: Run a complete synchronization from the ADM Console as described in “Running the  Synchronization Process Now” on page 13. After the upload completes, log in as a user with administrator permissions, on the system on which  the database is installed. From the Windows Start menu, select Run and type cmd. The command prompt appears. Change directories to unzip_path\adm_olap\and run the synchronization process: cd <unzip_path>\adm_olap\ <perl_dir>\bin\perl.exe <install_dir>\adm_olap\sync_adm_olap.pl    For secure FTP, use the sync_adm_olap_sftp_sqlserver.pl script instead of  sync_adm_olap.pl To avoid id key verification for the first time by creating the id key, run psftp manually against the  FTP server using command line psftp -pw password user@host. 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. Select how often you want to run the task from the options and click Next. Depending on the interval selected, define the time, days, and the date to start the task. VMware, Inc.

  • Page 23: Manually Loading Data To The External Database

    ./load_oracle.pl To load the zip files manually for MS SQL Server From Windows Explorer, copy the adm_olap_ v.X.X-XXX .zip file to unzip_path\adm_olap\data\  folder. v.X.X-XXX Right‐click the adm_olap_ .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: cd <unzip_path>\adm_olap\load\ load_sqlserver.pl Checking the Status of the External Database Load Process Use the following log files to check the status of the load process to the external database:  For Oracle, check: /unzip_path/adm_olap/load/oracle/log  For MS.SQL, check: unzip_path\adm_olap\load\sqlserver\log VMware, Inc.

  • Page 24: Upgrading The External Database

    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). Proceed with the installation instructions in “Installing and Configuring the External Database for MS  SQL” on page 20.    Do not copy the new configuration files over the backed up configuration files. Use the backed up  AUTION configuration files only as a reference to manually update the new file. 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.    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 up  AUTION 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 32  “Java_EE” on page 33  “Network_Element” on page 33  “Network_Interface” on page 34  “Port” on page 35  “Property” on page 35  “Service” on page 36  “Storage_Device” on page 36  “Switch_Address_Forwarding” on page 37  “Time” on page 37  “Usage_Metric” on page 38  “Usage_Metric_Baseline” on page 38  “Virtual_System_Settings” on page 38 VMware, Inc.

  • Page 28: Overview Of External Database Tables

    VARCHAR2(256) MONTH_NAME VARCHAR2(50) VERSION VARCHAR2(256) DAY_OF_MONTH NUMBER(10) RELEASE VARCHAR2(256) DAY_OF_WEEK NUMBER(10) VENDOR VARCHAR2(256) DAY_OF_WEEK_NAME VARCHAR2(50) INSTALL_PATH VARCHAR2(1024) WEEK_OF_YEAR NUMBER(10) SHARED_INSTALL_PATH VARCHAR2(1024) HOUR NUMBER(10) INSTALL_DATE TIMESTAMP(6) TYPE VARCHAR2(256)    Some of the commonly accessed data is duplicated in many tables to avoid redundant joins. You can join the relation ENTITY_ID (in Group_Membership table, Usage_Metric table, and so on) with  Network_Element table, Service table, and Dependency table although it is not shown in the ERD as a foreign  key. For display purpose, 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. VMware, Inc.

  • Page 29: Address

    New value CPU table contains the processor information for a network element. The information is identical to the  information in the network element table unless the machine has multiple types of processors. Table 4‐3 lists  the contents of the CPU table. Table 4-3. CPU Table Name Datatype Description  for each record of the CPU  NUMBER(19) Unique identifier table (primary key)  (foreign key) NE_ID NUMBER(19) Network element identifier MODEL VARCHAR2(256) Processor model VENDOR VARCHAR2(256) Processor vendor FAMILY VARCHAR2(256) Processor family CLOCK_SPEED_HZ NUMBER(19) Max clock speed in Hertz CACHE_SIZE NUMBER(19) Cache size in Bytes STEPPING VARCHAR2(256) Processor version VMware, Inc.

  • Page 30: Database

    PROTOCOL VARCHAR2(1024) Network connection protocol (for example, HTTP,  FTP, and so on) PROTOCOL_VERSION VARCHAR2(1024) Version of the protocol TRANSPORT_PROTOCOL VARCHAR2(100) Transport protocol (values: TCP or UDP) VARCHAR2(512) Documented dependency URL DOC_DEP_TYPE VARCHAR2(256) Type of the documented dependency SRC_IP VARCHAR2(100) Source IP address of the dependency SRC_PORT NUMBER(19) Source port of the dependency SRC_SERVICE_NAME VARCHAR2(1024) Source service name SRC_PRIMARY_HOSTNAME VARCHAR2(1024) Source primary host name (see Network Element  table) SRC_PRIMARY_HOST_IP VARCHAR2(100) Source primary IP address (see Network Element  table) SRC_HOSTNAMES VARCHAR2(4000) Source host names (see Network Element table) SRC_HOST_IPS VARCHAR2(4000) Source IP addresses (see Network Element table) VMware, Inc.

  • Page 31: Group_Membership

    4‐6 lists the contents of the Group_Membership  table. Table 4-6. Group_Membership Table Name Datatype Description NUMBER(19) Group identifier is unique to groups but not  to entity memberships (primary key) GROUP_TYPE VARCHAR2(255) Group type GROUP_NAME VARCHAR2(255) Group name GROUP_DESCRIPTION VARCHAR2(1024) Group description GROUP_CREATION_TIME TIMESTAMP(6) Group creation time GROUP_CREATOR VARCHAR2(255) Group creator user name GROUP_MODIFICATION_TIME TIMESTAMP(6) Group last modification time GROUP_MODIFIER VARCHAR2(255) Group last modifier user name ENTITY_ID NUMBER(19) The data contains foreign key to entity types:  Network Element, Service, Dependency VMware, Inc.

  • Page 32: Installed_Software

    Table 4-8. IP_Route Table Name Datatype Description NUMBER(19) Unique identifier for each record of the  IP_Route table (primary key)  (foreign key) NE_ID NUMBER(19) Network element identifier  (foreign key) NIC_ID NUMBER(19) Network interface identifier DEST_IP VARCHAR2(100) Destination IP address DEST_MASK VARCHAR2(100) Destination subnet mask GATEWAY VARCHAR2(100) Gateway IP address METRIC NUMBER(10) Priority value IS_LOCAL VARCHAR2(1) Flag identifying the IP address as local (values: Y or N)   GATEWAY_NE_ID NUMBER(19) Gateway network element identifier (foreign key) VMware, Inc.

  • Page 33: Java_Ee

    Primary IP address of the host HOSTNAMES VARCHAR2(4000) Comma‐separated list of all host names HOST_IPS VARCHAR2(4000) Comma‐separated list of all IP addresses GROUPS VARCHAR2(4000) Comma‐separated list of all groups the network  element belongs to DISCOVERY_TIME TIMESTAMP(6) Time the network element was first added to the  system IS_HOST VARCHAR2(1) Flag identifying the network element as a host (values: Y or N) IS_ROUTER VARCHAR2(1) Flag identifying the network element as a router (values: Y or N) IS_SWITCH VARCHAR2(1) Flag identifying the network element as a switch (values: Y or N) IS_VIRT_CONTAINER VARCHAR2(1) Flag identifying the network element as virtual  container (values: Y or N) IS_VIRTUAL VARCHAR2(1) Flag identifying the network element as a virtual  machine (values: Y or N) HW_SERIAL VARCHAR2(256) Serial number of the target host VMware, Inc.

  • Page 34: Network_Interface

    NUMBER(19) Processor cache size in Bytes CPU_STEPPING VARCHAR2(256) Processor version CPU_DESCRIPTION VARCHAR2(256) Processor description CPU_COUNT NUMBER(10) Processor count as detected by the operating  system (multi‐core CPU is usually detected by the  operating system as several separate CPUs) Network_Interface Network_Interface table contains network interface card or switch port information. Table 4‐11 lists the  contents of the Network_Interface table. Table 4-11. Network_Interface Table Name Datatype Description NUMBER(19) Unique identifier for each record of the  Network_Interface table (primary key)  (foreign key) NE_ID NUMBER(19) Network element identifier IS_LOCAL VARCHAR2(1) Flag identifying the IP address assigned to the  NIC as local (values: Y or N) MAC_ADDRESS VARCHAR2(256) MAC address of the NIC VMware, Inc.

  • Page 35: Port

    NUMBER(19) Network element identifier  (foreign key) SERVICE_ID NUMBER(19) Service identifier VARCHAR2(100) IP address PORT NUMBER(5) Port number TRANSPORT_PROTOCOL VARCHAR2(100) Transport protocol (values: TCP or UDP) Property Property table contains general purpose properties (name‐value pairs), such as URLs on HTTP servers and  tables on database‐related dependencies. Table 4‐13 lists the contents of the Property table. Table 4-13. Property Table Name Datatype Description NUMBER(19) Unique identifier for each record of the  Property table (primary key) ENTITY_ID NUMBER(19) The data contains foreign key to entity types:  Network Element, Service, Dependency NAME VARCHAR2(256) Property name VALUE VARCHAR2(1028) Property value VMware, Inc.

  • Page 36: Service

    SHARED_INSTALL_PATH VARCHAR2(512) Shared installation path IS_UNIDENTIFIED VARCHAR2(1) Flag indicating the service as unidentified service  (values: Y or N) IS_CLIENT VARCHAR2(1) Flag identifying the service as client service (values: Y or N) KNOWLEDGE_LEVEL NUMBER(10) Indicates the level of knowledge of the service. A  value of zero indicates speculative information  only (used to filter out speculative information) Storage_Device Storage_Device table represents network element storage device. It contains both logical drives (such as  partitions) and physical drives. Table 4‐15 lists the contents of the Storage_Device table. Table 4-15. Storage_Device Table Name Datatype Description NUMBER(19) Unique identifier for each record of the  Storage_Device table (primary key)  (foreign key) NE_ID NUMBER(19) Network element identifier IS_LOGICAL VARCHAR2(1) Flag identifying the volume as logical volume (values: Y or N) VMware, Inc.

  • Page 37: Switch_Address_Forwarding

    Table 4-17. Time Table Name Datatype Description TIME_ID NUMBER(19) Human readable number: YYYYMMDDHH  (primary key) YEAR NUMBER(10) Year (YYYY) QUARTER NUMBER(10) Quarter (1‐4) QUARTER_NAME VARCHAR2(50) Quarter name (Q1‐2008) MONTH NUMBER(10) Month number (1‐12) MONTH_NAME VARCHAR2(50) Month name (January‐December) DAY_OF_MONTH NUMBER(10) Day of the month (1‐31) DAY_OF_WEEK NUMBER(10) Day of the week (1‐7) DAY_OF_WEEK_NAME VARCHAR2(50) Day (Sunday‐Saturday) WEEK_OF_YEAR NUMBER(10) Week of the year (1‐52) HOUR NUMBER(10) Hour of the day (0‐23) VMware, Inc.

  • Page 38: Usage_Metric

    Datatype Description ID  NUMBER(19) Unique identifier for each record of the  Virtual_System_Settings table (primary key) CONTAINER_ID  NUMBER(19) Network element identifier on which the current   (foreign key) virtual system settings reside UUID VARCHAR2(256) Unique identifier 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) Operating system family of the virtual host OS_NAME VARCHAR2(256) Operating system name of the virtual host OS_TYPE VARCHAR2(256) Operating system type of the virtual host TOOLS_STATUS VARCHAR2(256) VMware tools status TOOLS_VERSION VARCHAR2(256) VMware tools version TOTAL_MEM_SIZE NUMBER(19) Total memory of the virtual host VMware, Inc.
  • Page 39 Chapter 4 ADM ERD Schema Table 4-20. Virtual_System_Settings Table (Continued) Name Datatype Description VARCHAR2(1024) List of IP addresses that are available on the virtual  host MACS VARCHAR2(4000) List of MAC addresses that are available on the  virtual host VIRTUAL_NE_ID  NUMBER(19) Network element identifier of the virtual host   (foreign key) connected on the other side VMware, Inc.
  • Page 40 ADM Repository Reference Guide 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.

  • Page 43: Index

    15 installation 16 for MS SQL 20 for Oracle 16 loading data to the external database 23 MS SQL as the external database 16 Oracle as the external database 15 policy 8 primary key 29 report 8 VMware, Inc.
  • Page 44 ADM Repository Reference Guide VMware, Inc.

Table of Contents