########################################################################
# ilv_web 开源网站 安装手册
########################################################################
本开源网站的开发目标是跨平台网站，当前测试环境如下：
1 操作系统：Ubuntu 18.04 LST
2 压缩插件：zlib-1.2.7
3 编制语言：Python-3.3.1
4 映射软件：nginx-1.5.0
5 解析软件：uwsgi-1.9.10
6 数 据 库：mysql-5.7.29
7 数据连接：MySQLdb-1.0.9
8 视频插件：libflashplayer.so

########################################################################
# 1 基础环境设置
########################################################################
目前仅在Ubuntu 18.04 LSD 操作系统上进行了测试

    #*******************************************************************
    # 1.1 ubuntu-18.04.3-desktop-amd64
    #*******************************************************************
    具体Ubuntu-18.04-LSD安装过程就不讲，大家随便baidu一下就会了。
    
        #===============================================================
        # 1.1.1 操作系统自带的运行环境
        #===============================================================
        1. Python 3.6.8
        2. SQLite3 (内嵌在Python软件之中)

        #===============================================================
        # 1.1.2 部署git环境 (如非开发人员，此项可以跳过)
        #===============================================================
        1、安装
        =======        
        ~$ sudo apt-get update
        ~$ sudo apt-get install git
        
        2、设置必要的文件夹
        ==================
        ~$ cd /home
        /home$ sudo mkdir –p ilvbobing
        /home$ cd /home/ilvbobing
        /home/ilvbobing$ sudo chmod 777 * -R .
        最后一个命令是将我们的文件夹权限设置为公开
        
        3、克隆网站系统
        ===============
        /home/ilvbobing$ git init
        /home/ilvbobing$ git clone https://github.com/ilvbobing/ilv_web
        /home/ilvbobing$ cd /home/ilvbobing/ilv_web
        /home/ilvbobing/ilv_web$ ls
        如果上述命令均执行成功的话，此时应当能够看到网站系统下的所有文件。
        
        4、需要说的事情
        ===============
        如果不想使用git，也可从如下链接下载网站系统：
        https://github.com/ilvbobing/ilv_web
        下载之后安装在/home/ilvbobing/ilv_web下
        注意：把文件夹权限修改为777
         
        #===============================================================
        # 1.1.3 uwsgi-2.0.15-10.2ubuntu2.1
        #===============================================================
        1、安装软件
        ===========
        /home/ilvbobing/ilv_web$ sudo apt-get update
        /home/ilvbobing/ilv_web$ sudo apt-get install uwsgi
        
        2、配置文件
        ===========
        /home/ilvbobing/ilv_web$ gedit /home/ilvbobing/ilv_web.uwsgi.ini
        
        3、运行与重启uwsgi
        =================
        运行uwsgi
        /home/ilvbobing/ilv_web$ uwsgi --ini uwsgi.ini
        停止uwsgi
        /home/ilvbobing/ilv_web$ sudo pkill -9 uwsgi
        
        4、unavailable modifier requested: 0 解决办法
        ============================================
        /home/ilvbobing/ilv_web$ sudo apt-get update
        /home/ilvbobing/ilv_web$ sudo apt-get install uwsgi-plugin-python3
        同时在uwsgi的配置文件uwsgi.ini中添加参数
        plugins = python3

        #===============================================================
        # 1.1.4 nginx-1.14.0-0ubuntu1.7
        #===============================================================
        1、安装软件
        ===========
        /home/ilvbobing/ilv_web$ sudo apt-get update
        /home/ilvbobing/ilv_web$ sudo apt-get install nginx
        
        2、修改配置文件
        ==============
        /home/ilvbobing/ilv_web$ sudo cp /home/ilvbobing/ilv_web/nginx.conf /etc/nginx/nginx.conf
        注：
        1、/home/ilvbobing/ilv_web/nginx.conf 网站的nginx配置文件
        2、/etc/nginx/nginx.conf 需要被替换的nginx默认配置文件
        
        3、运行与重启nginx
        ==================       
        运行nginx：
        /home/ilvbobing/ilv_web$ sudo nginx
        停止nginx：
        /home/ilvbobing/ilv_web$ sudo pkill -9 nginx
        重启nginx：
        /home/ilvbobing/ilv_web$ sudo nginx -s restart

        #===============================================================
        # 1.1.5 mysql-5.7
        #===============================================================
        如果使用的是SQLite数据库，此项可不操作
        1、安装mysql-5.7
        ================
        /home/ilvbobing/ilv_web$ sudo apt-get update
        /home/ilvbobing/ilv_web$ sudo apt-get install mysql-server
        
        2、设置mysql在命令行中可用
        =========================
        /home/ilvbobing/ilv_web$ sudo gedit /etc/mysql/mysql.conf.d/mysqld.cnf
        在最后一行添加：skip-grant-tables，而后重启mysql
        /home/ilvbobing/ilv_web$ sudo systemctl restart mysql.service
        
        
        3、导入初始数据库
        =================
        /home/ilvbobing/ilv_web$ mysql < data/mysql/setup.sql
        
        4、安装 mysql-connector-python
        ==============================
        /home/ilvbobing/ilv_web$ sudo apt-get update
        /home/ilvbobing/ilv_web$ sudo apt-get install python3-mysql.connector
        
########################################################################
# 2 网站基本配置
########################################################################
1. path: /home/ilvbobing/ilv_web
2. Python 3.6.8
3. SQLite3
4. uwsgi 2.0.15-10
5. nginx 1.14.0