⚠️ Deprecation & Archiving Notice ⚠️

Thank you for your support and contributions to Apache-Provider.

This repository is now deprecated and will be archived soon.

No further development, maintenance, or updates will be provided.
Bug fixes, security patches, and feature enhancements are no longer planned.
After archiving, this repository will remain available in read-only mode for reference.

For any questions, please refer to the existing documentation or community discussions.

Apache-Provider

The Apache-Provider project implements a CIMOM provider, based on OMI, to return logging and statistical information for Apache. Apache is an open-source HTTP server created by the Apache Software Foundation. The Apache-Provider runs on Linux systems as far back as RedHat 5.0, SuSE 10.1, and Debian 5.0.

The Apache-Provider project implements two independent components:

An Apache module to collect statistical information from the HTTPD server and make it available to the OMI provider, and
An OMI provider to report Apache information via OMI

The Apache-Provider provides the following classes:

Apache_HTTPDServer
Apache_HTTPDServerStatistics
Apache_HTTPDVirtualHostCertificate
Apache_HTTPDVirtualHost
Apache_HTTPDVirtualHostStatistics

The following output shows the results of enumeration of classes:

Enumeration of Apache_HTTPDServer

> /opt/omi/bin/omicli ei root/apache Apache_HTTPDServer
instance of Apache_HTTPDServer
{
    InstanceID=/usr/local/apache2/conf/httpd.conf
    [Key] ProductIdentifyingNumber=1
    [Key] ProductName=/usr/local/apache2/conf/httpd.conf
    [Key] ProductVendor=Apache Software Foundation
    [Key] ProductVersion=2.4.10
    [Key] SystemID=a24s64-cent7-01
    [Key] CollectionID=/usr/local/apache2
    ModuleVersion=1.0.1-7 (20160513)
    ConfigurationFile=/usr/local/apache2/conf/httpd.conf
    InstalledModules={mod_cimprov.c, mod_alias.c, mod_dir.c, mod_autoindex.c, mod_status.c, mod_unixd.c, mod_ssl.c, mod_version.c, mod_setenvif.c, mod_headers.c, mod_env.c, mod_log_config.c, mod_mime.c, mod_filter.c, mod_reqtimeout.c, mod_socache_shmcb.c, mod_auth_basic.c, mod_access_compat.c, mod_authz_core.c, mod_authz_user.c, mod_authz_groupfile.c, mod_authz_host.c, mod_authn_core.c, mod_authn_file.c, worker.c, http_core.c, mod_so.c, core.c}
    InstalledModulesFormatted=mod_cimprov.c, mod_alias.c, mod_dir.c, mod_autoindex.c, mod_status.c, mod_unixd.c, mod_ssl.c, mod_version.c, mod_setenvif.c, mod_headers.c, mod_env.c, mod_log_config.c, mod_mime.c, mod_filter.c, mod_reqtimeout.c, mod_socache_shmcb.c, mod_auth_basic.c, mod_access_compat.c, mod_authz_core.c, mod_authz_user.c, mod_authz_groupfile.c, mod_authz_host.c, mod_authn_core.c, mod_authn_file.c, worker.c, http_core.c, mod_so.c, core.c
    ProcessName=httpd
    ServiceName=_Unknown
    OperatingStatus=OK
}

Note that properties InstalledModules and InstalledModulesFormatted are virtually identical. InstalledModules is an array of strings, which is a data type natively supported by OMI. Some software may have difficulty consuming such a data structure, however. As a result, the same data is available in InstalledModulesFormatted, which is formatted as a comma-separated string.

Due to this formatting, module names with embedded commas may be difficult to properly differentiate.

Enumeration of Apache_HTTPDServerStatistics

> /opt/omi/bin/omicli ei root/apache Apache_HTTPDServerStatistics
instance of Apache_HTTPDServerStatistics
{
    [Key] InstanceID=/usr/local/apache2/conf/httpd.conf
    TotalPctCPU=0
    IdleWorkers=99
    BusyWorkers=1
    PctBusyWorkers=1
    ConfigurationFile=/usr/local/apache2/conf/httpd.conf
}

Enumeration of Apache_HTTPDVirtualHostCertificate

