Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jaybeede/docker_racktables
Racktables is a nifty and robust solution for datacenter and server room asset management.
https://github.com/jaybeede/docker_racktables
Last synced: 17 days ago
JSON representation
Racktables is a nifty and robust solution for datacenter and server room asset management.
- Host: GitHub
- URL: https://github.com/jaybeede/docker_racktables
- Owner: JayBeeDe
- Created: 2019-07-08T08:55:55.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2019-12-18T21:31:43.000Z (about 5 years ago)
- Last Synced: 2024-11-09T16:48:03.417Z (2 months ago)
- Language: Shell
- Size: 72.3 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Racktables
## What is racktables?
[](http://inch-ci.org/github/JayBeeDe/docker_racktables) [](http://hits.dwyl.com/JayBeeDe/docker_racktables)
Racktables is a nifty and robust solution for datacenter and server room asset management. It helps document hardware assets, network addresses, space in racks, networks configuration and much much more!
[https://www.racktables.org/about.php](https://www.racktables.org/about.php)
## Quick reference
- [Official Website](https://www.racktables.org/about.php)
- [Wiki](https://wiki.racktables.org/index.php/Main_Page)
- [Contact](https://www.racktables.org/contacts.php)
- [IP address management Software Comparison](https://en.wikipedia.org/wiki/IP_address_management)
- [Bug Tracker](https://bugs.racktables.org/my_view_page.php)
- [License](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
## How to use this image
### Racktables Partial-Automatic Install
In this section, since no database structure exists here, the step that *initializes the database still has to be done _manually_*.
Here is the command to run the mysql container with the correct specific parameters for racktables:
```shell
docker run -d -it --name racktables-db -e MYSQL_DATABASE=myNiceDbName -e MYSQL_USER=myNiceDbUserName -e MYSQL_PASSWORD=myNiceDbPassword -e MYSQL_ROOT_PASSWORD=myNiceROOTDbPassword --restart=always --hostname=racktables-db mysql:5.7 --character-set-server=utf8 --collation-server=utf8_unicode_ci
```
And here for the racktables application:
```shell
docker run -d -it --name racktables-ui --link racktables-db:mysql -e dbHost="racktables-db" -e dbName="myNiceDbName" -e dbUser="myNiceDbUserName" -e dbPass="myNiceDbPassword" --restart=always --hostname=racktables-ui -p 8080:80 jbd92/racktables:latest
```
Then you just have to visit [http://localhost:8080/?module=installer&step=5](http://localhost:8080/?module=installer&step=5) in order to *create the database structure* as well as the *administrator password*: follow the legacy racktables install instructions on the screen. After that manual action you can enjoy racktables!
### Racktables Full-Automatic Install
In this section, we mount a volume which contains the SQL install script into docker-entrypoint-initdb.d directory, so that it runs only once at the database container's first run! This script will automatically create the database structure as well as the Administrator password.
First you need to download the SQL script somewhere on the container host: let's say into /opt/tmp/ (you can choose something better or create a volume and put the ini.sql file into that volume):
```shell
mkdir -p /opt/tmp/
cd /opt/tmp/
wget https://github.com/JayBeeDe/docker_racktables/blob/master/db/ini.sql
```
Then we start the mySQL container:
```shell
docker run -d -it --name racktables-db -e MYSQL_DATABASE=myNiceDbName -e MYSQL_USER=myNiceDbUserName -e MYSQL_PASSWORD=myNiceDbPassword -e MYSQL_ROOT_PASSWORD=myNiceROOTDbPassword --volume=/opt/tmp:/docker-entrypoint-initdb.d --restart=always --hostname=racktables-db mysql:5.7 --character-set-server=utf8 --collation-server=utf8_unicode_ci
```
And here for the racktables application (same as Racktables _Partial-Automatic Install_):
```shell
docker run -d -it --name racktables-ui --link racktables-db:mysql -e dbHost="racktables-db" -e dbName="myNiceDbName" -e dbUser="myNiceDbUserName" -e dbPass="myNiceDbPassword" --restart=always --hostname=racktables-ui -p 8080:80 jbd92/racktables:latest
```
Contrary to _Partial-Automatic Install_, you can directly jump to [http://localhost:8080/](http://localhost:8080/) and connect with the following credentials:
- user: admin
- password: testme
Change the password as soon as possible!
## Environment Variables
As you can see, there are several environment variables. Here is the full list with their default values:
Docker Environment Var. | Default Value | Description
------------- | ------------- | -------------
dbName | racktables_db | MySQL database name
dbHost | racktables_host | MySQL hostname
dbPort | 3306 | MySQL port
dbUser | racktables_user | MySQL user
dbPass | racktables_pwd | MySQL password
## License
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 2](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html) of the License.