... | ... | @@ -2,11 +2,19 @@ |
|
|
|
|
|
###### *For IT administrators only*
|
|
|
|
|
|
#### Install GG-CE in three simple steps
|
|
|
|
|
|
1. Set up MSSQL database.
|
|
|
2. Designate a volume for GG-CE file repository.
|
|
|
3. Update the Docker compose file and deploy your GG-CE services.
|
|
|
|
|
|
**GRIN-Global Community Edition** (GG-CE) is implemented through two main components: the GG-CE-Server and the GG-CE-Web client that provides a **web user interface** through which genebank staff interact with GG-CE.
|
|
|
|
|
|
The GG-CE web user interface `gg-ce-web` represents the most complete GG-CE client application which covers most genebank operations. Other client applications such as mobile apps to support specific processes in the genebank (e.g. recording trait observations), the [Curator Tool](https://www.grin-global.org/download_ct.html), and other applications may also interact with the **server**.
|
|
|
The **GG-CE-Server** manages the application business logic, interacts with the **database** which stores the application data, and with a **file volume** to store user-uploaded files and documents.
|
|
|
|
|
|
GG-CE components are packaged as **[Docker](https://www.docker.com) images** and designed for container deployment on Windows, Linux and macOS hosts. There is no “installer”, no Windows registry entries, and no pollution of the host system with software dependencies.
|
|
|
The GG-CE web user interface **gg-ce-web** represents the most complete GG-CE client application and covers most genebank operations. Other client applications such as mobile apps to support specific processes in the genebank (e.g. recording trait observations), the Curator Tool, and other applications may also interact with the GG-CE JSON or SOAP API provided by the **server**.
|
|
|
|
|
|
GG-CE components are packaged as **Docker images** and designed for container deployment on Windows, Linux and macOS hosts.
|
|
|
|
|
|
![production-environment](images/production-environment.png)
|
|
|
|
... | ... | @@ -227,7 +235,7 @@ Please make note of the following GG-CE server configuration options: |
|
|
- `FRONTEND_URL`
|
|
|
The frontend URL of the GG-CE Web service is/will be accessible.
|
|
|
|
|
|
A docker volume ensures that the data persists between container restarts.
|
|
|
A **docker volume** ensures that the data persists between container restarts.
|
|
|
|
|
|
```bash
|
|
|
# Create a data volume
|
... | ... | @@ -256,7 +264,7 @@ docker run --rm --name 'ggce-server' \ |
|
|
dockerhub.croptrust.org/grin-global/grin-global-server:2021.10
|
|
|
```
|
|
|
|
|
|
**Note:** After hitting **Enter** You should immediately seeing log messages on the console. If not, then your command is not valid. Hit `Ctrl + C` and retry.
|
|
|
***Note*:** After hitting **Enter** You should immediately seeing log messages on the console. If not, then your command is not valid. Hit `Ctrl + C` and retry.
|
|
|
|
|
|
GG-CE internally listens on port **8080**. The `-p 8081:8080` flag above instructs docker to map the host port **8081** to the internal port 8080 used by GG-CE. This makes your GG-CE server accessible at http://YOUR_DOCKER_HOST_IP:8081 and cooresponds with variable `HOST_NAMEANDPORT` in the command above.
|
|
|
|
... | ... | |