Skip to main content
Version: 1.5.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