> /opt/omi/bin/omicli ei root/apache Apache_HTTPDVirtualHostCertificate
instance of Apache_HTTPDVirtualHostCertificate
{
    InstanceID=server.crt*9ef7437d
    [Key] Name=server.crt*9ef7437d
    [Key] Version=1.0.1e-fips
    [Key] SoftwareElementState=3
    [Key] SoftwareElementID=server.crt*9ef7437d
    [Key] TargetOperatingSystem=36
    VirtualHost=a24s64-cent7-01,_default_:443,_default_:443
    ExpirationDate=20171004135953.000000+000
    DaysUntilExpiration=365
    FileName=/etc/ssl/crt/server.crt
}

Enumeration of Apache_HTTPDVirtualHost

> /opt/omi/bin/omicli ei root/apache Apache_HTTPDVirtualHost
instance of Apache_HTTPDVirtualHost
{
    InstanceID=a24s64-cent7-01,_default_:0
    [Key] Name=a24s64-cent7-01,_default_:0
    [Key] Version=2.4.10
    [Key] SoftwareElementState=3
    [Key] SoftwareElementID=a24s64-cent7-01,_default_:0
    [Key] TargetOperatingSystem=36
    IPAddresses={_default_}
    IPAddressesFormatted=_default_
    Ports={0}
    PortsFormatted=0
    ServerName=a24s64-cent7-01
    ServerAlias={}
    ServerAliasFormatted=
    DocumentRoot=/usr/local/apache2/htdocs
    ServerAdmin=root@localhost
    ErrorLog=logs/error_log
    CustomLog=logs/access_log
    AccessLog=
}
instance of Apache_HTTPDVirtualHost
{
    InstanceID=a24s64-cent7-01,_default_:443,_default_:443
    [Key] Name=a24s64-cent7-01,_default_:443,_default_:443
    [Key] Version=2.4.10
    [Key] SoftwareElementState=3
    [Key] SoftwareElementID=a24s64-cent7-01,_default_:443,_default_:443
    [Key] TargetOperatingSystem=36
    IPAddresses={_default_, _default_}
    IPAddressesFormatted=_default_, _default_
    Ports={443, 443}
    PortsFormatted=443, 443
    ServerName=a24s64-cent7-01
    ServerAlias={}
    ServerAliasFormatted=
    DocumentRoot=/usr/local/apache2/htdocs
    ServerAdmin=root@localhost
    ErrorLog=/usr/local/apache2/logs/error_log
    CustomLog=/usr/local/apache2/logs/ssl_request_log
    AccessLog=/usr/local/apache2/logs/access_log
}

Enumeration of Apache_HTTPDVirtualHostStatistics

> /opt/omi/bin/omicli ei root/apache Apache_HTTPDVirtualHostStatistics
instance of Apache_HTTPDVirtualHostStatistics
{
    [Key] InstanceID=a24s64-cent7-01,_default_:0
    ServerName=a24s64-cent7-01
    RequestsTotal=1527
    RequestsTotalBytes=745924849
    RequestsPerSecond=0
    KBPerRequest=30751
    KBPerSecond=4100
    ErrorCount400=0
    ErrorCount500=0
    ErrorsPerMinute400=0
    ErrorsPerMinute500=0
}
instance of Apache_HTTPDVirtualHostStatistics
{
    [Key] InstanceID=a24s64-cent7-01,_default_:443,_default_:443
    ServerName=a24s64-cent7-01
    RequestsTotal=1450
    RequestsTotalBytes=2679151627
    RequestsPerSecond=0
    KBPerRequest=30751
    KBPerSecond=4100
    ErrorCount400=0
    ErrorCount500=0
    ErrorsPerMinute400=0
    ErrorsPerMinute500=0
}
instance of Apache_HTTPDVirtualHostStatistics
{
    [Key] InstanceID=_Total
    ServerName=_Total
    RequestsTotal=2977
    RequestsTotalBytes=3425076476
    RequestsPerSecond=0
    KBPerRequest=30751
    KBPerSecond=8200
    ErrorCount400=0
    ErrorCount500=0
    ErrorsPerMinute400=0
    ErrorsPerMinute500=0
}

Code of Conduct

This project has adopted the [Microsoft Open Source Code of Conduct] (https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ] (https://opensource.microsoft.com/codeofconduct/faq/) or contact opencode@microsoft.com with any additional questions or comments.