2020年11月

安装文档

由于Redash采用互联网技术开发，目前尚不支持直接运行在Windows系统上，Windows操作系统只能借助虚拟机（VMware）或Linux子系统(WSL2)方式来安装。

1、Windows虚拟机安装Ubuntu环境：适用于Windows的xp、7、10和Server各版本。
2、单机Ubuntu环境或双系统：以Ubuntu20.04为例
3、Windows的Linux子系统安装方式：适用于Windows 10 和Windows Server 2019。

注意：创建ubuntu用户名，建议不要使用-_*等特殊字符。

1、Windows和VMware Workstation 15 Pro环境

windows各版本安装VMWare workstartion 15 Pro，请参考：https://jingyan.baidu.com/article/358570f685c41ace4724fc3a.html 很详细。

安装好VMWare后，创建Ubunt20.04虚拟机，请参考：https://www.linuxidc.com/Linux/2020-03/162547.htm

2、Ubuntu20.04单机或双系统

PC上安装Ubuntu20.04，请参考：https://jingyan.baidu.com/article/ca41422ffd05005faf99ed39.html

安装双系统，请参考：https://www.cnblogs.com/ubuntuanzhuang/p/windows10ubuntu.html

重要：上述两种环境Ubuntu安装完成后，配置好中文环境和输入法，所需准备工作基本就完成了。后续需要决定在Ubuntu20.04系统上，是以Docker方式安装还是以单机方式安装中文版Redash。如果只是学习操作使用，建议以Docker方式，相对安装难度要小一些，请参考链接《安装2：Ubuntu20.04和Docker环境下安装Redash中文版》；如果是研习代码学习开发，建议以单机方式安装，请参考链接《安装3：Ubuntu20.04本地安装Redash中文版》。

3、Windows 10的Linux子系统

Windows10下启用ubuntu20.04子系统，请参考：

https://docs.microsoft.com/zh-cn/windows/wsl/install-win10

观看教学视频

Windows Server 2019下启用ubuntu20.04子系统，请参考：

https://docs.microsoft.com/zh-cn/windows/wsl/install-on-server

重要：由于WSL2子系统方式，和虚拟机安装的Ubuntu或单机安装的Ubuntu差异都较大，因此单独一篇文章详细描述其安装过程，请见链接《安装4：Win10的WSL2之Ubuntu20.04和Docker环境下安装Redash中文版》

Docker环境下安装Redash中文版

相比Linux环境本地安装而言，Docker安装方式更为简便，Docker脚本化安装过程会自动获取Redis、postgres、Python3.7镜像，构造Redash最新的后台server、worker、schedule镜像。前端npm依赖包安装和前端最新代码打包是通过卷映射方式挂载到server容器，因此这些工作需要人工一次执行；另外构建初始数据库表结构也需要人工一次执行。这些动作执行完毕，启动Docker容器就可以访问了。由于安装过程需要访问国外服务器，极难一次安装成功。因此建议普通用户下载百度网盘的虚拟机挂载方式更快捷。

下载：百度网盘vmware虚拟机(提取码：1234)

1、安装基础环境：

1)、更换APT国内源：

sudo sed -i s@/archive.ubuntu.com/@/mirrors.aliyun.com/@g /etc/apt/sources.list

2)、更新源：

sudo apt update && sudo apt upgrade -y

3)、安装Docker和Docker-Compose：

sudo apt install docker docker-compose -y

4)、更换Docker国内源：

sudo tee /etc/docker/daemon.json <<-'EOF'

{

"registry-mirrors": ["http://hub-mirror.c.163.com"]

}

EOF

5)、重启Docker服务：

sudo systemctl restart dockerdocker-compose up -d

2、导入Docker镜像：
1）、下载镜像： 见上方下载链接
2）、导入镜像
docker load < xxxx.img
3）、查看镜像id
docker image ls
4）、修改docker-compose.yml 中的各个镜像的id

3、后台启动Docker容器:

1）、在docker-compose.yml 文件所在的目录拉起服务
sudo docker-compose up -d
2）、初始化数据库表结构：
 sudo docker-compose run --rm server create_db

