Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
gargantext
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
humanities
gargantext
Commits
9dd88c59
Commit
9dd88c59
authored
Apr 28, 2016
by
c24b
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Install instruction udpated
parent
02ff9a56
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
162 additions
and
11 deletions
+162
-11
README.md
install/README.md
+162
-11
No files found.
install/README.md
View file @
9dd88c59
Gargantext
#
Gargantext
==========
Install Instructions for Gargantext (CNRS):
## Install Instructions
1.
[
SETUP
](
##SETUP
)
2.
[
INSTALL
](
##INSTALL
)
3.
[
RUN
](
##RUN
)
## Help needed ?
See http://gargantext.org/about and tools for the community
## SETUP
Prepare your environnement
Create user gargantua
Main user of Gargantext is Gargantua (role of Pantagruel soon)!
```
bash
sudo
adduser
--disabled-password
--gecos
""
gargantua
```
Create the directories you need
```
bash
for
dir
in
"/srv/gargantext"
"/srv/gargantext_lib"
"/srv/gargantext_static"
"/srv/gargantext_media"
"/srv/env_3-5"
;
do
sudo mkdir
-p
$dir
;
sudo chown
gargantua:gargantua
$dir
;
done
```
You should see:
```
bash
$tree
/srv
/srv
├── gargantext
├── gargantext_lib
├── gargantext_media
│ └── srv
│ └── env_3-5
├── gargantext_static
└── lost+found
[
error opening
dir
]
```
## Get the source code of Gargantext
Clone the repository of gargantext
```
bash
git clone ssh://gitolite@delanoe.org:1979/gargantext /srv/gargantext
\
&&
cd
/srv/gargantext
\
&&
git fetch origin refactoring
\
&&
git checkout refactoring
\
```
**Optionnal**
: if you want to contribute clone the repo into your own branch
```
bash
git checkout
-b
username-refactoring refactoring
```
! TODO (soon) : git clone https://gogs.iscpif.fr/gargantext.git
## SETUP
Build your OS dependencies
2 ways, for each you need to install Debian GNU/Linux dependencies.
1.
[
EASY
]
[
Docker way
]
(#DOCKER)
2.
[
EXPERT
]
[
Debian way
]
(#DEBIAN)
### DOCKER
*
Install docker
See
[
installation instruction for your distribution
](
https://docs.docker.com/engine/installation/
)
#### Build your docker image
```
bash
cd
/srv/gargantext/install/docker/dev
./build
```
You should see
```
Successfully built <container_id>
```
#### Enter into the docker environnement
```
bash
./srv/gargantext/install/docker/enterGargantextImage
```
#### Install Python environment
Inside the docker image, execute as root:
```
bash
/srv/gargantext/install/python/configure
```
#### Configure PostgreSql
Inside the docker image, execute as root:
```
bash
/srv/gargantext/install/postgres/configure
```
#### Exit the docker
```
exit
```
#### Get main librairies
Can be long, so be patient :)
```
bash
wget http://dl.gargantext.org/gargantext_lib.tar.bz2
\
&& tar xvjf gargantext_lib.tar.bz2 -o /srv/gargantext_lib
\
&& sudo chown -R gargantua:gargantua /srv/gargantext_lib
\
&& echo "Libs installed"
```
### DEBIAN
[EXPERTS] Debian way (directory install/debian)
## INSTALL Gargantext
### Enter docker container
```
bash
/srv/gargantext/install/docker/enterGargantextImage
```
### Inside docker container configure the database
```
bash
service postgresql start
su gargantua
source /srv/env_3-5/bin/activate
python /srv/gargantext/dbmigrate.py
/srv/gargantext/manage.py migrate
python /srv/gargantext/dbmigrate.py
python /srv/gargantext/dbmigrate.py
echo "TODO: Init first user"
```
FIXME: dbmigrate need to launched several times since tables are
ordered with alphabetical order (and not dependencies order)
### Inside docker container launch Gargantext
```
bash
service postgresql start
su gargantua
source /srv/env_3-5/bin/activate
/srv/gargantext/manage.py runserver 0.0.0.0:8000
python /srv/gargantext/init_accounts.py /srv/gargantext/install/init/account.csv
```
## RUN
### Outside docker container launch browser
```
bash
chromium http://127.0.0.1:8000/
```
Click on Test Gargantext
Login : gargantua
Password : autnagrag
Enjoy :)
1)
[
Docker way
](
./docker/README.md
)
(
directory
install/docker)
2)
[
Debian way
](
./debian/README.md
)(
directory
install/debian)
For each solution, you need to install:
-
Debian GNU/Linux dependencies
-
Configure PostgreSql
-
Install Python environment
-
Get the libs that need to live in /srv/gargantext_lib
## Help needed ?
See
[
http://gargantext.org/about
](
http://gargantext.org/about
)
and tools for the community
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment