Dataease installation upgrade

Catalog

One 、 The installation conditions

Two 、 Online installation

3、 ... and 、 Local stand-alone installation

1、 download

 2、 Unzip the installation package

3、 Set installation parameters （ Optional ）

4、 Execute the installation version

Four 、 Verify the installation

5、 ... and 、 upgrade

1、 Online upgrade

 2、 Offline upgrade

6、 ... and 、 Other matters needing attention

---

According to the official instructions , Record your installation ！

One 、 The installation conditions

Deployment server requirements ：

• operating system : CentOS 7.x
• CPU/ Memory : 4 nucleus 8G
• disk space : 200G
• Access to the Internet （ Online installation requires ）

Two 、 Online installation

curl -sSL https://github.com/dataease/dataease/releases/latest/download/quick_start.sh | sh

3、 ... and 、 Local stand-alone installation

1、 download

Download from the official website

https://community.fit2cloud.com/#/products/dataease/downloads

 2、 Unzip the installation package

cd /tmp
#  Unzip the installation package 
tar zxvf dataease-v1.11.3-offline.tar.gz

3、 Set installation parameters （ Optional ）

Be careful ： It is strongly recommended that you do not use the path of the installation package as DataEase Installation directory , Routine maintenance and subsequent version upgrade will bring some unnecessary troubles .

from v1.5.0 Version start ,DataEase It supports setting installation parameters in the form of configuration files , Such as installation directory 、 Service running port 、 Database configuration parameters, etc , Please refer to... In the installation package for specific parameters install.conf file ：

from v1.9.0 Version start ,DataEase Support multiple deployment modes , adjustment install.conf In file DE_ENGINE_MODE Parameter to set different installation and deployment modes ,DE_ENGINE_MODE Optional values are local、simple、cluster, Corresponding to local mode respectively 、 Lean mode 、 Cluster pattern , For details, please refer to 【 The installation mode 】 explain .
If not adjusted , Thin mode is installed by default .

This is official

#  Basic configuration 
##  The installation directory 
DE_BASE=/opt
## Service  port 
DE_PORT=80
##  Deployment and operation mode , Optional values are  local、simple、cluster, They correspond to each other   Local mode 、 Lean mode 、 Cluster pattern 
DE_ENGINE_MODE=simple
## docker  Network segment settings 
DE_DOCKER_SUBNET=172.19.0.0/16
## docker  gateway  IP
DE_DOCKER_GATEWAY=172.19.0.1
## Apache Doris FE IP ( external  Doris  This parameter is not valid )
DE_DORIS_FE_IP=172.19.0.198
## Apache Doris BE IP ( external  Doris  This parameter is not valid )
DE_DORIS_BE_IP=172.19.0.199

#  Database configuration 
##  Whether to use external database 
DE_EXTERNAL_MYSQL=false
##  Database address 
DE_MYSQL_HOST=mysql
##  Database port 
DE_MYSQL_PORT=3306
## DataEase  Database database name 
DE_MYSQL_DB=dataease
##  Database user name 
DE_MYSQL_USER=root
##  Database password 
[email protected]

# Apache Doris  To configure 
##  Whether to use external  Apache Doris
DE_EXTERNAL_DORIS=false
## Doris  Address 
DE_DORIS_HOST=doris-fe
## Doris  Query the connection port 
DE_DORIS_PORT=9030
## Doris http port 
DE_DORIS_HTTPPORT=8030
## Doris  Database name 
DE_DORIS_DB=dataease
## Doris  user name 
DE_DORIS_USER=root
## Doris  password 
[email protected]

# Kettle  To configure 
##  Whether to use external  Kettle - ( External... Is not yet supported Kettle, Unless no operation is required Kettle, Otherwise, please do not modify this parameter )
DE_EXTERNAL_KETTLE=false
## Kettle  Server address 
DE_CARTE_HOST=kettle
## Kettle  Access port 
DE_CARTE_PORT=18080
## Kettle  user name 
DE_CARTE_USER=cluster
## Kettle  password 
DE_CARTE_PASSWORD=cluster

This is the version I installed

#  Basic configuration 
##  The installation directory 
DE_BASE=/opt
## Service  port 
DE_PORT=80
##  Deployment and operation mode , Optional values are  local、simple、cluster, They correspond to each other   Local mode 、 Lean mode 、 Cluster pattern 
DE_ENGINE_MODE=simple
## docker  Network segment settings 
DE_DOCKER_SUBNET=172.19.0.0/16
## docker  gateway  IP
DE_DOCKER_GATEWAY=172.19.0.1
## Apache Doris FE IP ( external  Doris  This parameter is not valid )
DE_DORIS_FE_IP=172.19.0.198
## Apache Doris BE IP ( external  Doris  This parameter is not valid )
DE_DORIS_BE_IP=172.19.0.199