4、redash日常维护：
启动Docker容器：
sudo docker-compose start
若要停止Docker容器：
sudo docker-compose stop
进入浏览器：
http://localhost:5000
初次使用：
请见《初始配置Redash中文版》
后续使用：
注意一定先执行cd redash后，再执行sudo docker-compose start以启动docker容器。

Ubuntu20.04安装Redash中文版

Redash中文版本地安装方式比较繁琐，需要具备一定的linux基础知识，主要适用于试用或用于开发的基础环境；同时由于安装过程需要访问国外服务器，极难一次安装成功。因此建议普通用户下载百度网盘的虚拟机挂载方式更快捷。在准备好Ubuntu20.04中文版环境后，就可以开始以本地方式安装Redash中文版。本安装过程是基于Ubuntu20.04的内置Python3.8的，如果安装了多版本Python,一些底层库可能需要下载源码重新编译，比较繁琐，因此不建议在多版本Python环境下安装Redash中文版。另外：Ubuntu20.04安装后，一定要更换本地源(可以在桌面设置“软件和更新”里选择或执行命令 sudo sed -i s@/archive.ubuntu.com/@/mirrors.aliyun.com/@g /etc/apt/sources.list) 并注意执行sudo apt-get update && sudo apt-get upgrade；最好还要设置root密码：sudo passwd root和当前用户加入sudo组sudo usermod -aG sudo 当前ubuntu用户名。Ubuntu20.04内置Python3.8.2。

下载：百度网盘vmware虚拟机(提取码：1234)

1、基础环境安装
1）、安装git：sudo apt install git
2）、安装Python3的Pip：这是python官方的包管理工具属于是python的一部分，负责下载安装python的包文件
sudo apt install python3-pip
3）、安装nodejs和npm：nodejs是js文件的一种运行环境，npm是nodejs的包管理器。
sudo apt install nodejs npm
4）、更换npm国内源:
sudo npm config set registry https://registry.npm.taobao.org
验证:sudo npm config get registry
5）、安装nodejs版本管理器：负责nodejs的版本问题方便后续更新
sudo npm install n -g
6）、升级nodejs最新版本：
sudo n stable
7）、安装Redis：处理redash中文版缓存消息队列,以及处理发布订阅
sudo apt install redis-server
2、Postgresql9.6安装配置：
Redash使用postgresql作为查询结果缓存和定义信息、运行数据等的存储数据库。
1）、安装基础包：sudo apt install wget ca-certificates
2）、加载源：
sudo sh -c 'echo "deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'
3）、下载证书：
wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -
4）、刷新源：sudo apt-get update
5）、安装Postgre9.6：
sudo apt install postgresql-9.6 postgresql-contrib-9.6 postgresql-client-9.6 libpq-dev -y
6）、登录Postgresql：sudo -u postgres psql
7）、在postgresql终端执行：
alter user postgres with password ‘密码’;create role 当前ubuntu用户名;alter role 当前ubuntu用户 login;
(注意postgresql命令语句以分号结束)
8）、退出postgresql终端：\q
3、安装和初始化
1）、下载代码：git clone https://github.com/dazdata/redash.git
2）、进入工作目录：cd redash
3）、安装npm依赖包：npm install
4）、前端打包：npm run build
5）、配置pip国内源：sudo cp pip.conf /etc/pip.conf
6）、安装Python虚拟环境：sudo pip3 install virtualenv
7）、创建Python虚拟环境：virtualenv -p python3 venv
8）、激活Python虚拟环境：source venv/bin/activate
9）、安装pip包：pip3 install -r requirements.txt -r requirements_dev.txt
10）、Python3.8安装pip包：pip3 install importlib_resources==1.5
11）、若需要支持Oracle数据源，先安装Oracle客户端程序，后执行：
pip install -r requirements_oracle_ds.txt (试用建议不安装)
12）、若需要支持mysql，请先启动一个新的命令行终端，执行：
sudo apt install default-libmysqlclient-dev (试用建议不安装)
13）再回到当前命令行终端执行 (试用建议不安装)：
pip install mysqlclient
14）、若需要其它数据源：pip install -r requirements_all_ds.txt (试用建议不安装)
15）、初化数据库表结构：./manage.py database create_tables
16）、退出虚拟环境，安装完成：deactivate
4、启动和配置
1）、启动服务：
分别打开三个终端，都执行cd redash进入目录后分别执行下列三命令之一：
source venv/bin/activate
./manage.py runserver --debugger --reload
和
source venv/bin/activate
./manage.py rq worker
和
source venv/bin/activate
./manage.py rq scheduler
2）、每次终端启动运行一个服务。若需要停止服务，直接按Ctrl+C键，执行 deactivate退出python虚拟环境。
进入浏览器：http://localhost:5000

