Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/CoRfr/spex-3gpp
A WebService to deliver 3GPP specifications.
https://github.com/CoRfr/spex-3gpp
Last synced: about 1 month ago
JSON representation
A WebService to deliver 3GPP specifications.
- Host: GitHub
- URL: https://github.com/CoRfr/spex-3gpp
- Owner: CoRfr
- License: gpl-3.0
- Created: 2014-12-22T16:20:35.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2023-01-19T11:02:57.000Z (almost 2 years ago)
- Last Synced: 2024-08-02T20:46:18.952Z (4 months ago)
- Language: JavaScript
- Size: 552 KB
- Stars: 34
- Watchers: 6
- Forks: 17
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- License: COPYING.GPLv3
Awesome Lists containing this project
- awesome-5g - speX - A WebService to deliver 3GPP specifications. (Tools / Diameter)
README
# This is speX
I found the 3GPP documents hard to find, hard to stay up-to-date, etc ...
So this is an alternative service to expose 3GPP specifications in a different architecture.
Feel free to fork.
Service is provided at http://spex.cor-net.org
## How to run the service
### Using Docker
The docker image is available as `corfr/spex` or from sources:
```
host:spex$ docker build -t spex .
```
In the following we'll run the spex container. Along with it comes a MySQL database and a docker volume for data storage.
```console
host:~$ docker volume create spex-storage
host:~$ docker network create spex-net
host:~$ docker run --name spex-mysql --network spex-net -e MYSQL_ROOT_PASSWORD=spex -d mysql:latest
```
```
# connect to the mysql container
host:~$ docker run -it --network spex-net --rm mysql mysql -h spex-mysql -u root -p
# within mysql, create a new database
spex-mysql:~$ mysql
mysql> CREATE DATABASE spex;
```
Now we can start spex, point it to the MySQL database, and mount the data storage.
```
host:~$ docker run --name spex --network spex-net -e MYSQL_ENV_DB_NAME=spex -e MYSQL_ENV_DB_USER=root -e MYSQL_ENV_DB_PASS=spex -e MYSQL_PORT_3306_TCP_ADDR=spex-mysql -v spex-storage:/home/app/webapp/specs -p 3000:80 corfr/spex
```
On first run, you'll need to manually populate the database:
```
host:~$ docker exec -ti -u app spex bash
spex:~$ cd /home/app/webapp
# if the database cannot be setup, first disable the security checks
spex:webapp$ export DISABLE_DATABASE_ENVIRONMENT_CHECK=1
spex:webapp$ bundle exec rake db:setup
spex:webapp$ bundle exec /home/app/webapp/script/init_3gpp.rb
```
The spex website is now available on `http://localhost:3000`
### Using Docker Compose
From the top-level directory:
```
docker-compose pull
docker-compose build
docker-compose up -d
```
On first run, you'll need to manually populate the database:
```
host:~$ docker-compose exec spex bash
spex:~$ cd /home/app/webapp
# if the database cannot be setup, first disable the security checks
spex:webapp$ export DISABLE_DATABASE_ENVIRONMENT_CHECK=1
spex:webapp$ bundle exec rake db:setup
spex:webapp$ bundle exec /home/app/webapp/script/init_3gpp.rb
```
The spex website is now available on `http://localhost:3000`
### Using rake (development)
```
bundle install
bundle exec rails server
```
To populate the database, use:
```
bundle exec rake db:setup
scripts/init_3gpp.rb
```