#  Database configuration 
##  Whether to use external database 
DE_EXTERNAL_MYSQL=false
##  Database address 
DE_MYSQL_HOST=mysql
##  Database port 
DE_MYSQL_PORT=3306
## DataEase  Database database name 
DE_MYSQL_DB=dataease
##  Database user name 
DE_MYSQL_USER=root
##  Database password 
[email protected]

# Apache Doris  To configure 
##  Whether to use external  Apache Doris
DE_EXTERNAL_DORIS=false
## Doris  Address 
DE_DORIS_HOST=doris-fe
## Doris  Query the connection port 
DE_DORIS_PORT=9030
## Doris http port 
DE_DORIS_HTTPPORT=8030
## Doris  Database name 
DE_DORIS_DB=dataease
## Doris  user name 
DE_DORIS_USER=root
## Doris  password 
[email protected]

# Kettle  To configure 
##  Whether to use external  Kettle - ( External... Is not yet supported Kettle, Unless no operation is required Kettle, Otherwise, please do not modify this parameter )
DE_EXTERNAL_KETTLE=false
## Kettle  Server address 
DE_CARTE_HOST=kettle
## Kettle  Access port 
DE_CARTE_PORT=18080
## Kettle  user name 
DE_CARTE_USER=cluster
## Kettle  password 
DE_CARTE_PASSWORD=cluster

4、 Execute the installation version

#  Go to the installation package directory 
cd dataease-v1.5.0-offline
#  Run the installation script 
/bin/bash install.sh

Be careful ： If you use an external database for installation , Recommended MySQL 5.7 edition . meanwhile DataEase There are requirements for some configuration items of the database , Please refer to the attached database configuration , Modify the database configuration file in the environment .

[mysqld]
datadir=/var/lib/mysql

default-storage-engine=INNODB
character_set_server=utf8
lower_case_table_names=1
table_open_cache=128
max_connections=2000
max_connect_errors=6000
innodb_file_per_table=1
innodb_buffer_pool_size=1G
max_allowed_packet=64M
transaction_isolation=READ-COMMITTED
innodb_flush_method=O_DIRECT
innodb_lock_wait_timeout=1800
innodb_flush_log_at_trx_commit=0
sync_binlog=0
group_concat_max_len=1024000
sql_mode=STRICT_TRANS_TABLES,NO_ZERO_IN_DATE,NO_ZERO_DATE,ERROR_FOR_DIVISION_BY_ZERO,NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION
skip-name-resolve

[mysql]
default-character-set=utf8

[mysql.server]
default-character-set=utf8

Pay special attention to the following parameter settings ：

character_set_server=utf8
lower_case_table_names=1
group_concat_max_len=1024000

Please refer to the database creation statement in the document DataEase Database used ,DataEase When the service starts, it will automatically create the required table structure and initialization data in the configured library .

CREATE DATABASE `dataease` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

By default, the installation script uses /opt/dataease Database used ,DataEase Configuration file for 、 Data and logs are stored in the installation directory .
Description of the directory structure of the installation directory ：

/opt/dataease/
├── bin                                         #--  Scripts that need to be loaded into the container during installation 
├── conf                                        #-- DataEase  Configuration files of middleware such as components and databases 
├── custom-drivers                              #-- DataEase  Custom driver Directory  
├── data                                        #-- DataEase  Data persistence directory of middleware such as components and databases 
├── docker-compose-doris.yml                    #-- DataEase  The built-in  Doris  The required  Docker Compose  file 
├── docker-compose-kettle.yml                   #-- DataEase  The built-in  Kettle  The required  Docker Compose  file  
├── docker-compose-mysql.yml                    #-- DataEase  The built-in  MySQl  The required  Docker Compose  file  
├── docker-compose.yml                          #-- DataEase  Basics  Docker Compose  file , It defines basic information such as network  
├── logs                                        #-- DataEase  The log file persistence directory of each component 
├── plugins                                     #-- DataEase  Third party plug-in Directory  
└── templates                                   #-- DataEase  Original files of configuration files of middleware such as components and databases 

Four 、 Verify the installation

After successful installation , Visit the following page through the browser to log in DataEase：

 Address : http:// Target server IP Address : Service running port 
 user name : admin
 password : dataease

5、 ... and 、 upgrade

1、 Online upgrade

#  Upgrade to the latest version 
dectl upgrade
#  see  DataEase  state 
dectl status

 2、 Offline upgrade

#  Enter project directory 
cd dataease-release-v1.x.y-offline
#  Run the installation script 
/bin/bash install.sh
#  see  DataEase  state 
dectl status

6、 ... and 、 Other matters needing attention

Built in sample data to flyway In the form of DataEase When starting, it is automatically inserted into MySQL In the database , If an external... Is used MySQL Or modify the built-in MySQL Name of the container , Need to log in to DataEase Console , Enter into 【 data source 】 page , choice "demo" data source , take "demo" The relevant connection information of the data source has been modified correctly , After saving, the built-in sample data can be used normally .