安装Docker环境

WSL2下安装好Ubuntu后，就可以安装Docker了。Docker安装后，其自动化安装脚本会自动获取Redis、postgres、Python3.7镜像，自动构造Redash最新的后台server、worker、schedule镜像。只有两个环节需要人工执行：前端npm依赖包安装和前端最新代码打包是通过卷映射方式挂载到server容器，这些工作需要人工一次执行；另外构建初始数据库表结构也需要人工一次执行。

1、安装windows的Docker客户端：

先要在Windows上安装Docker Desktop For Windows客户端软件，请从docker.com官网下载安装。安装后在Windows系统托盘找到docker图标，点击选择settings菜单，勾选“Expose daemon on tcp://localhost:2375 without TLS”即可参见链接《WSL上使用docker遇到问题解决》

2、进入WSL安装Docker服务端：

1）、进入WSL：
以管理员方式启动Power Shell,进入终端后输入wsl命令，切换进入ubuntu终端，执行cd ~命令进入到Ubuntu主目录。

2）、更换APT国内源：
sudo sed -i s@/archive.ubuntu.com/@/mirrors.aliyun.com/@g /etc/apt/sources.list
3）、更新源：
sudo apt update && sudo apt upgrade -y
4）、安装Docker-CE依赖包：
sudo apt-get install apt-transport-https ca-certificates curl gnupg-agent software-properties-common -y
5）、获取Docker-CE源密钥：
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -
6）、获取Docker-CE源：
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

7）、更新源并安装Docker-CE：
sudo apt update && sudo apt install docker-ce docker-compose -y

8）、更换Docker国内源：

sudo tee /etc/docker/daemon.json << EOF
{
"registry-mirrors": ["http://registry.docker-cn.com"]
}
EOF

9）、重启Docker服务：
sudo systemctl restart docker

10）、安装Nodejs和npm：
sudo apt install nodejs npm -y

11）、获取Nodejs最新版本：
sudo npm install n -g && sudo n stable

2、启动Docker自动安装执行：

1）、下载源码：
git clone https://github.com/dazdata/redash.git && cd redash

2）、Docker安装(若不成功需要重来多试几次)：
sudo docker-compose up

3、自动安装后处理：

1）、更换npm国内源：
npm config set registry https://registry.npm.taobao.org

2）、前端npm依赖包安装(警告可以忽略，若报错需要重来多试几次)：
npm install

3）、前端打包：
npm run build

4）、初始化数据库表结构：
sudo docker-compose run --rm server create_db

4、启动系统&初始设置：

1）、启动Docker容器：
sudo docker-compose start
若要停止Docker容器：
sudo docker-compose stop

2）、进入浏览器：
http://localhost:5000

3）、初次使用：
请见《初始配置Redash中文版》

4）、后续使用：
注意一定要用管理员打开PowerShell后执行wsl命令，再执行cd ~和cd redash后，再执行sudo docker-compose start以启动docker容器。

CentOS7安装Redash中文版

Centos7内置的Python版本为Python2，Redash中文版是在Python3基础上的安装。所以需要安装Python3版本.以下是安装步骤:

视频：本文详细视频教程(bilibili)

下载：百度网盘(提取码：1234)

1.初始化

(1)进入源文件目录下:
cd /etc/yum.repos.d/
(2)备份原版本yum文件:
sudo mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup
(3)下载阿里yum源文件作为默认源文件:
sudo wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo
(4)清理原缓存:
sudo yum clean all
(5)建立缓存以后方便缓存中搜索:
sudo yum makecache
(6)更新系统包:
sudo yum update -y
(7)安装常用包:
sudo yum -y install gcc gcc-c++ kernel-devel make zlib zlib-devel libffi-devel openssl-devel git python3-devel postgresql-devel*
(8)进入root用户下修改当前用户添加到root组：
su -
sudo usermod -g root 当前centos用户名

