This repository has been archived on 2024-05-31. You can view files and clone it, but cannot push or open issues or pull requests.
devicehub-teal/README.md

78 lines
2.5 KiB
Markdown
Raw Normal View History

2018-06-10 17:58:27 +00:00
# Devicehub
Devicehub is an IT Asset Management System focused in reusing devices,
created under the project [eReuse.org](https://www.ereuse.org).
Our main objectives are:
- To offer a common IT Asset Management for donors, receivers and IT
professionals so they can manage devices and exchange them.
This is, reusing and ultimately recycling.
- To automatically recollect, analyse, process and share
(controlling privacy) metadata about devices with other tools of the
eReuse ecosystem to guarantee traceability, and to provide inputs for
the indicators which measure circularity.
- To highly integrate with existing IT Asset Management Systems.
- To be decentralized.
Devicehub is built with [Teal](https://github.com/bustawin/teal) and
[Flask](http://flask.pocoo.org).
2018-06-20 21:32:42 +00:00
## Installing
2018-06-10 17:58:27 +00:00
The requirements are:
- Python 3.5.3 or higher. In debian 9 is `# apt install python3-pip`.
- PostgreSQL 9.6 or higher. In debian 9 is `# apt install postgresql`
- passlib. In debian 9 is `# apt install python3-passlib`.
2018-06-10 17:58:27 +00:00
2018-06-20 16:24:10 +00:00
Install Devicehub with *pip*: `pip3 install ereuse-devicehub -U --pre`.
2018-06-10 17:58:27 +00:00
## Running
2018-06-20 21:32:42 +00:00
Create a python file with the following and call it `app.py`:
2018-06-10 17:58:27 +00:00
```python
from ereuse_devicehub.devicehub import Devicehub
from ereuse_devicehub.config import DevicehubConfig
class MyConfig(DevicehubConfig):
ORGANIZATION_NAME = 'My org'
ORGANIZATION_TAX_ID = 'foo-bar'
app = Devicehub(MyConfig())
```
2018-06-21 15:39:40 +00:00
Create a PostgreSQL database called *devicehub*:
2018-06-20 21:32:42 +00:00
2018-06-21 15:39:40 +00:00
```bash
sudo su - postgres # Change to Postgres main user
postgres $ createdb devicehub # Create main database
postgres $ psql devicehub # Access to the database
postgres $ CREATE USER dhub WITH PASSWORD 'ereuse'; # Create user devicehub uses to access db
postgres $ GRANT ALL PRIVILEGES ON DATABASE devicehub TO dhub; # Give access to the db
2018-06-21 15:39:40 +00:00
postgres $ \q
exit
2018-06-21 15:39:40 +00:00
```
2018-06-20 21:32:42 +00:00
Create the tables in the database by executing in the same directory
where `app.py` is:
2018-06-10 17:58:27 +00:00
2018-06-20 21:18:15 +00:00
```bash
$ flask init-db
```
2018-06-20 16:24:10 +00:00
2018-06-20 21:18:15 +00:00
Finally, run the app:
2018-06-20 21:32:42 +00:00
2018-06-10 17:58:27 +00:00
```bash
$ flask run
```
The error `flask: command not found` can happen when you are not in a
*virtual environment*. Try executing then `python3 -m flask`.
2018-06-10 17:58:27 +00:00
See the [Flask quickstart](http://flask.pocoo.org/docs/1.0/quickstart/)
2018-06-20 16:24:10 +00:00
for more info.
2018-06-20 21:18:15 +00:00
2018-06-20 21:32:42 +00:00
## Administrating
2018-06-20 21:18:15 +00:00
Devicehub has many commands that allows you to administrate it. You
can, for example, create a dummy database of devices with ``flask dummy``
or create users with ``flask create-user``. See all the
2018-06-21 15:39:40 +00:00
available commands by just executing ``flask`` and get more information
per command by executing ``flask command --help``.