# Server Installation

---

- [Introduction](#section-1)
- [Installation Requirements](#section-2)
- [Install Apache](#section-5)
- [Install PHP](#section-6)
- [Install mysql](#section-7)
- [Install phpmyadmin](#section-8)
- [Install composer](#section-9)
- [Install Jenkins](#section-10)
- [Setup Laravel Supervisor](#section-12)

<a name="section-1"></a>
## Introduction

We are strongly prefer any Server with ubuntu OS. Because it is quite easy to setup and maintain.

* Minimum Server Requirements
    * Any server with UBUNTU Preferred
    * 4 GB Ram
    * 30 GB Storage
    * vCPU 2 cores

<a name="section-2"></a>
## Installation Requirements

1. Apache
2. PHP7.2
3. mysql
4. phpmyadmin
5. composer
6. Jenkins/FTP
7. Laravel Supervisor


<a name="section-3"></a>

<a name="section-5"></a>
## 3. Install Apache

* Open the ssh terminal using pemfile of your aws instance

* Run "sudo apt install apache2" to install an apache2

* Run "sudo apt update"

* Run "sudo nano /etc/apache2/sites-available/000-default.conf" to edit the config follow next step.

*  <Directory /var/www/html>

                Options -Indexes
                AllowOverride All
                Require all granted
                ErrorDocument 403 "You Don't have a permission to access this URL"
                ErrorDocument 404 "Requesting Page not Found. Contact admin for further details"
          </Directory>
* Run "sudo service apache2 restart" to restart the apache2.

* Reference Link : https://www.digitalocean.com/community/tutorials/how-to-install-the-apache-web-server-on-ubuntu-20-04

<a name="section-6"></a>
## 4.Install PHP7.2
Please follow the instrctions from the reference link below. And Install the php extensions below.
<strong>bcmath,bz2,intl,gd,mbstring,mysql,zip,fpm,curl,xml</strong>

Reference Link : https://computingforgeeks.com/how-to-install-php-on-ubuntu/

<a name="section-7"></a>
## 5.Install mysql
Run the below commands one by one

*  sudo apt-get update
* sudo apt-get install mysql-server
* mysql_secure_installation
* sudo service mysql restart

To create a new user for mysql

* sudo mysql -u root
* use mysql;
* GRANT ALL ON *.* TO 'taxi_user'@'%' IDENTIFIED BY 'TaxiUser@123' WITH GRANT OPTION;
* FLUSH PRIVILEGES;

Reference Link : https://www.digitalocean.com/community/tutorials/how-to-install-mysql-on-ubuntu-20-04

<a name="section-8"></a>
## 6. Install phpmyadmin

Open the path "var/www/html". and dowonload the phpmyadmin package using below command.

 "sudo wget https://files.phpmyadmin.net/phpMyAdmin/5.0.1/phpMyAdmin-5.0.1-all-languages.zip"

Unzip the downloaded package and rename it to "pma".

<a name="section-9"></a>
## 7. Install composer

Please follow the instructions from the reference link below.


Reference Link: https://www.digitalocean.com/community/tutorials/how-to-install-and-use-composer-on-ubuntu-20-04

<a name="section-10"> </a>
## 8.Install Jenkins (Optional if you want to use ftp)

* jenkins is used to upload the backend app code to the server via git repo.

* To install jenkins you need to install JAVA. to install java run this command "sudo apt install openjdk-8-jdk
".

Follow the instructions from the reference link below. and skip the firewal setup.

Reference Link: https://www.digitalocean.com/community/tutorials/how-to-install-jenkins-on-ubuntu-16-04

### 8.1 Install FTP

* Follow the below instructions to install ftp on ubntu server

1. install vsftpd - <strong>sudo apt install vsftpd</strong>

2. take backup of config file by following command <strong>sudo cp /etc/vsftpd.conf /etc/vsftpd.conf.bak</strong>

3. edit vsftpd.conf by following command <strong>sudo nano /etc/vsftpd.conf<strong> and add the below lines at bottom of the file and save the file.

```php
listen=NO
listen_ipv6=YES
anonymous_enable=NO
local_enable=YES
dirmessage_enable=YES
write_enable=YES
chroot_local_user=YES
pasv_min_port=12000
pasv_max_port=12100
ssl_enable=NO
port_enable=YES
allow_writeable_chroot=YES
```

4. restart vsftpd - <strong>sudo systemctl restart vsftpd</strong>

5. Create Ftp User by folowing command - <strong> sudo adduser ftp_user</strong>

6. assign directory to user - <strong> sudo usermod -d /var/www/html ftp_user</strong>

7. add user to www-data group <strong> sudo usermod -aG www-data ftp_user </strong>

8. change directory owners - <strong> cd /var/www - sudo chown -R ftp_user:www-data html/</strong>

9. change readwrite permissions - <strong>sudo chmod -R 775 html/ </strong>

<a name="section-12"> </a>
## 9. Setup Laravel Supervisor

* Follow the below steps for setup the laravel supervisor

1. sudo apt-get install supervisor

2. sudo nano /etc/supervisor/conf.d/laravel-worker.conf

3. Paste the below lines in that file

```php
[program:laravel-worker]
process_name=%(program_name)s_%(process_num)02d
command=php /var/www/html/project-name/artisan queue:work --sleep=3 --tries=3
autostart=true
autorestart=true
user=ubuntu
numprocs=8
redirect_stderr=true
stdout_logfile=/var/www/html/project-name/worker.log
stopwaitsecs=3600
```

<strong>Note:user can be ubuntu/root & project name should be yours</strong>

4. sudo supervisorctl reread

5. sudo supervisorctl update

6. sudo supervisorctl start laravel-worker:*

Reference Link: https://laravel.com/docs/8.x/queues#supervisor-configuration