2、安装PostgreSql9.6

(1)安装postgresql源:
sudo yum install -y https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-7-x86_64/pgdg-redhat-repo-42.0-11.noarch.rpm
(2)安装postgresql6客户端:
sudo yum install -y postgresql96
(3)安装postgresql6服务端:
sudo yum install -y postgresql96-server
(4)初始化:
sudo /usr/pgsql-9.6/bin/postgresql96-setup initdb
(5)设置开机自启:
sudo systemctl enable postgresql-9.6
(6)启动postgresql9.6服务:
sudo systemctl start postgresql-9.6
(7)进入postgresql数据库修改用户名密码:
1.sudo -u postgres psql
2.alter user postgres with password ‘此处填写登陆密码’;
3.create role 当前centos用户名;
4.alter role 当前centos用户名 login;
5.\q

3、安装Redis

(1)下载fedora的epel仓库:
sudo yum install epel-release -y
(2)安装:
sudo yum install redis
(3)启动redis:
sudo systemctl start redis
(4)设置开机自启:
sudo systemctl enable redis.service

4.安装Python3

(1)sudo yum -y groupinstall “Development tools”
(2)sudo yum -y install zlib-devel
 bzip2-devel openssl-devel ncurses-devel sqlite-devel 
readline-devel tk-devel gdbm-devel db4-devel libpcap-devel xz-devel python3-devel
(3)sudo wget https://www.python.org/ftp/python/3.6.2/Python-3.6.2.tar.xz
(4)sudo mkdir /usr/local/python3
(5)tar -xvJf Python-3.6.2.tar.xz
(6)cd Python-3.6.2
(7)./configure --prefix=/usr/local/python3
(8)sudo make && sudo make install
(9)添加环境变量:
sudo vi /etc/profile
将下面内容添加到文件的最下面
PATH=$PATH:/usr/local/python3/bin
随后使环境变量生效
source /etc/profile

5、安装Redash中文版

1）、下载代码：git clone https://github.com/dazdata/redash.git
2）、进入工作目录：cd redash

***************注意***************

redash前端资源安装方式有两种:
第一种:下载前端资源压缩包dist.zip,
将其上传到redash工作目录~/redash/client/下,随后解压至当前目录即可.

第二种:下载前端源码按照以下步骤:
安装nodejs和npm：
sudo apt install nodejs npm
更换npm国内源：
npm config set registry https://registry.npm.taobao.org
安装nodejs版本管理器：
sudo npm install n -g
升级nodejs最新版本：
sudo n stable
安装npm依赖包：
npm install
前端打包：
npm run build

********************************

3）、配置pip国内源：sudo cp pip.conf /etc/pip.conf
4）、安装Python虚拟环境：sudo pip3 install virtualenv
5）、创建Python虚拟环境：virtualenv -p python3 venv
6）、激活Python虚拟环境：source venv/bin/activate
7）、安装pip包：pip3 install -r requirements.txt -r requirements_dev.txt
8）、Python3.8安装pip包：pip3 install importlib_resources==1.5
9）、初化数据库表结构：./manage.py database create_tables
10）、退出虚拟环境，安装完成：deactivate

6.启动

分别打开三个终端，都执行cd redash进入目录后分别执行下列三个命令之一：
source venv/bin/activate
./manage.py runserver --debugger --reload
和
source venv/bin/activate
./manage.py rq worker
和
source venv/bin/activate
./manage.py rq scheduler

打开浏览器，输入地址：http://localhost:5000

CentOS7安装Redash中文版

Centos7内置的Python版本为Python2，Redash中文版是在Python3基础上的安装。所以需要安装Python3版本.以下是安装步骤:

视频：本文详细视频教程(bilibili)

下载：百度网盘(提取码：1234)

1.初始化

(1)进入源文件目录下:
cd /etc/yum.repos.d/
(2)备份原版本yum文件:
sudo mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup
(3)下载阿里yum源文件作为默认源文件:
sudo wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-7.repo
(4)清理原缓存:
sudo yum clean all
(5)建立缓存以后方便缓存中搜索:
sudo yum makecache
(6)更新系统包:
sudo yum update -y
(7)安装常用包:
sudo yum -y install gcc gcc-c++ kernel-devel make zlib zlib-devel libffi-devel
 openssl-devel git python3-devel postgresql-devel*
(8)进入root用户下修改当前用户添加到root组：
su -
sudo usermod -g root 当前centos用户名

2、安装PostgreSql9.6

(1)安装postgresql源:
sudo yum install -y https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-7-x86_64/pgdg-redhat-repo-42.0-11.noarch.rpm
(2)安装postgresql6客户端:
sudo yum install -y postgresql96
(3)安装postgresql6服务端:
sudo yum install -y postgresql96-server
(4)初始化:
sudo /usr/pgsql-9.6/bin/postgresql96-setup initdb
(5)设置开机自启:
sudo systemctl enable postgresql-9.6
(6)启动postgresql9.6服务:
sudo systemctl start postgresql-9.6
(7)进入postgresql数据库修改用户名密码:
1.sudo -u postgres psql
2.alter user postgres with password ‘此处填写登陆密码’;
3.create role 当前centos用户名;
4.alter role 当前centos用户名 login;
5.\q

3、安装Redis

(1)下载fedora的epel仓库:
sudo yum install epel-release -y
(2)安装:
sudo yum install redis
(3)启动redis:
sudo systemctl start redis
(4)设置开机自启:
sudo systemctl enable redis.service

4.安装Python3

(1)sudo yum -y groupinstall “Development tools”
(2)sudo yum -y install zlib-devel
 bzip2-devel openssl-devel ncurses-devel sqlite-devel 
readline-devel tk-devel gdbm-devel db4-devel libpcap-devel xz-devel python3-devel
(3)sudo wget https://www.python.org/ftp/python/3.6.2/Python-3.6.2.tar.xz
(4)sudo mkdir /usr/local/python3
(5)tar -xvJf Python-3.6.2.tar.xz
(6)cd Python-3.6.2
(7)./configure --prefix=/usr/local/python3
(8)sudo make && sudo make install
(9)添加环境变量:
sudo vi /etc/profile
将下面内容添加到文件的最下面
PATH=$PATH:/usr/local/python3/bin
随后使环境变量生效
source /etc/profile

5、安装Redash中文版

1）、下载代码：git clone https://github.com/dazdata/redash.git
2）、进入工作目录：cd redash

***************注意***************

redash前端资源安装方式有两种:
第一种:下载前端资源压缩包dist.zip,
将其上传到redash工作目录~/redash/client/下,随后解压至当前目录即可.

第二种:下载前端源码按照以下步骤:
安装nodejs和npm：
sudo apt install nodejs npm
更换npm国内源：
npm config set registry https://registry.npm.taobao.org
安装nodejs版本管理器：
sudo npm install n -g
升级nodejs最新版本：
sudo n stable
安装npm依赖包：
npm install
前端打包：
npm run build

********************************

3）、配置pip国内源：sudo cp pip.conf /etc/pip.conf
4）、安装Python虚拟环境：sudo pip3 install virtualenv
5）、创建Python虚拟环境：virtualenv -p python3 venv
6）、激活Python虚拟环境：source venv/bin/activate
7）、安装pip包：pip3 install -r requirements.txt -r requirements_dev.txt
8）、Python3.8安装pip包：pip3 install importlib_resources==1.5
9）、初化数据库表结构：./manage.py database create_tables
10）、退出虚拟环境，安装完成：deactivate

6.启动

分别打开三个终端，都执行cd redash进入目录后分别执行下列三个命令之一：
source venv/bin/activate
./manage.py runserver --debugger --reload
和
source venv/bin/activate
./manage.py rq worker
和
source venv/bin/activate
./manage.py rq scheduler

打开浏览器，输入地址：http://localhost:5000

CentOS8安装Redash中文版

Centos8内置的Python为3.6.8版本，以下是在内置Python3.6.8基础上的安装步骤。由于安装多版本Python会导致系统底层库需要下载源码重新编译，比较麻烦，不建议在多版本Python环境下安装Redash中文版。

