... | ... | @@ -238,26 +238,28 @@ Start **GGCE Server** as a Docker container: |
|
|
docker image pull dockerhub.croptrust.org/grin-global/grin-global-server:latest
|
|
|
|
|
|
# Start GRIN-Global Server
|
|
|
# Make sure that address for MSSQL "jdbc:sqlserver://172.17.0.2:1433" is
|
|
|
# Make sure that address for MSSQL "jdbc:sqlserver://MSSQL-SERVER:1433" is
|
|
|
# equal to ip from `docker inspect mssql-ggce` output
|
|
|
docker run --rm --name 'ggce-server' \
|
|
|
docker run --name 'ggce-server' \
|
|
|
--memory 4g
|
|
|
-p 8081:8080 \
|
|
|
-e "DB_URL=jdbc:sqlserver://<MSSQL>:1433;DatabaseName=ggce" \
|
|
|
-e "DB_URL=jdbc:sqlserver://MSSQL-SERVER:1433;DatabaseName=ggce" \
|
|
|
-e "DB_USERNAME=sa" \
|
|
|
-e "DB_PASSWORD=YourStrong@Passw0rd" \
|
|
|
-e "BASE_URL=http://gserver.genebank.org:8081" \
|
|
|
-e "FRONTEND_URL=http://${YOUR_DOCKER_HOST_IP}:3000" \
|
|
|
-e "BASE_URL=http://YOUR_DOCKER_HOST_IP:8081" \
|
|
|
-e "FRONTEND_URL=http://YOUR_DOCKER_HOST_IP:3000" \
|
|
|
-e "DATA_DIR=/data/gringlobal" \
|
|
|
-e "JAVA_OPTIONS=-XX:+HeapDumpOnOutOfMemoryError -XX:+UseParallelGC -Xms1500m -XX:+UnlockExperimentalVMOptions -Djava.awt.headless=true -server -Dnetworkaddress.cache.ttl=10 --add-modules java.se --add-exports java.base/jdk.internal.ref=ALL-UNNAMED --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.nio=ALL-UNNAMED --add-opens java.base/sun.nio.ch=ALL-UNNAMED --add-opens java.management/sun.management=ALL-UNNAMED --add-opens jdk.management/com.sun.management.internal=ALL-UNNAMED" \
|
|
|
-v ggce-server-data:/data/gringlobal \
|
|
|
dockerhub.croptrust.org/grin-global/grin-global-server:latest
|
|
|
```
|
|
|
|
|
|
***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.
|
|
|
|
|
|
GGCE 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 GGCE. This makes your GGCE server accessible at http://YOUR_DOCKER_HOST_IP:8081 and cooresponds with variable `HOST_NAMEANDPORT` in the command above.
|
|
|
GGCE 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 GGCE. This makes your GGCE server accessible at http://YOUR_DOCKER_HOST_IP:8081 and cooresponds with variable `BASE_URL` in the command above.
|
|
|
|
|
|
When you see the message `[INFO] Started Jetty Server` you can connect to your own GGCE instance on the IP of the host
|
|
|
and port **8081** (if you used the command above) at `http://your-docker-host:8081`
|
|
|
and port **8081** (if you used the command above) at `http://YOUR_DOCKER_HOST_IP:8081`
|
|
|
|
|
|
|
|
|
### Upgrading to newer version
|
... | ... | @@ -272,7 +274,7 @@ docker run... # as above |
|
|
```
|
|
|
|
|
|
|
|
|
# GGCE Web Client
|
|
|
# GGCE Web client
|
|
|
|
|
|
The **GRIN-Global Client** is a set of tools for genebank technicians, curators and managers to interact with the[GGCE Server](https://gitlab.croptrust.org/grin-global/grin-global-server) APIs.
|
|
|
|
... | ... | @@ -286,27 +288,28 @@ Please check https://gitlab.croptrust.org/grin-global/grin-global-ui/-/releases |
|
|
|
|
|
The **GGCE Web** container requires a few configuration options. The options are provided as environment variables. You need to note:
|
|
|
|
|
|
1. `API_URL`: The URL to the **GGCE Server** (e.g. `http://GGCE-SERVER:8081`)
|
|
|
This should match the *host name* (including port, if not default) where *GGCE-server* is accessible.
|
|
|
1. `ORIGIN`: The frontend URL of the **GGCE Web** service (e.g. `http://grin-global-web:3000`)
|
|
|
This should match the `FRONTEND_URL` variable of your *GGCE-server* container when using the default OAuth client. You can omit this if using a OAuth client you declared manually.
|
|
|
1. `API_URL`: The URL to the **GGCE Server** (e.g. `http://YOUR_DOCKER_HOST_IP:8081`)
|
|
|
This should match the *host name* (including port, if not default) where *GGCE Server* is accessible.
|
|
|
1. `ORIGIN`: The frontend URL of the **GGCE Web** service (e.g. `http://YOUR_DOCKER_HOST_IP:3000`)
|
|
|
This should match the `FRONTEND_URL` variable of your *GGCE Server* container when using the default OAuth client. You can omit this if using a OAuth client you declared manually.
|
|
|
1. `CLIENT_ID` and `CLIENT_SECRET`: OAuth Client credentials (or skip to use default values)
|
|
|
OAuth client credentials of **grin-global-web**.
|
|
|
OAuth client credentials of **GGCE Web**.
|
|
|
|
|
|
Start **GGCE Server** as a Docker container:
|
|
|
|
|
|
```bash
|
|
|
# Start GGCE Web
|
|
|
docker run --rm --name 'grin-global-web' \
|
|
|
docker run --name 'ggce-ui' \
|
|
|
--memory 500m
|
|
|
-p 3000:3000 \
|
|
|
-e "API_URL=http://GGCE-SERVER:8081" \
|
|
|
-e "ORIGIN=http://grin-global-web:3000" \
|
|
|
-e "API_URL=http://YOUR_DOCKER_HOST_IP:8081" \
|
|
|
-e "ORIGIN=http://YOUR_DOCKER_HOST_IP:3000" \
|
|
|
dockerhub.croptrust.org/grin-global/grin-global-ui/gg-ce-web:latest
|
|
|
```
|
|
|
|
|
|
**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.
|
|
|
|
|
|
GGCE Web internally listens on port **3000**. The `-p 3000:3000` flag above instructs docker to map the host port **3000** to the internal container port **3000**. This makes the GGCE web interface accessible at `http://grin-global-web:3000`
|
|
|
GGCE Web internally listens on port **3000**. The `-p 3000:3000` flag above instructs docker to map the host port **3000** to the internal container port **3000**. This makes the GGCE web interface accessible at `http://YOUR_DOCKER_HOST_IP:3000`
|
|
|
|
|
|
### Troubleshooting
|
|
|
|
... | ... | |