Skip to content

README.md

Latest commit

 

History

History
54 lines (37 loc) · 2.08 KB

README.md

File metadata and controls

54 lines (37 loc) · 2.08 KB

Scripts for deploying Onezone @ onezone.onedata.org

Prerequisites

Prepare a host with the following:

  • git
  • docker
  • docker-compose
  • python + pyyaml
  • hostname set to onezone.onedata.org
  • static DNS NS records pointing at the host IP for subdomain onezone.onedata.org, e.g.: 
    onezone.onedata.org.      120  IN  NS  ns1.onezone.onedata.org
ns1.onezone.onedata.org.  120  IN  A   149.156.182.35
    Onezone will handle the requests for the domain using the build-in DNS server, which enables subdomain delegation for subject Oneproviders (you can find out more here).

First deployment

  1. Place your auth.config in data/secret/auth.config - see OpenID & SAML for more
  2. Run ./onezone.sh start (see onezone.sh)
  3. Visit https://$HOST_IP:9443 and step through the installation wizard
  4. When prompted for emergency passphrase (1st step), provide the one from data/secret/emergency-passphrase.txt

Maintaining the deployment

The Onezone docker is configured to restart automatically.

You can use the onezone.sh script to easily start / stop the deployment and for some convenient commands allowing to exec to the container or view the logs.

Regularly back-up the persistence directory: data/persistence.

To upgrade, stop the deployment (./onezone.sh stop), bump the onezone image version in docker-compose.yaml and start the deployment (./onezone.sh start). Make sure to back-up the persistence directory beforehand.

If you modify anything (e.g. onezone image), please commit the changes rather than make them only locally on the host.

More

Please refer to the documentation.
⚡