视频：本文详细视频教程(bilibili) 下载：百度网盘(提取码：1234)

1、初始化

由于Centos使用yum下载源,需要更改成国内源:
1)、进入设置yum源目录下：
cd /etc/yum.repos.d/
2)、下载自动下载文件工具wget：
sudo yum install wget
3）、将yum源文件备份一下：
sudo mv /etc/yum.repos.d/CentOS-Base.repo /etc/yum.repos.d/CentOS-Base.repo.backup
4）、下载阿里yum源：
sudo wget -O /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-8.repo
5）、清理原缓存：
sudo yum clean all
6）、建立缓存以后方便缓存中搜索：
sudo yum makecache
7）、更新系统包：
sudo yum update -y
8）、安装常用包：
sudo yum -y install gcc gcc-c++ kernel-devel make zlib zlib-devel libffi-devel openssl-devel python3-devel git
9）、安装dnf:
sudo yum install dnf -y
10）、进入root用户下将当前用户添加到root组：
su -
usermod -g root 当前centos用户名

2、安装PostgreSql9.6

安装PostgreSql9.6初始化并配置为系统启动时自动启动：
sudo dnf install @postgresql:9.6
sudo dnf install postgresql-contrib
sudo yum install postgresql-devel
sudo postgresql-setup initdb
sudo systemctl enable --now postgresql
登录Postgresql:
sudo -u postgres psql
更改postges密码：
alter user postgres with password ‘密码’;
创建角色：
create role 当前centos用户名;
赋予登录权限：
alter role 当前centos用户名 login;
退出postgresql终端：
\q

3、安装Redis

sudo yum install redis
sudo systemctl start redis
sudo systemctl enable redis.service

4、安装Redash中文版

1）、下载代码：git clone https://github.com/dazdata/redash.git
2）、进入工作目录：cd redash

***************注意***************

redash前端资源安装方式有两种:
第一种:下载前端资源压缩包dist.zip,将其上传到redash工作目录~/redash/client/下,随后解压至当前目录即可.

第二种:下载前端源码按照以下步骤:
安装nodejs和npm：
sudo yum install nodejs npm
更换npm国内源：
npm config set registry https://registry.npm.taobao.org
安装nodejs版本管理器：
sudo npm install n -g
升级nodejs最新版本：
sudo n stable
安装npm依赖包：
npm install
前端打包：
npm run build

********************************

3）、配置pip国内源：sudo cp pip.conf /etc/pip.conf
4）、安装Python虚拟环境：sudo pip3 install virtualenv
5）、创建Python虚拟环境：virtualenv -p python3 venv
6）、激活Python虚拟环境：source venv/bin/activate
7）、安装pip包：pip3 install -r requirements.txt -r requirements_dev.txt
8）、Python3.8安装pip包：pip3 install importlib_resources==1.5
9）、初化数据库表结构：./manage.py database create_tables
10）、退出虚拟环境，安装完成：deactivate

5、启动

分别打开三个终端，都执行cd redash进入目录后分别执行下列三个命令之一：
source venv/bin/activate
./manage.py runserver --debugger --reload
和
source venv/bin/activate
./manage.py rq worker
和
source venv/bin/activate
./manage.py rq scheduler

打开浏览器，输入地址：http://localhost:5000

redash中文版生产环境部署

承接上篇Centos8本地安装Redash中文版，在此基础上升级为Nginx+Supervisor+uWSGI的生产环境部署，本文将自底向上逐步展开最基本的安装方式。

一、安装和测试uWSGI
1、安装：
sudo yum -y install python36-devel
sudo pip3 install uwsgi

2、配置：
进入项目目录：cd ~/redash
创建配置文件：sudo nano uwsgi.ini
[uwsgi]
http=:5000
chdir=/home/当前centos用户名/redash/
wsgi-file=redash/wsgi.py
callable=app
master=true
virtualenv=/home/当前centos用户名/redash/venv/
pythonpath=/home/当前centos用户名/redash/
processes=1
threads=2
保存退出，先配置成http方式，便于从浏览器访问，后续配合nginx将改为socket方式。
注意这只是基本配置，高级配置请参考uWSGI官网中文文档
https://uwsgi-docs-zh.readthedocs.io/zh_CN/latest/WSGIquickstart.html

