VVS

Vaccine Visibility System

Steps to Install VVS

UBUNTU (LINUX) INSTALLATION

1. Start a terminal by pressing " Ctrl+Alt+T".
2. Make sure you have the following software installed in your system: Instalation instruction can be found here
3. GIT,
4. COMPOSER
5. PHP
6. MYSQL or SQLITE or PGSQL or SQLSRV database
7. APACHE
8. To verify that you have them installed,
9. Type " git --version" then press ENTER button
10. Type " composer --version" then press ENTER button
11. Type " php --version" then press ENTER button
12. Type " mysql --version" then press ENTER button, for other type of database, replace mysql with the corresponding type of installation.
13. Type " apache --version" then press ENTER button
14. Navigate to a directory that will contain the contents of VVS.
15. Type " cd /var/www/html" then press ENTER button
16. Clone VVS project from Github by typing the following command:
17. Type " git clone https://github.com/kelvinmbwilo/VVS" then press ENTER button
18. The content of VVS will then be copied from Github to your current directory, wait for it to complete.
19. Navigate to VVS directory
20. Type " cd VVS" then press enter
21. Give the read, write and execute access to a folder of VVS
22. Type " sudo chmod -R 777 ." then press ENTER button
23. The next step is to install dependencies of VVS.
24. Type " composer install" then press ENTER button.
25. Type " composer update" then press ENTER button.
26. Create a database called "VVS".
27. Change the username and password of a database from a file located at " VVS/config/database.php" in order to relate to your database configuration. Any text editor can be used to perform these changes. What is needed to be done is to replace the red texts (null) below with the corresponding values of the installed database configurations. The variables to change are:
28. 'database' => env('DB_DATABASE', 'null'),
29. 'username' => env('DB_USERNAME', 'null'),
30. 'password' => env('DB_PASSWORD', 'null'),
31. Under VVS directory, create the tables that will hold data of your system
32. Type " php artisan migrate" then press ENTER button
33. Generate the key:
34. Type " php artisan key:generate" then press ENTER button
35. Start using VVS
36. Start your favorite browser
37. Use this URL: SERVER_NAME /VVS/public/index.php where SERVER_NAME is the name of your server.

WINDOWS INSTALLATION

1. Install XAMPP or WAMP server
2. Make sure you have the following software installed in your system:
3. COMPOSER
4. WINRAR
5. Download the ZIP folder of VVS project from the link: https://github.com/kelvinmbwilo/VVS
6. Unzip the contents of downloaded VVS files in XAMPP installation directory " **xampp\htdocs**"
7. For WAMP, unzip the files in " **wamp\www**" directory
8. The name of the unzipped file will be " VVS-master", rename it to " VVS"
9. Start XAMPP server, specifically APACHE module and MYSQL module.
10. Create a database called "VVS".
11. Change the username and password of a database from a file located at " VVS/config/database.php" in order to relate to your database configuration. Any text editor can be used to perform these changes. What is needed to be done is to replace the red texts (null) below with the corresponding values of the installed database configurations. The variables to change are:
12. 'database' => env('DB_DATABASE', 'null'),
13. 'username' => env('DB_USERNAME', 'null'),
14. 'password' => env('DB_PASSWORD', 'null'),
15. Navigate to VVS directory
16. Search for " cmd" or " Command Prompt" on a search field of a window then open it.
17. Navigate to VVS folder. NOTE: a directory is changed by typing "cd" command which stands for change directory. Let's take a look at this example; The directory of VVS can be located at " C:\Program Files\xampp\htdocs\VVS", now assume that you are in " C:\Users\Mimi" directory. How to navigate to reach a "VVS" directory from "Mimi" directory? 1. First, go two steps back by typing " cd .." twice, press ENTER button each time. This will take you to " **C:**" directory 2. Then navigate to VVS by typing ' cd "Program Files\xampp\htdocs\VVS"', press ENTER button once you type the whole directory
18. The next step is to install dependencies of VVS.
19. Type " composer install" then press ENTER button.
20. Type " composer update" then press ENTER button.
21. Under VVS directory, create the tables that will hold data of your system
22. Type " php artisan migrate" then press ENTER button
23. Generate the key:
24. Type " php artisan key:generate" then press ENTER button
25. Start using VVS
26. Start your favorite browser
27. Use this URL: SERVER_NAME /VVS/public/index.php where SERVER_NAME is the name of your server.

MAC INSTALLATION

1. Install XAMPP or WAMP server you can use the installation instruction from here

2. Make sure you have the following software installed in your system:

3. COMPOSER

4. Download the ZIP folder of VVS project from the link: https://github.com/kelvinmbwilo/VVS

5. Unzip the contents of downloaded VVS files in XAMPP installation directory " **xampp\htdocs**"

6. For WAMP, unzip the files in " **wamp\www**" directory

7. The name of the unzipped file will be " VVS-master", rename it to " VVS"

8. Start XAMPP server, specifically APACHE module and MYSQL module.

9. Create a database called "VVS".

10. Change the username and password of a database from a file located at " VVS/config/database.php" in order to relate to your database configuration. Any text editor can be used to perform these changes. What is needed to be done is to replace the red texts (null) below with the corresponding values of the installed database configurations. The variables to change are:

11. 'database' => env('DB_DATABASE', 'null'),

12. 'username' => env('DB_USERNAME', 'null'),

13. 'password' => env('DB_PASSWORD', 'null'),

14. Navigate to VVS directory

15. Search for " cmd" or " Command Prompt" on a search field of a window then open it.

16. Navigate to VVS folder. NOTE: a directory is changed by typing "cd" command which stands for change directory. Let's take a look at this example; The directory of VVS can be located at " C:\Program Files\xampp\htdocs\VVS", now assume that you are in " C:\Users\Mimi" directory. How to navigate to reach a "VVS" directory from "Mimi" directory? 1. First, go two steps back by typing " cd .." twice, press ENTER button each time. This will take you to " **C:**" directory 2. Then navigate to VVS by typing ' cd "Program Files\xampp\htdocs\VVS"', press ENTER button once you type the whole directory

17. The next step is to install dependencies of VVS.

18. Type " composer install" then press ENTER button.

19. Type " composer update" then press ENTER button.

20. Under VVS directory, create the tables that will hold data of your system

21. Type " php artisan migrate" then press ENTER button

22. Generate the key:

23. Type " php artisan key:generate" then press ENTER button

24. Start using VVS

25. Start your favorite browser

26. Use this URL: SERVER_NAME /VVS/public/index.php where SERVER_NAME is the name of your server.