Added Apache2 Server installation guides for Admin UI and Web UI

Merge branch 'develop'
pull/57/head
13621160019@163.com 2021-07-29 13:29:18 +08:00
commit 322a1e94cc
2 changed files with 113 additions and 4 deletions

56
admin/README.md vendored
View File

@ -8,9 +8,9 @@ Providing admin panel for MyEMS system administration and configuration
nginx-1.18.0 or later nginx-1.18.0 or later
## Installation ## Option 1: Install on NGINX Server
* Install NGINX Server * Install NGINX Server
refer to http://nginx.org/en/docs/install.html refer to http://nginx.org/en/docs/install.html
@ -53,7 +53,7 @@ Add a new 'server' section with direstives as below:
} }
``` ```
* Download myems-admin * Download myems
``` ```
$ cd ~ $ cd ~
$ git clone https://github.com/MyEMS/myems.git $ git clone https://github.com/MyEMS/myems.git
@ -75,3 +75,53 @@ The 'upload' folder is for user uploaded files. DO NOT delete/move/overwrite the
``` ```
/var/www/html/admin/upload /var/www/html/admin/upload
``` ```
## Option 2: Install on Apache2 Server
* Install Apache2 Server
refer to https://httpd.apache.org/docs/2.4/install.html
* Configure Apache2
```
$ sudo vi /etc/apache2/ports.conf
```
Add a Listen
```
Listen 8001
```
```
$ sudo vi /etc/apache2/sites-available/000-default.conf
```
Add a new 'VirtualHost' as below
```
<VirtualHost 127.0.0.1:8001>
ServerAdmin MyEMS-admin
DocumentRoot /var/www/admin
<Directory "var/www/admin">
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
```
* Download myems-admin
```
$ cd ~
$ git clone https://github.com/MyEMS/myems.git
```
* Install myems-admin :
If the server can not connect to the internet, please compress the myems/admin folder and upload it to the server and extract it to ~/myems/admin
```
$ sudo cp -r ~/myems/admin /var/www/html/admin
$ sudo chmod 0755 -R /var/www/html/admin
```
Check the config file and change it if necessary:
```
$ sudo nano /var/www/html/admin/app/api.js
```

61
web/README.md vendored
View File

@ -30,7 +30,7 @@ This will create an optimized production build by compililing, merging and minif
You can run 'node server.js' to run the production build locally at http://localhost:5000. You can run 'node server.js' to run the production build locally at http://localhost:5000.
## Install Production Build on NGINX Server ## Option 1: Install Production Build on NGINX Server
* Install NGINX Server * Install NGINX Server
@ -104,3 +104,62 @@ $ sudo systemctl restart nginx
$ sudo rm -r /var/www/html/web $ sudo rm -r /var/www/html/web
$ sudo mv build /var/www/html/web $ sudo mv build /var/www/html/web
``` ```
## Option 2: Install Production Build on Apache2 Server
* Install Apache2 Server
refer to https://httpd.apache.org/docs/2.4/install.html
* Configure Apache2
```
$ sudo vi /etc/apache2/ports.conf
```
Add a Listen
```
Listen 80
```
```
$ sudo vi /etc/apache2/sites-available/000-default.conf
```
Add a new 'VirtualHost' as below
```
<VirtualHost 127.0.0.1:80>
ServerAdmin MyEMS-web
DocumentRoot /var/www/web
<Directory "var/www/web">
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/error.log
CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
```
* Download myems:
```
$ cd ~
$ git clone https://github.com/MyEMS/myems.git
```
* Install myems-web :
Check and change the config file if necessary:
```
$ cd ~/myems/web
$ sudo nano src/config.js
```
Build and Compress
```
$ cd ~/myems/web/
$ sudo npm run build
$ tar czvf myems-web.tar.gz build
```
Install
Upload the file myems-web.tar.gz to you web server.
Note that the following path should be same as that was configured in 000-default.conf
```
$ tar xzf myems-web.tar.gz
$ sudo rm -r /var/www/web
$ sudo mv build /var/www/web
```