3、启动：
uwsgi uwsgi.ini
进入浏览器输入http://localhost:5000即可访问，
注意其它worker和scheduler还是以终端方式进虚拟环境启动。
运行无问题，证明已用uwsgi启动了redash，先Ctrl+C停止uwsgi服务继续进行后续配置。

二、安装和测试Supervisor
1、安装SuperVisor：
sudo pip3 install supervisor

2、配置：
进入项目目录：cd ~/redash
先用命令生成默认配置文件：echo_supervisord_conf > supervisord.conf
打开配置文件：sudo nano supervisord.conf
在文件结尾插入下列内容，用于启动redash、worker和scheduler
[program:redash]
command = uwsgi uwsgi.ini

[program:worker]
directory=/home/当前centos用户名/redash/
command=venv/bin/python3 ./manage.py rq worker

[program:scheduler]
directory=/home/当前centos用户名/redash/
command=venv/bin/python3 ./manage.py rq scheduler
保存退出，注意这只是基本配置，高级配置请参考http://supervisord.org/

3、启动
supervisord -c supervisord.conf
进入浏览器输入http://localhost:5000即可访问，注意这时worker和scheduler也已用supervisor进行管理，不需要另外启动。

查看三个进程，运行无问题，
supervisorctl status
证明已用supervisor启动了含uwsgi的redash全部进程。

停止进程（最好重启系统），继续后续配置。
supervisorctl stop all

三、安装Nginx并全部启动
1、安装Nginx:
sudo yum install nginx

2、修改配置：
进入conf.d下新建redash.conf文件
cd /etc/nginx/conf.d/
sudo nano redash.conf 内容如下
server {
listen 80;
server_name localhost;

location /static/ {
alias /root/redash/client/dist/;
}

location / {
root html;
proxy_pass http://127.0.0.1:5000;
}
}
保存退出，运行nginx -t测试配置文件是否正确。

3、启动：
supervisord -c supervisord.conf
systemctl start nginx
进入浏览器输入http://127.0.0.1:80能够正常访问即为安装成功。

Redash中文版安装常见问题

Redash的安装比较复杂，由于系统环境组件版本不同，可能会出现这样那样的问题，我们把安装过程中常见问题记录如下：

1、git clone 经常提示：RPC失败，远端意外挂断、过早的文件结束符、index-pack失败。
原因：主要由于github服务器在境外。

方法1：主要由于github服务器在境外，只能多试几次。
方法2：

git init && git config --global http.postBuffer 524288000

(注意将其中−−改为两个英文减号)。
方法3：打开github.com/dazdata/redash网页，右中上角按钮”Clone or download” 点击弹出浮窗，右下脚“Download ZIP” 点击开始下载。下载完成后将redash-master.zip文件复制到主目录，然后进主目录找到复制来的文件，右键“提取到此处”，解压完成后主目录会生成一个文件夹“redash-master”，右键“重命名”将该文件夹改名为redash即可。输入cd redash切换进入目录，继续执行后续命令。

2：npm install经常出现异常。

原因：缓存或源导致的。
方法1：清除缓存，删除package-lock.json文件和node_modules文件夹：

npm cache clean --force && rm -rf package-lock.json && rm -rf node_modules

注意运行npm config get registry检查一下是否是国内源，如果确认是国内源，只能多试几次。
方法2：更换成cnpm：

sudo npm install -g cnpm --registry=https://registry.npm.taobao.org

运行cnpm install试试。

3：npm ERR! Unexpected end of JSON input while parsing near ‘…
原因：缓存或源导致的。

方法：清除缓存：

npm cache clean --force

改源npm set registry https://registry.npmjs.org/再试。

4：升级nodejs最新版本：sudo n stable 卡死
原因：访问境外网站慢导致。

方法：自行从nodejs官网下载最新Linux Binaries (x64)稳定版压缩文件，如

node-v12.18.2-linux-x64.tar.xz

最好拷贝至/opt文件夹：cp node-v12.18.2-linux-x64.tar.xz /opt/
解压：

tar xvf node-v12.18.2-linux-x64.tar.xz

