Skip to content

An open source (GPL v3) Data Center Inventory Management (DCIM) application.

Notifications You must be signed in to change notification settings

opendcim/openDCIM

This branch is up to date with master.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

e74f879 · Oct 25, 2024
Mar 26, 2024
Sep 1, 2015
Feb 3, 2024
Oct 25, 2024
Sep 12, 2023
Aug 17, 2022
Nov 17, 2023
Mar 26, 2024
May 17, 2022
Feb 3, 2024
Aug 13, 2023
Aug 9, 2023
Oct 15, 2023
Sep 25, 2020
Dec 19, 2020
Jul 19, 2017
Mar 4, 2016
Feb 21, 2018
Jul 29, 2023
Jul 29, 2023
Jul 29, 2023
Jul 29, 2023
Jul 29, 2023
Mar 8, 2023
Mar 8, 2023
Mar 8, 2023
Mar 8, 2023
Aug 17, 2022
Nov 10, 2022
Aug 6, 2023
Feb 16, 2018
Dec 3, 2020
Aug 13, 2023
May 26, 2023
Sep 12, 2023
May 5, 2015
Mar 28, 2023
Jun 22, 2015
Jan 12, 2024
Aug 27, 2023
Aug 6, 2023
Dec 3, 2013
Oct 6, 2023
Sep 30, 2020
Sep 25, 2023
Oct 8, 2018
Mar 4, 2019
Aug 14, 2020
Dec 3, 2020
Jul 3, 2021
Apr 22, 2023
Jul 15, 2023
Aug 9, 2023
Oct 15, 2023
Jan 12, 2024
Apr 18, 2023
Jun 18, 2015
Sep 4, 2018
Aug 6, 2023
Aug 27, 2023
Nov 11, 2022
Aug 28, 2016
Jun 9, 2023
Nov 17, 2023
Nov 29, 2017
Oct 2, 2016
Mar 28, 2023
Aug 12, 2022
Jun 4, 2018
Aug 17, 2022
Dec 27, 2014
May 30, 2020
Oct 2, 2018
Aug 24, 2023
Jan 12, 2024
Feb 2, 2016
Apr 29, 2015
Nov 22, 2017
Nov 10, 2022
May 11, 2023
Sep 23, 2019
Jan 19, 2024
Jan 21, 2019
Jul 24, 2017
Mar 28, 2015
Nov 10, 2022
Oct 23, 2023
Nov 11, 2022
Aug 6, 2023
Aug 6, 2023
Aug 6, 2023
Aug 6, 2023
Aug 6, 2023
Sep 25, 2020
Jun 2, 2017
Jan 23, 2024
Sep 9, 2018
Aug 12, 2023
Jun 9, 2023
Jul 29, 2023
Dec 3, 2020
Jul 29, 2023
Jul 29, 2023
Aug 6, 2023
Sep 14, 2023
Aug 6, 2023
Aug 6, 2023
Aug 17, 2022
Aug 6, 2023
Aug 12, 2023
Aug 17, 2022
Sep 20, 2019
Apr 4, 2023
Aug 6, 2023
Aug 17, 2022
Aug 17, 2022
Aug 17, 2022
Aug 17, 2022
Mar 20, 2018
Feb 15, 2018
Sep 6, 2023
Feb 18, 2024
Aug 17, 2022
Aug 17, 2022
Apr 4, 2023
Jul 29, 2023
Jul 11, 2023
Feb 20, 2024
Jul 29, 2023
Nov 5, 2017
Jan 11, 2024
Aug 17, 2022
Aug 17, 2022
Aug 6, 2023
Jul 11, 2023
Aug 29, 2023
May 26, 2023
Jul 18, 2020
Nov 21, 2023
Aug 6, 2023
Aug 6, 2023
Oct 14, 2022
Nov 17, 2023
Feb 24, 2016
May 27, 2024
Aug 16, 2022
Nov 11, 2014
Nov 10, 2022
Oct 2, 2016
Nov 11, 2014
Jul 27, 2014
Apr 3, 2023
Oct 2, 2016
Apr 4, 2023
May 15, 2017
Oct 28, 2023
Jan 12, 2024
Jul 29, 2023
Nov 13, 2013
Jul 29, 2023
Oct 3, 2024
Jul 11, 2023

