...
- Create a repo with just the containers, compose and any scripts needed to get a base configuration running. Call the repo
younite-compose(it shouldn't contain any YOUnite source)- Should have some scripts to reset the DBs
- Run a sample curl to create a zone, domain, post an mdr and get an mdr
- Include steps to launch the UI
- Validate the steps outlined below
...
Follow these steps to get a YOUnite deployment up and running as quickly as possible. These steps make reasonable assumptions but if better detail is desired, look at the implementation documents in the Knowledge Base.
...
- RAM: 16 GB. Running this with 8GB of RAM or less works but intermittent performance issues under moderate load are likely
- Storage: Make sure you have at least 75GB free space (anticipate swapping)
- CPU: Quad Core i7
Available Ports:
Service IP Port Postgres 127.0.0.1 5432 Active MQ 127.0.0.1 1883, 5672, 8161, 61614, 61616 (broker) ELK 127.0.0.1 5000, 5044, 5601 (Kibana), 9200, 9300
In Docker Preferences increase the CPUs and Memory to the highest values you can. Suggested configurations:
| Available RAM | Configure Docker |
|---|---|
| 8GB | 4GB |
| 16GB or above | 12GB |
| Available CPUs | Configure Docker |
|---|---|
| 4 | 2 |
| 8 | 6 |
| 16 or more | 12 |
Clone the Latest and Run the Stack
This compose stack includes an OAuth server which has a UI that can be brought up and Resource Servers and Clients can be created. There should be no need to interact with this component of the stack. All the data that needs to be populated in it to serve the API is populated via the compose.sh script, which calls populateOauthDB.sh:
Clone the latest
>
...
git
...
clone
...
https://<your-username>@bitbucket.org/younite/younite-compose.git
>
...
cd
...
younite-compose
>
...
git
...
submodule
...
update
...
--init
...
--recursive
Bring up the docker containers (with append -d the to the following and the containers will run in detached mode and with minimal console output is sent to the screen) :
>
...
./compose.sh
...
Reset the Databases
...
up
Managing the Docker Compose Stack
See the Docker Compose documentation for more but a list of additional useful commands include:
> ./compose.sh ps - see the running state of your compose stack
> ./compose.sh stop - stop all the containers in the stack
> ./compose.sh logs openmdm-db - view the logs for the database.
> ./compose.sh exec container bash - log into a container
Reset the Databases
Do the following to reset YOUnite to its initial state. To do a reset run the following:
> cd younite-compose
> ./compose.sh stop
> ./resetMdmDb.sh
> ./resetOauthDb.sh
> ./compose.sh up -d
Related articles
See the implementation guides in the Knowledge Base
...