Differences

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

--- medal-data:system-setup [2022/01/17 14:29] – created arnaudpoletto
+++ medal-data:system-setup [2022/01/19 09:39] (current) – removed arnaudpoletto
@@ Line 1: / Line 1: @@
-====== Setup of medAL-data System ======
-===== Purpose and scope =====
-In this document, you will learn how to perform the basic setup of the MainData System.
-===== Responsibilities and Procedures =====
-  - Basic requirements
-    * Server Linux =8gb ram
-    * Storage= 300 gb
-    * Operating System = ubuntu 18.04
-  - Software Requirements.
-    * Docker
-      - check if docker is installed in the server by typing on the terminal “docker”
-      - If not Installed open command line (ubuntu terminal)
-      - Type “sudo apt update” to update ubuntu server
-      - Install a few prerequisite packages which let apt use packages over HTTPS by typing “sudo apt install apt-transport-https ca-certificates curl software-properties-common”
-      - add the GPG key for the official Docker repository to your system by typing “curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -“
-      - Add the Docker repository to APT sources “sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu bionic stable"”
-      - Update the package database with the Docker packages from the newly added repo “sudo apt update”
-      - Make sure you are about to install from the Docker repo instead of the default Ubuntu repo “apt-cache policy docker-ce”
-      - Finally, install Docker “sudo apt install docker-ce”
-      - Docker should now be installed, the daemon started, and the process enabled to start on boot. Check that it’s running “sudo systemctl status docker”
-      - 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)
-    * Nginx
-      - Check if nginx is installed on the server by typing in the terminal “systemctl status nginx”
-      - If it is not installed open terminal
-      - Install nginx “sudo apt install nginx”
-      - Enable nginx in the firewall by typing “sudo ufw allow 'Nginx Full'
-    * Dokku
-      - Check if Dokku is installed on the server by typing in the terminal “dokku -v”
-      - If it is not installed open terminal
-      - Install dokku “wget https://raw.githubusercontent.com/dokku/dokku/v0.21.4/bootstrap.sh;
-sudo DOKKU_TAG=v0.21.4 bash bootstrap.sh”
-      - Once the installation is complete, you can open a browser to setup your SSH key and virtualhost settings.
-      - Open your browser of choice and navigate to the host's IP address - or the domain you assigned to that IP previously - and configure Dokku via the web admin.
-    * Installation of MainData.
--	Requirements
-•	You must have the MainData Project folder
-•	Git must be installed on your laptop
--	Installation steps
-.	Open command prompt (for windows) or terminal (for Linux and Mac)
-.	Navigate to the MainData project folder (Parent Diretory). (Let’s call this user terminal)
-.	Open another terminal/ Command Prompt and log into the server as root (let’s call it Server terminal)
-.	On the Server terminal, create an app by “	”
-.	Specify the web server type that will be running “echo 'web: vendor/bin/heroku-php-apache2 public/' >> Procfile”
-.	On you user terminal,initialize git "git init”
-.	Add the project to git “git add. /”
-.	Connect local git with the domain “git remote add dokku dokku@your_domain: Main-Data”.Your_domain means the domain of the server
-.	Commit to git “git commit -m "Initial commit"”
-.	For the registration of the app on dokku Server, copy the value of APP_KEY variable in the .env file located in the root directory of your Laravel Project. Then, login to your VPS and register the APP_KEY environmental variable for your app “dokku config:set blog APP_KEY={{ key }}”.Replace key with the actual APP_KEY
-.	Push the application on dokku with “git push dokku master”
-.	Install the postgres plugin “sudo dokku plugin:install https://github.com/dokku/dokku-postgres.git postgres”
-.	Create database “dokku mysql:create main-data-Db”
-.	Link database service to our application “dokku mysql:link main-data-Db Main-Data”
-.	Type “dokku mysql:info blogdb –dsn” and obtain the value from that and type in “dokku config:set blog DATABASE_URL={{ value }}” with value as the value above
-.	go back to your application on local, and modify the config/database.php file in such a way that the postgres section looks like below
-.	on the user terminal “git add ./”
-.	commit “git commit -m "Modified config/database.php file"”
-.	push the commit “git push dokku master”
-.	finally migrate the database “dokku run Main-Data php artisan migrate”
-.	Domain set up
-.	On Your Server Terminal
-.	Set domain “sudo domains:set Main-Data {{domain}}” where domain is the domain for MainData
--	Setting up letsencrypt with Dokku
-.	On your Server Terminal.Install letsencrypt plugin with “sudo dokku plugin:install https://github.com/dokku/dokku-letsencrypt.git”
-.	Install certificate with “sudo dokku letsencrypt Main-Data”
-.	Open your browser and test the system
--	Creating an Admin
-.	On your server terminal “sudo dokku run Main-Data php artisan tinker”
-.	Type “$user=new User;” for a new user object
-.	Type “$user->name=”{{user_name}}”;” for the ADMIN name
-.	Type “$user->email=”{{user_email}}”;” for the ADMIN email
-.	Type “$user->password=Hash::make(“{{user_password}}”);” for the ADMIN password
-.	Type “$user->syncRoles(“ADMIN”);” To make this user an admin
-.	Try to access the web and log in with this user in the system
-Administrative information
-	Name	Signature	Date
-Author	Ibrahim Evans		12.11.2020
-Revised by
-Approved by
-Document change control:
-Version	Changes	Name	Date
-	New Document	Ibrahim Evans	12.11.2020
-Distribution of SOP:
-Name	Role	Health facility / Institute	Date
-*Note: When printing and distributing the SOP, the administrative information page does not need to be included.