Repository files navigation

openDCIM

An Open Source Software package for managing the infrastructure of a 
data center, no matter how small or large.  Initially developed 
in-house at Vanderbilt University Information Technology Services by 
Scott Milliken.  

After leaving Vanderbilt for Oak Ridge National Laboratory, Vanderbilt 
granted permission for the package to be open sourced under GPLv3.  
Scott continues as the primary contributor to the package and is 
actively recruiting assistance from others.

    This program is free software:  you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published
    by the Free Software Foundation, version 3.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    For further details on the license, see http://www.gnu.org/licenses

THE CURRENT RELEASE IN GITHUB IS FOR DEVELOPMENT ONLY

Github issues are not for asking questions - use the mailing list for that.

Official Website

Installation

Supposing you are using apache, php and apache-php-module firstly clone openDCIM in a directory which is accessible by apache user (e.g. /srv/http/) and then configure apache to load required modules and have access to project directory (you can define virtual host too).

If you're gonna create Dockerized development environment, you should enable apache's fast-cgi to connect to php-fpm's container

Database (PDO, PDODRIVERS, DB.INC)

Install and Configure Mysql and PHP-Mysql

Follow the guide

Create Database and Configuration File

Create the database and user

	mysql -uroot -p -e "CREATE DATABASE dcim;CREATE USER 'dcim'@'localhost' IDENTIFIED BY 'dcim';GRANT ALL ON dcim.* TO 'dcim'@'localhost';"

Make db.inc.php from db.inc.php-dist

	cp db.inc.php-dist db.inc.php

PHP SNMP Module

Install php-snmp and enable it in /etc/php/php.ini by uncomment or adding the line containing: extension=snmp.so

Apache User Authentication (AUTHENTICATION, REMOTE USER)

Enbale below apache modules:

  • mod_authn_file.so
  • mod_authn_core.so
  • mod_authz_user.so
  • mod_authz_core.so
  • mod_auth_basic.so

Then follow this link To create apache authentication database (such as htpasswd) and enable apache auth in openDCIM directory (e.g. using .htaccess in root). As an example you can follow this instruction (Don't forget to change paths and names to correct onse):

sudo htpasswd -c /etc/httpd/users pouyan
echo 'AuthName "restricted stuff"\nAuthType Basic\nAuthUserFile /etc/httpd/users\nrequire valid-user' > /srv/http/openDCIM

Apache Rewrite (MOD_REWRITE)

Install Apache Rewrite Module and enable it

Run the application

Execute application by openning it in browser and do the installation

Contribution

Contributions are always welcome, please follow these steps to submit your changes:

  1. Install git from http://git-scm.com/

  2. Create a github account on https://github.com

  3. Set up your git ssh key using these instructions http://help.github.com/set-up-git-redirect

  4. Open the openDCIM project home page on github on https://github.com/samilliken/openDCIM/

  5. Click the "Fork" button, this will get you to a new page: your own copy of the code.

  6. Copy the SSH URL at the top of the page and clone the repository on your local machine

    git clone [email protected]:your-username/openDCIM.git my-opendcim-repo
  7. Create a branch and switch to it

    cd my-opendcim-repo
    git branch mynewfeature-patch
    git checkout mynewfeature-patch
  8. Apply your changes, then commit using a meaningful comment, that's the comment everybody will see!

    git add .
    git commit -m "Fixing issue 157, blablabla"
  9. Push the changes back to github (under a different branch, here myfeature-patch)

    git push origin mynewfeature-patch
  10. Open your forked repository on github at https://github.com/your-username/openDCIM

  11. Click "Switch Branches" and select your branch (mynewfeature-patch)

  12. Click "Pull Request"

  13. Submit your pull request to the openDCIM Developers

Translation - i18n

We do not accept any po files directly. Please use the very simple, user friendly web interface at POEditor.

https://poeditor.com/join/project?hash=zBX5TaqBhv