Skip to main content
Version: 1.4.0

Console Deployment

The linkis web service uses nginx as a static resource server. The access request process is as follows :
Linkis Management Console request -> Nginx ip:port-> Linkis-gateway ip:port-> Other services

Linkis 1.0 provides a Linkis Console, which provides functions such as displaying Linkis' global history, modifying user parameters, managing ECM and microservices, etc. Before deploying the front-end management console, you need to deploy the Linkis back-end. Linkis deployment manual See: Linkis Deployment Manual

1. Preparation

  1. Download the web installation package from the release page of Linkis (click here to enter the download page), apache-linkis-xxx-incubating-web-bin. tar.gz Manually decompress: tar -xvf apache-linkis-x.x.x-incubating-web-bin.tar.gz

The decompression directory is as follows.

├── config.sh
├── dist
├── install.sh
├── LICENSE
├── licenses
└── NOTICE

2. Deployment

    There are two deployment methods, automated deployment and manual deployment

2.1 Automated deployment

2.1.1 modify config.sh file (use vim or nano)

#Configuring front-end ports
linkis_port="8088"

#URL of the backend linkis gateway
linkis_url="http://localhost:9001"

#linkis ip address, replace `127.0.0.1` to real ip address if neccssary
linkis_ipaddr=127.0.0.1

2.1.2 execute deployment script

   #sudo permission is required to install nginx
sudo sh install.sh

After execution, you can directly access it in Google browser: http://linkis_ipaddr:linkis_port where linkis_port is the port configured in config.sh, and linkis_ipaddr is the IP of the installation machine

If the access fails: You can check the installation log which step went wrong

2.2 Manual deployment

  1. Install Nginx: sudo yum install nginx -y

  2. Modify the configuration file: sudo vi /etc/nginx/conf.d/linkis.conf Add the following content:

server {
listen 8080;# access port
server_name localhost;
#charset koi8-r;
#access_log /var/log/nginx/host.access.log main;
location / {
root /appcom/Install/linkis/dist; # The directory where the front-end package is decompressed
index index.html index.html;
}

location /api {
proxy_pass http://192.168.xxx.xxx:9001; # ip port of linkis-gateway service
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header x_real_ipP $remote_addr;
proxy_set_header remote_addr $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_http_version 1.1;
proxy_connect_timeout 4s;
proxy_read_timeout 600s;
proxy_send_timeout 12s;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection upgrade;
}
#error_page 404 /404.html;
# redirect server error pages to the static page /50x.html
#
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root /usr/share/nginx/html;
}
}

  1. Copy the front-end package to the corresponding directory: /appcom/Install/linkis/dist; # The directory where the front-end package is decompressed

  2. Start the service sudo systemctl restart nginx

  3. After execution, you can directly access it in Google browser: http://nginx_ip:nginx_port

3. Common problems

(1) Upload file size limit

sudo vi /etc/nginx/nginx.conf

Change upload size

client_max_body_size 200m

(2) Interface timeout

sudo vi /etc/nginx/conf.d/linkis.conf

Change interface timeout

proxy_read_timeout 600s