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
f6ffaa95
Commit
f6ffaa95
authored
Jul 04, 2016
by
c24b
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
SEMI AUTOMATIC INSTALL
parent
b81d23e0
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
with
64 additions
and
56 deletions
+64
-56
install.md
docs/install.md
+64
-56
No files found.
docs/install.md
View file @
f6ffaa95
Install Instructions for Gargantext (CNRS):
#
Install Instructions for Gargantext (CNRS):
Help needed ?
## Get the source code
See
[
http://gargantext.org/about
](
http://gargantext.org/about
)
and
[
tools
](
)
for the community
by cloning gargantext into /srv/gargantext
```
bash
git clone ssh://gitolite@delanoe.org:1979/gargantext /srv/gargantext
\
&&
cd
/srv/gargantext
\
&&
git fetch origin stable
\
&&
git checkout stable
\
```
Prepare your environnement and make the initial installation.
The folder will be /srv/gargantext:
Once you setup and install the Gargantext box. You can use ./install/run.sh utility
*
docs containes all informations on gargantext
to load gargantext web plateform and access it throught your web browser
/srv/gargantext/docs/
*
install contains all the installation files
/srv/gargantext/install/
____________________________
__
Help needed ?
See
[
http://gargantext.org/about
](
http://gargantext.org/about
)
and
[
tools
](
./contribution_guide.md
)
for the community
Two installation procedure are provided:
1.
[
Prerequisites
](
##Prerequisites
)
1.
Semi-automatic installation
[
EASY
]
2.
Step by step installation
[
ADVANCED
]
2.
[
SETUP
](
##Setup
)
Here only semi-automatic installation is covered checkout
[
manual_install
](
manual_install.md
)
to follow step by step procedure
3.
[
INSTALL
](
##Install
)
4.
[
RUN
](
##RUN
)
____________________________
__
##Prerequisites
##Prerequisites
## Init Setup
## Install
## Run
--------------------
# Semi automatic installation
All the procedure files are located into /srv/garantext/install/
```
bash
user@computer:
$
cd
/srv/garantext/install/
```
## Prerequisites
*
A Debian based OS >=
[
FIXME
]
*
A Debian based OS >=
[
FIXME
]
*
At least 35GO in
the desired location of Gargantua
[
FIXME
]
*
At least 35GO in
/srv/
[
FIXME
]
todo: reduce the size of gargantext lib
todo: reduce the size of gargantext lib
todo: remove lib once docker is configure
todo: remove lib once docker is configure
d
tip: if you have enought space for the full package you can:
!
tip: if you have enought space for the full package you can:
*
resize your partition
*
resize your partition
*
make a simlink on gargantext_lib
*
make a simlink on gargantext_lib
*
A
[
docker engine installation
](
https://docs.docker.com/engine/installation/linux/
)
##Setup
Prepare your environnement and make the initial setup.
Setup can be done in 2 ways:
*
[
automatic setup
](
setup.sh
)
can be done by using the setup script provided
[
here
](
setup.sh
)
*
[
manual setup
](
manual_setup.md
)
if you want to change some parameters
[
here
](
manual_setup.md
)
##Install
Two installation procedure are actually proposed:
*
the docker way
[
easy
]
*
the debian way
[
advanced
]
####DOCKER WAY [EASY]
##Init Setup
Prepare your environnement and make the initial setup.
*
Install docker
This initial step creates a user for gargantext plateform along with dowloading additionnal libs and files.
See
[
installation instruction for your distribution
](
https://docs.docker.com/engine/installation/
)
*
Build your docker image
It also install docker and build the docker image and build the gargantext box
```
bash
```
bash
cd
/srv/gargantext/install/docker/config
user@computer:/srv/garantext/install/
$
.init.sh
./build
ID
=
$(
docker build .
)
&&
docker run
-i
-t
$ID
```
```
You should see
```
### Install
Successfully built <container_id>
Once the init step is done
```
*
Enter into the docker environnement
*
Enter into the docker environnement
Inside folder /srv/garantext/install/
enter the gargantext image
```
bash
user@computer:/srv/garantext/install/
$
.docker/enterGargantextImage
```
go to the installation folder
```
bash
```
bash
./srv/gargantext/install/docker/enterGargantextImage
root@dockerimage8989809:
$
cd
/srv/gargantext/install/
```
```
[
ICI
]
Tester si les config de postgresql et python sont faits en amont à la création du docker file
[
ICI
]
Tester si les config de postgresql et python sont faits en amont à la création du docker file
*
Install Python environment
*
Install Python environment
Inside the docker image, execute as root:
``` bash
``` bash
/srv/gargantext/install/
python/configure
root@dockerimage8989809:/srv/garantext/install/$
python/configure
```
```
*
Configure PostgreSql
*
Configure PostgreSql
Inside the docker image, execute as root:
Inside the docker image, execute as root:
```
bash
```
bash
/srv/gargantext/install/
postgres/configure
root@computer:/srv/garantext/install/
$
postgres/configure
```
```
[
Si OK
]
enlever ses lignes
Install Gargantext server
Install Gargantext server
*
Enter docker container
```
bash
/srv/gargantext/install/docker/enterGargantextImage
```
*
Configure the database
*
Configure the database
Inside the docker container:
Inside the docker container:
```
bash
```
bash
...
@@ -116,15 +125,15 @@ You have entered the virtualenv as shown with (env_3-5)
...
@@ -116,15 +125,15 @@ You have entered the virtualenv as shown with (env_3-5)
FIXME: dbmigrate need to launched several times since tables are
FIXME: dbmigrate need to launched several times since tables are
ordered with alphabetical order (and not dependencies order)
ordered with alphabetical order (and not dependencies order)
*
Exit the docker
*
Exit the docker
```
```
exit (or Ctrl+D)
exit (or Ctrl+D)
```
```
####Debian way [advanced]
##Run Gargantext
*
Launch
Gargantext
## Run
Gargantext
Enter the docker container:
Enter the docker container:
```
bash
```
bash
...
@@ -132,7 +141,7 @@ Enter the docker container:
...
@@ -132,7 +141,7 @@ Enter the docker container:
```
```
Inside the docker container:
Inside the docker container:
```
bash
```
bash
#start
postgresql
#start
Database (postgresql)
service postgresql start
service postgresql start
#change to user
#change to user
su gargantua
su gargantua
...
@@ -143,20 +152,19 @@ source /srv/env_3-5/bin/activate
...
@@ -143,20 +152,19 @@ source /srv/env_3-5/bin/activate
#run the server
#run the server
(
env_3-5
)
$
/manage.py runserver 0.0.0.0:8000
(
env_3-5
)
$
/manage.py runserver 0.0.0.0:8000
```
```
Keep it open and outside the docker launch browser
*
Launch browser
outside the docker
```
bash
```
bash
chromium http://127.0.0.1:8000/
chromium http://127.0.0.1:8000/
```
```
*
Click on Test Gargantext
*
Click on Test Gargantext
```
```
Login : gargantua
Login : gargantua
Password : autnagrag
Password : autnagrag
```
```
Enjoy :)
Enjoy :)
See
[
User Guide
](
/demo/tuto.md
)
for quick usage example
See
[
User Guide
](
/demo/tuto.md
)
for quick usage example
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