安装手册

# 产品快速安装

本快速入门指南介绍了金蝶Apusic负载均衡软件v2.0.1产品安装、启动、卸载基本操作，为用户快速使用本产品提供指导。

相关资源

针对不同的操作系统及CPU架构平台，金蝶Apusic负载均衡软件提供不同的安装包。更多产品介质相关信息，可以访问金蝶天燕官方网站http://www.apusic.com获取。

基本概念

在正确使用应用服务器来部署、管理应用之前，需要先理解以下几个基本概念：

ALB：Apusic Load Balance，金蝶Apusic负载均衡软件。

  • 安装与使用
  • 安装前准备
  • 获取安装包

从http://www.apusic.com/下载金蝶Apusic负载均衡软件v2.0安装包，或从金蝶Apusic负载均衡软件产品光盘中获得相应的安装包文件。

支持的环境

平台类型 系统类型
芯片类型 鲲鹏、飞腾、兆芯等通用x86或arm架构cpu
国产操作系统 OpenEuler、统信UOS、银河麒麟系列、深度等
其他Linux系列 RedHat系列、CentOS、Suse Linux系列等

# 产品安装

下面以ARM架构下Kylin系统上安装ALB为例，下载好安装文件alb-standard-2.0-arm.tar.gz后，其安装步骤有：

  1. 解压安装包
  2. 导入license
  3. 启动

# 解压安装包到指定目录

  1. 上传alb安装包至安装服务器的任意安装目录，（推荐/opt目录）。
  2. 解压安装包：tar -zvxf alb-standard-2.0-arm.tar.gz 获得alb-standard-2.0文件夹。
  3. 进入解压后的文件夹: cd alb-standard-2.0-arm。

备注：下面演示的安装路径为/opt/目录（支持安装在任意目录）。

# 导入license

ALB标准版支持金蝶天燕认证、金蝶KBC认证、金蝶统一授权三种模式，默认授权类型为金蝶KBC授权。

金蝶KBC授权和本地授权，请把授权文件放置在安装目录/alb-standard文件夹下，

  1. 授权类型配置

alb授权类型的配置文件为：安装目录/alb-standard/conf/alb_license.conf

license kbc license.lic;  # 使用KBC授权模式，授权文件为license.lic
1
  1. 授权类型配置格式

语句格式规范： license [授权类型] [授权文件或地址];

  1. 不同授权类型及其配置说明
  • local: 表示金蝶天燕本地授权，后面需要紧跟授权文件。
    • 如：license local license.xml;，
    • 把本地授权文件license.xml放置在安装目录/alb-standard文件夹下。
  • kbc: 表示金蝶KBC授权，后面需要紧跟授权文件。如：license kbc license.lic;，
    • KBC特征码获取：1、直接启动，2、授权配置文件写：license kbc;
    • 执行ALB启动./bin/start-alb.sh脚本，获取授权码: KBC auth: Auth Code is: SZTY2500879438。
    • 授权码为SZTY开头的内容,如上为：SZTY2500879438
    • 使用授权码在KBC系统中申请授权文件。
    • 获取授权文件后，放入安装目录/alb-standard，并确认授权文件名和alb_license.conf配置一致（如上为license.lic文件)，重启ALB即可。
    • 注：在多网卡多ip环境中，可以通过-ac参数指定网卡或ip，如license kbc license-file.lic -ac eth0
  • center: 表示金蝶天燕统一授权中心，后面需要跟授权服务器地址(IP:端口)、租户名称和命名空间。如：license center 172.21.33.33:6789 tenant namespace;
    • 如果租户名称不确定，可以填写为public。
  1. 通过环境变量设置统一授权配置 alb支持环境变量中设置统一授权的配置，如下为使用export设置对应的环境变量：
export apusic_acls_enable=true                 # 开启变量统一授权
export apusic_acls_authUrls=172.24.3.116:6869  # 统一授权中心地址
export apusic_acls_ns=后付费                    # 命名空间 
export apusic_acls_tenant=user_env中文          # 租户名称
1
2
3
4

# 启动、停止、重新加载

  • 启动： ./bin/start-alb.sh
  • 停止： ./bin/stop-alb.sh
  • 重新加载： ./bin/reload-alb.sh

# 产品安装使用说明

# 产品端口说明（默认端口）

端口 说明
80 ALB网关HTTP端口，所有在管理控制台配置的代理路由的http访问均为此端口
443 ALB网关HTTPS端口，有在管理控制台配置的代理路由的https访问均为此端口
9000 WEB管理控制台默认端口

# 产品端口修改

若系统已有服务占用了80、443、9000端口，会导致alb启动失败，可以通过配置修改端口。

# 修改http或https的端口

  1. 修改配置文件：安装目录/alb-standard/conf/config.yaml
  2. 修改配置文件内容：
soft: ALB/2.0.1
alb:
  admin_key:
    - name: "admin"
      key: edd1c9f034335f136f87ad84b625c8f1  # using fixed API token has security risk, please update it when you deploy to production environment
      role: admin
  node_listen: 80       # http默认的网关访问入口

  ssl:
    listen_port: 443    # https访问网关的入口
1
2
3
4
5
6
7
8
9
10
  1. 如上，修改对应的node_listen、ssl.listen_port端口即可。
  2. 重新启动ALB： ./bin/start-alb.sh

# 修改WEB管理控制台端口

  1. 修改配置文件：安装目录/alb-dashboard/conf/config.yaml
  2. 修改配置文件内容：
conf:
  listen:
    host: 0.0.0.0
    port: 9000  # WEB管理控制台默认端口
1
2
3
4
  1. 如上，修改对应的listen.port端口即可。
  2. 重新启动ALB： ./bin/start-alb.sh

# 启动失败常见问题

# DNS is Empty（缺失dns服务器）

所在机器环境无DNS，则需要手动开启内置的DNS配置。

配置文件地址：安装目录/alb-standard/conf/config.yaml

去掉前面的注释，即可开启DNS。

注意dns_resolver对齐到上面的enable_control

alb:
  enable_control: false  #开启会监听9090端口。

# 如果出现 local DNS is empty，那么把下面三行注释去掉即可，注意对齐到上面的enable_control。
  dns_resolver:
    - 8.8.8.8
    - 114.114.114.114
php:
  php_enable: false
1
2
3
4
5
6
7
8
9
编辑页面 (opens new window)

← 用户手册→