... | ... | @@ -2,8 +2,19 @@ Re2o provides a setup script that is used to highly ease the initial installatio |
|
|
|
|
|
This page describes the different uses of this script.
|
|
|
|
|
|
|
|
|
# Usage
|
|
|
1. [Usage](#1-usage)
|
|
|
2. [Subcommands](#2-subcommands)
|
|
|
2.1 [help](#21-help)
|
|
|
2.2 [setup](#22-setup)
|
|
|
2.3 [update](#23-update)
|
|
|
2.4 [update-packages](#24-update-packages)
|
|
|
2.5 [update-django](#25-update-django)
|
|
|
2.6 [update-settings](#26-update-settings)
|
|
|
2.7 [reset-db](#27-reset-db)
|
|
|
2.8 [reset-ldap](#28-reset-ldap)
|
|
|
|
|
|
|
|
|
# 1 - Usage
|
|
|
The usage can be found by launching the script without any options:
|
|
|
```
|
|
|
./install_re2o.sh
|
... | ... | @@ -45,16 +56,16 @@ Sub-commands: |
|
|
```
|
|
|
|
|
|
|
|
|
# Subcommands
|
|
|
# 2 - Subcommands
|
|
|
|
|
|
|
|
|
## help
|
|
|
## 2.1 - help
|
|
|
**Usage**: ```install_re2o [help]```
|
|
|
|
|
|
This command will display the usage message with a quick description of the possible arguments.
|
|
|
|
|
|
|
|
|
## setup
|
|
|
## 2.2 - setup
|
|
|
**Usage**: ```install_re2o setup```
|
|
|
|
|
|
This command will start the interactive guide to help you setup from scratch.
|
... | ... | @@ -68,7 +79,7 @@ If everything went well, you should be able to access Re2o website at the URL yo |
|
|
*:warning: Even if it should not fail or completely mess up things, it is recommend to only use this command on completely new setup.*
|
|
|
|
|
|
|
|
|
## update
|
|
|
## 2.3 - update
|
|
|
**Usage**: ```install_re2o update```
|
|
|
|
|
|
This command will perform some updates on the project. It is equivalent of doing:
|
... | ... | @@ -79,19 +90,19 @@ install_re2o update-django |
|
|
See the corresponding commands below for more details ont the effects. This command is highly suited to be performed after a pull of the project.
|
|
|
|
|
|
|
|
|
## update-packages
|
|
|
## 2.4 - update-packages
|
|
|
**Usage**: ```install_re2o update-packages```
|
|
|
|
|
|
This command will reinstall and/or update all the required packages for the project. It will install both *APT* and *PyPi* missing packages but won't delete the old and unused anymore ones.
|
|
|
|
|
|
|
|
|
## update-django
|
|
|
## 2.5 - update-django
|
|
|
**Usage**: ```install_re2o update-django```
|
|
|
|
|
|
This command will update the Django related components. It will first aplly the non-applied migrations on the database and then collect the non-collected static files. Those are standard Django actions but should be done after each pull of the project.
|
|
|
|
|
|
|
|
|
## update-settings
|
|
|
## 2.6 - update-settings
|
|
|
**Usage**: ```install_re2o update-settings```
|
|
|
|
|
|
This command will interactively rewrite the settings file based on the example provided by the project. It will ask the user for some details of the configuration to use (username, passwords, ...) and will use the template for creating a new settings file. This is intention here is to use an up-to-date version of the settings and being sure that all new options are included.
|
... | ... | @@ -99,7 +110,7 @@ This command will interactively rewrite the settings file based on the example p |
|
|
:warning: The side effect of this command is that it will erase the previous configuration, which is good to get rid of out-dated configuraiton, but the generated one is probably far less precise and you will highly probably need to complete the newly generated settings to get the same behaviour as before.
|
|
|
|
|
|
|
|
|
## reset-db
|
|
|
## 2.7 - reset-db
|
|
|
**Usage**: ```install_re2o reset-db <db_password> [db_engine_type] [db_name] [db_username]```
|
|
|
|
|
|
This command will reset the **local** database to its original empty state (or create a **local** one if there is none). In order to get the database in an up-to-date state, the Django's migrations will also be applied rigth after the creation of the database. This means that the given parameters should be reflected in the settings file (username, password, hostname, ...) to run properly.
|
... | ... | @@ -107,31 +118,31 @@ This command will reset the **local** database to its original empty state (or c |
|
|
*:warning: This command is not meant to be used on production server (whose database should not be hosted locally ideally) but more on developpement environnement where it might be usefull to fully reset the database and get back to a stable state.*
|
|
|
|
|
|
|
|
|
### db_password
|
|
|
### 2.7.1 - db_password
|
|
|
**Value**: *Any string that can be a password*
|
|
|
|
|
|
This paramater indicates the password that will be used to connect to the local database.
|
|
|
|
|
|
|
|
|
### db_engine_type
|
|
|
### 2.7.2 - db_engine_type
|
|
|
**Value**: `mysql` or `postgresql` (Default: `mysql`)
|
|
|
|
|
|
This paramaters indicates whether to use a MySQL or a PostgreSQL for the local database.
|
|
|
|
|
|
|
|
|
### db_name
|
|
|
### 2.7.3 - db_name
|
|
|
**Value**: *Any string that can be a database name* (Default: `re2o`)
|
|
|
|
|
|
This parameter indicates the name of the database that will be used to store re2o data on the local database.
|
|
|
|
|
|
|
|
|
### db_username
|
|
|
### 2.7.4 - db_username
|
|
|
**Value**: *Any string that can be a user name* (Default: `re2o`)
|
|
|
|
|
|
This parameter indicates the username that will be used to connect to the local database.
|
|
|
|
|
|
|
|
|
## reset-ldap
|
|
|
## 2.8 - reset-ldap
|
|
|
**Usage**: ```install_re2o reset-ldap <ldap_password> <local_domain>```
|
|
|
|
|
|
This command will reset the **local** LDAP to its original empty state (or create a **local** one if there is none). The given parameters should be reflected in the settings file (username, password, hostname, ...) after the changement.
|
... | ... | @@ -139,13 +150,13 @@ This command will reset the **local** LDAP to its original empty state (or creat |
|
|
*:warning: This command is not meant to be used on production server (whose LDAP should not be hosted locally ideally) but more on developpement environnement where it might be usefull to fully reset the LDAP and get back to a stable state.*
|
|
|
|
|
|
|
|
|
### ldap_password
|
|
|
### 2.8.1 - ldap_password
|
|
|
**Value**: *Any string that can be a password*
|
|
|
|
|
|
This parameter indicates the password that will be used to connect the local LDAP.
|
|
|
|
|
|
|
|
|
### local_domain
|
|
|
### 2.8.2 - local_domain
|
|
|
**Value**: *Any valid DN entry in LDAP notations* (e.g. `dc=example,dc=net`)
|
|
|
|
|
|
This parameter indicates the root DN entry to use in the LDAP that should reflect a domain name extension helb by the user. |
|
|
\ No newline at end of file |