配置环境变量：sudo nano /etc/profile 在文件最后添加两行

export NODE_HOME=/opt/nodejs/node-v11.1.0-linux-x64/bin
export PATH=$NODE_HOME:$PATH

激活修改：source /etc/profile
验证:

node -v

系统能显示最新版本号即为成功。

Readsh中文版初始化设置

安装成功后，打开浏览器输入http://localhost:5000如果出现如下画面，即告安装成功，激动人心的一刻！

视频：本文详细视频教程(bilibili)

初始设置，输入系统管理员用户名（可以是昵称）、邮箱（登录用）、密码，和单位名称即可，非常简单。登录进入系统界面后，找右上角下拉菜单，选择“数据源”

聪明的你一定想到，先用Redash自身的PostgreSQL数据库作为数据源试试看，对的完全可以。
单机安装下，服务器：localhost，端口：5432，用户名：postgres，密码：安装脚本中输入的密码，数据库：postgres，保存测试连接。
Docker安装下，服务器：redash_postgres_1，端口：5432，用户名：postgres，密码：<空>，数据库：postgres，创建->保存->测试连接。

建好数据源后下一步就是创建查询，点顶部“新建->新建查询”菜单：

输入SQL语句：select * from users，保存执行。如果看到查询结果就证明一切正常，如果不能出现查询结果，原因式后台worker服务没有启动。有了查询后，便是建立视图：

选刚才建立的新查询，选计数器(Counter)类型，输入标题，选统计行数，一切ok了。下一步便是建立报表了，选“新建->新建报表”菜单，输入报表名称，点添加部件，选中刚才建立的计数器：

一幅极简所见即所得的报表便出来了，恭喜，你已经搞定Redash了，高大上的产品其实非常简单有没有！

Redash中文版连接Oracle11g数据库

如果需要在ubuntu环境安装oracle服务器，有docker和本地安装两种办法，请自行参看其它文章。本文重点介绍如何在Redash的服务端安装oracle11gR2客户端以及oracle的python接口包cx-oracle，以便连接到oracle数据库服务器，作为数据源来进行数据展现。

1、首先从oracle官网下载安装包，注意找到11.2.0.4.0版

oracle-instantclient11.2-basic-11.2.0.4.0.x86_64.zip
oracle-instantclient11.2-sqlplus-11.2.0.4.0.x86_64.zip
oracle-instantclient11.2-sdk-11.2.0.4.0.x86_64.zip

2、创建/opt/oracle文件夹，赋予权限

sudo mkdir /opt/oracle
sudo chmod 777 /opt/oracle
将上述包解压至/opt/oracle/instantclient_11_2/文件夹下

3、配置用户变量，在~/.bashrc文件最后追加环境变量配置信息

ORACLE_HOME=/opt/oracle/instantclient_11_2
PATH=$ORACLE_HOME:$PATH
LD_LIBRARY_PATH=$ORACLE_HOME:$LD_LIBRARY_PATH
export TNS_ADMIN=$ORACLE_HOME/network/admin
export NLS_LANG=AMERICAN_AMERICA.AL32UTF8
export ORACLE_HOME PATH LD_LIBRARY_PATH

配置完毕后,刷新使环境变量生效source ~/.bashrc
4、创建软连接：

sudo ln -f -s /opt/oracle/instantclient_11_2/lclntsh.so.11.1 /usr/lib/lclntsh.so
sudo ln -f -s /opt/oracle/instantclient_11_2/libclntsh.so.11.1 /usr/lib/libclntsh.so

5、测试：执行sqlplus /nolog

屏幕出现下述结果即安装成功。
SQL*Plus: Release 11.2.0.4.0 Production on 星期二 1月 5 11:14:31 2019
Copyright (c) 1982, 2009, Oracle. All rights reserved.
SQL>
输入exit退出sqlplus
如果不能登入oracle，请尝试执行：sudo apt-get install libaio-dev

6、安装python的cx_oracle包

进入redash文件夹，cd ~/redash
激活虚拟机：source venv/bin/activate
安装：pip install cx_Oracle==5.3
直至提示成功，即可进行oracle数据源配置。

7、注意：如果服务器和客户端安装了防火墙软件，要进行相关设置。