===========================
This Python software was written to give a better report function to OCS Inventory NG: http://www.ocsinventory-ng.org/en/
It is a web application that read a OCS Database and export data in a fancy and customizable HTML and PDF reports.
## PrerequisitesAt the actual revision D.A.C. working on a machine with this requisites:
- Centos as OS Distribution (I've tested on 5.X and 6.X)
- Python 2.6
- MySQL DB installed from Centos Repos
- OCS Inventory NG v.2.0
In the next releases I test even Debian and Ubuntu OS
There are some softwares dependencies that DAC requires to work and you can install with launching setup routines. Read the above Warning about dependencies that setup try to install and workaround to bypass overwriting of your installed version of these softwares.
❗ setup_check.py TRY TO INSTALL THE FOLLOWING DEPENDECIES: - wget - python-setuptools - make - gcc - MySQL-python - libxslt - python-devel - pyOpenSSL
If you have special customization of this softwares you can exclude from installation some packages changing following line:
package = ["wget", "python-setuptools", "make", "gcc", "MySQL-python", "libxslt", "python-devel","pyOpenSSL"]
In the next release I planning to implement launching switch to bypass part of installation routine (redis or wkhtml or some packages too) to save personal configuration of installed software.
The setup_check.py also try to install this python modules trough easy_install software: - cherrypy - simplejson - pyyaml - python-crontab - redis
After this installation the software prompt you to write the following informations: - OCS absolute installation path - IP on which application listen to (0.0.0.0 for all ip) - Port on which application listen to - SSL Cert Path absolute path(blank if you want disable SSL) - SSL Cert Key absolute path(blank if you want disable SSL)
The first step to create directory in which you want put your installation of DAC. After you have created the directory, you enter in it and clone the repository:
git clone https://github.com/stanzinofree/Digital_Archive_Creator
After you have cloned source you can launch the setup with the command:
python setup_check.py
This launch the setup procedure that check your system for DAC dependencies and if did not found them it provide to install it.
## Additional Configuration - [Config](#config) - [Cronetab](#cronetab) - [Scheda](#scheda) ### Config In file config.yaml there are some voices to configure, usually if you run setup good you don't have to touch it, if you don't want edit manually you can launch from DAC folder:python libs/setup_config.py
If you want edit manually this is the voices in files:
- Path:
- root_folder : This is the absolute path of DAC folder, root of the software
- Server:
- server : web address on which ocs respond
- conf_file : is the absolute path of dbconfig.inc.php file that is the configuration file of ocs
- Server_Config:
- ip : ip on which web application listen for connection (ip of server or 0.0.0.0)
- port : port on which web application listen for connection (if you have iptables turned on you must add an entry for this port)
- ssl : in this release this field is unused
- ssl_cert_path : if you want ssl you must insert the absolute path of certification in form of file.crt
- ssl_key_path : if you want ssl you must insert the absolute path of key file in form of file.key
- Administrators:
- user : this field contain the username of ocs users that you want promoted administrators of DAC, the form is ["user1", "user2"]
- PID:
- file : This is the pid file (inside DAC) in which DAC save his state
v 1.0
- Release software
Thanks to the author of the module I use in my software and the author of templates
- HTML Kickstart Template
- Redis
- Redis-py
- PyYAML
- Cherrypy
- Unutbu from stackoverflow for this solution on colored term