Differences

This shows you the differences between two versions of the page.

--- medal-data:setup [2022/01/19 09:15] – arnaudpoletto
+++ medal-data:setup [2022/01/19 11:46] (current) – arnaudpoletto
@@ Line 31: / Line 31: @@
+==== Install Docker ====
-=== Dokku Installation on Remote Server ===
+To setup Docker on the remote server, follow this procedure:
-To setup the dokku installation, follow these steps:
+  - **[t_remote]** To update ubuntu server, type: <code>sudo apt update</code>
+  - **[t_remote]** Install a few prerequisite packages which let apt use packages over HTTPS by typing: <code>sudo apt install apt-transport-https ca-certificates curl software-properties-common</code>
-  - **[t_remote]** Install dokku with the following commands: \\ <code>
+  - **[t_remote]** Add the GPG key for the official Docker repository to your system by typing: <code>curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</code>
-wget https://raw.githubusercontent.com/dokku/dokku/v0.24.10/bootstrap.sh
+  - **[t_remote]** Add the Docker repository to APT sources: <code>sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable"</code>
-sudo DOKKU_TAG=v0.24.10 bash bootstrap.sh </code> To get the latest verison go to https://dokku.com/docs/getting-started/installation/
+  - **[t_remote]** Update the package database with the Docker packages from the newly added repository: <code>sudo apt update</code>
-  - To update ubuntu server, type: <code>sudo apt update</code>
+  - **[t_remote]** Make sure you are about to install from the Docker repository instead of the default Ubuntu repository: <code>apt-cache policy docker-ce</code> You will see an output like the following: <code>
-  - Install a few prerequisite packages which let apt use packages over HTTPS by typing: <code>sudo apt install apt-transport-https ca-certificates curl software-properties-common</code>
-  - Add the GPG key for the official Docker repository to your system by typing: <code>curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -</code>
-  - Add the Docker repository to APT sources: <code>sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable"</code>
-  - Update the package database with the Docker packages from the newly added repository: <code>sudo apt update</code>
-  - Make sure you are about to install from the Docker repository instead of the default Ubuntu repository: <code>apt-cache policy docker-ce</code> You will see an output like the following: <code>
 docker-ce:
   Installed: (none)
@@ Line 52: / Line 48: @@
 https://download.docker.com/linux/ubuntu bionic/stable amd64 Packages
 </code>
-  - Finally, install Docker: <code>sudo apt install docker-ce</code>
+  - **[t_remote]** Finally, install Docker: <code>sudo apt install docker-ce</code>
-  - Docker should now be installed, the daemon started, and the process enabled to start on boot. Check that it’s running: <code>sudo systemctl status docker</code>
+  - **[t_remote]** Docker should now be installed, the daemon started, and the process enabled to start on boot. Check that it’s running: <code>sudo systemctl status docker</code>
 For more information, you can check on this site (https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-18-04)
+==== Install Nginx ====
+To setup Nginx on the remote server, follow these steps:
+      - **[t_remote]** Install nginx: <code>sudo apt install nginx</code>
+      - **[t_remote]** Enable nginx in the firewall by typing: <code>sudo ufw allow 'Nginx Full'</code>
+==== Install Dokku ====
+To setup Dokku on the remote server, follow these steps:
+  - **[t_remote]** Install dokku with the following commands: \\ <code>
+wget https://raw.githubusercontent.com/dokku/dokku/v0.24.10/bootstrap.sh
+sudo DOKKU_TAG=v0.24.10 bash bootstrap.sh </code> To get the latest verison go to https://dokku.com/docs/getting-started/installation/
   - **[t_local]** On the local workstation, open a browser and head to your server domain ''example.com'' where you will be able to setup the public SSH key used when deploying the source code to the server and optionnaly enable virtual hosting on the server:
-   -  If you already have a ssh key configured for git on your local workstation, then copy the value of the public key and paste in the dialog on dokku's web interface. If you already have a public key then you can copy the value output from the command: \\ <code>
+   -  **[t_local]** If you already have a ssh key configured for git on your local workstation, then copy the value of the public key and paste in the dialog on dokku's web interface. If you already have a public key then you can copy the value output from the command: \\ <code>
 cat ~/.ssh/id_rsa.pub
 </code>, or generate a new one using: \\ <code>
 ssh-keygen -t rsa
 </code>
-   -  Enter your domain name ''example.com'' in the corresponding dialog box
+   -  **[t_local]** Enter your domain name ''example.com'' in the corresponding dialog box.
-==== Application Setup ====
 === Application Deployment ===
@@ Line 102: / Line 117: @@
   - **[t_local]** Do a copy the ''.env.dokku.example'' file and name it ''.env.dokku'': \\ <code>
 cp .env.dokku.example .env.dokku </code> and fill out the values depending on your desired configuration: \\ <code>
-sudo nano .env.dokku </code> Then copy the file content to your clipboard.
+sudo nano .env.dokku </code> You can find an [[variables|exhaustive list of environment variables here]]. Contact an administrator if you are not sure about any variable in this file.
+  - **[t_remote]** Copy the file content to your clipboard.
   - **[t_remote]** On the remote server, paste the content at the end of the following file: ''/home/dokku/medal-data/ENV''.
   - **[t_local]** Link and deploy the server with the following git commands (replace //example.com// with your own domain name): \\ <code>
@@ Line 123: / Line 139: @@
 dokku run medal-data php artisan 2fa:authenticate_all
 </code> and confirm by typing ''yes''. For more information about Two-factor authentication, click [[administrator-guide#Two-Factor authentication|here]].
+  - **[t_remote]** If you need to export existing data from medal-//creator//, run: <code>dokku run medal-data php artisan medalc:retrieve_data</code>
+===== Domain Setup =====
+  - **[t_remote]** On your server terminal, set domain: <code>sudo dokku domains:set medal-data <domain></code> where domain is the domain for medAL-data.
+===== Setting up letsencrypt with Dokku =====
+  - **[t_remote]** On your server terminal, install letsencrypt plugin with: <code>sudo dokku plugin:install https://github.com/dokku/dokku-letsencrypt.git</code>
+  - **[t_remote]** Install certificate with <code>sudo dokku letsencrypt:enable medal-data</code>
+  - **[t_remote]** Restart the server: <code>sudo dokku ps:restart medal-data</code>
+  - Open your browser and test the system. Make sure to setup the Two-factor authentication before logging in. You should be able to login with the admin credentials using the email address //admin@dynamic.com//. Contact an administrator to know the default admin password.