INSTALL

The CMDB API is written as a mod_perl app to be run in apache.

PREREQUISTES The following software is required to be installed prior to attempting to run the CMDB:

optconfig: https://github.com/proofpoint/optconfig

and any perl modules: Apache2::Request (libapreq2) Apache2::RequestRec Log::Log4perl JSON XML::Parser XML::Simple Date::Manip Apache::DBI DBI (and appropriate supporting DBD module. CMDB has primarily been developed and tested against mysql)

INSTALL

• Unpack the distribution into the directory you would like. The apache config will define the API paths, so it is not recommended to put this into your web file tree.

• Load the initial DB schema (currently tested only against mysql)

• file initial_schema.sql

• Copy the apache config file cmdb_api_httpd.conf into place: Debian,Ubuntu,OSX: /etc/apache2/other/, Redhat,CentOS: /etc/httpd/conf.d/

• adjust the apache config file cmdb_api_httpd.conf to match your system. This may include the following:

  • auth config: the CMDB relies on httpd to manage the user auth for authentication
• • • install file paths: the default assumed file path for the cmdb api is /var/www/cmdb_api/
• • • module paths: the mod_perl module and libapreq2 (Apache2::Request) apache modules should point to the correct location

• Copy the htpasswd file into /etc. The location and usage of this file can be changed by adjusting the cmdb_api_httpd.conf appropriately.

• Restart apache

• test by loading: http://yourserver/cmdb_api/v1/?lexicon=1