安装与部署

本章介绍如何安装和部署A-Tune。

软硬件要求

硬件要求

  • 鲲鹏920处理器

软件要求

  • 操作系统：openEuler 21.03

环境准备

  • 安装openEuler系统，安装方法参考 《openEuler 21.03 安装指南》。

  • 安装A-Tune需要使用root权限。

安装A-Tune

本章介绍A-Tune的安装模式和安装方法。

安装模式介绍

A-Tune支持单机模式和分布式模式安装：

  • 单机模式

    client和server安装到同一台机器上。

  • 分布式模式

    client和server分别安装在不同的机器上。

两种安装模式的简单图示如下：

安装与部署 - 图1

安装操作

安装A-Tune的操作步骤如下：

  1. 挂载openEuler的iso文件。

    1. # mount openEuler-21.03-aarch64-dvd.iso /mnt

  2. 配置本地yum源。

    1. # vim /etc/yum.repos.d/local.repo

    配置内容如下所示：

    1. [local]
    2. name=local
    3. baseurl=file:///mnt
    4. gpgcheck=1
    5. enabled=1

  3. 将RPM数字签名的GPG公钥导入系统。

    1. # rpm --import /mnt/RPM-GPG-KEY-openEuler

  4. 安装A-Tune服务端。

    安装与部署 - 图2 说明：
    本步骤会同时安装服务端和客户端软件包，对于单机部署模式，请跳过步骤5。

    1. # yum install atune -y
    2. # yum install atune-engine -y

  5. 若为分布式部署，请安装A-Tune客户端。

    1. # yum install atune-client -y

  6. 验证是否安装成功。命令和回显如下表示安装成功。

    1. # rpm -qa | grep atune
    2. atune-client-xxx
    3. atune-db-xxx
    4. atune-xxx
    5. atune-engine-xxx

部署A-Tune

本章介绍A-Tune的配置部署。

配置介绍

A-Tune配置文件/etc/atuned/atuned.cnf的配置项说明如下：

  • A-Tune服务启动配置

    可根据需要进行修改。

    • protocol：系统grpc服务使用的协议，unix或tcp，unix为本地socket通信方式，tcp为socket监听端口方式。默认为unix。
    • address：系统grpc服务的侦听地址，默认为unix socket，若为分布式部署，需修改为侦听的ip地址。
    • port：系统grpc服务的侦听端口，范围为0~65535未使用的端口。如果protocol配置是unix，则不需要配置。
    • connect：若为集群部署时，atune所在节点的ip列表，ip地址以逗号分隔。
    • rest_host：系统rest service的侦听地址，默认为localhost。
    • rest_port：系统rest service的侦听端口，范围为0~65535未使用的端口，默认为8383。
    • engine_host：与系统atune engine service链接的地址。
    • engine_port：与系统atune engine service链接的端口。
    • sample_num：系统执行analysis流程时采集样本的数量，默认为20。
    • interval：系统执行analysis流程时采集样本的间隔时间，默认为5s。
    • grpc_tls：系统grpc的SSL/TLS证书校验开关，默认不开启。开启grpc_tls后，atune-adm命令在使用前需要设置以下环境变量方可与服务端进行通讯：
      • export ATUNE_TLS=yes
      • export ATUNED_CACERT=<客户端CA证书路径>
      • export ATUNED_CLIENTCERT=<客户端证书路径>
      • export ATUNED_CLIENTKEY=<客户端秘钥路径>
      • export ATUNED_SERVERCN=server
    • tlsservercafile：gPRC服务端CA证书路径。
    • tlsservercertfile：gPRC服务端证书路径。
    • tlsserverkeyfile：gPRC服务端秘钥路径。
    • rest_tls：系统rest service的SSL/TLS证书校验开关，默认开启。
    • tlsrestcacertfile：系统rest service的服务端CA证书路径。
    • tlsrestservercertfile：系统rest service的服务端证书路径
    • tlsrestserverkeyfile：系统rest service的服务端秘钥路径。
    • engine_tls：系统atune engine service的SSL/TLS证书校验开关，默认开启。
    • tlsenginecacertfile：系统atune engine service的客户端CA证书路径。
    • tlsengineclientcertfile：系统atune engine service的客户端证书路径
    • tlsengineclientkeyfile：系统atune engine service的客户端秘钥路径

  • system信息

    system为系统执行相关的优化需要用到的参数信息，必须根据系统实际情况进行修改。

    • disk：执行analysis流程时需要采集的对应磁盘的信息或执行磁盘相关优化时需要指定的磁盘。

    • network：执行analysis时需要采集的对应的网卡的信息或执行网卡相关优化时需要指定的网卡。

    • user：执行ulimit相关优化时用到的用户名。目前只支持root用户。

  • 日志信息

    根据情况修改日志的级别，默认为info级别，日志信息打印在/var/log/messages中。

  • monitor信息

    为系统启动时默认采集的系统硬件信息。

  • tuning信息

    tuning为系统进行离线调优时需要用到的参数信息。

    • noise：高斯噪声的评估值。
    • sel_feature：控制离线调优参数重要性排名输出的开关，默认关闭。

配置示例

  1. #################################### server ############################### 
  2.  # atuned config 
  3.  [server] 
  4.  # the protocol grpc server running on 
  5.  # ranges: unix or tcp 
  6.  protocol = unix 
  8.  # the address that the grpc server to bind to
  9.  # default is unix socket /var/run/atuned/atuned.sock
  10.  # ranges: /var/run/atuned/atuned.sock or ip address
  11.  address = /var/run/atuned/atuned.sock 
  13.  # the atune nodes in cluster mode, separated by commas
  14.  # it is valid when protocol is tcp
  15.  # connect = ip01,ip02,ip03
  17.  # the atuned grpc listening port
  18.  # the port can be set between 0 to 65535 which not be used
  19.  # port = 60001
  21.  # the rest service listening port, default is 8383
  22.  # the port can be set between 0 to 65535 which not be used
  23.  rest_host = localhost
  24.  rest_port = 8383
  26.  # the tuning optimizer host and port, start by engine.service
  27.  # if engine_host is same as rest_host, two ports cannot be same
  28.  # the port can be set between 0 to 65535 which not be used
  29.  engine_host = localhost
  30.  engine_port = 3838
  32.  # when run analysis command, the numbers of collected data.
  33.  # default is 20
  34.  sample_num = 20
  36.  # interval for collecting data, default is 5s
  37.  interval = 5
  39.  # enable gRPC authentication SSL/TLS
  40.  # default is false
  41.  # grpc_tls = false
  42.  # tlsservercafile = /etc/atuned/grpc_certs/ca.crt
  43.  # tlsservercertfile = /etc/atuned/grpc_certs/server.crt
  44.  # tlsserverkeyfile = /etc/atuned/grpc_certs/server.key
  46.  # enable rest server authentication SSL/TLS
  47.  # default is true
  48.  rest_tls = true
  49.  tlsrestcacertfile = /etc/atuned/rest_certs/ca.crt
  50.  tlsrestservercertfile = /etc/atuned/rest_certs/server.crt
  51.  tlsrestserverkeyfile = /etc/atuned/rest_certs/server.key
  53.  # enable engine server authentication SSL/TLS
  54.  # default is true
  55.  engine_tls = true
  56.  tlsenginecacertfile = /etc/atuned/engine_certs/ca.crt
  57.  tlsengineclientcertfile = /etc/atuned/engine_certs/client.crt
  58.  tlsengineclientkeyfile = /etc/atuned/engine_certs/client.key
  61.  #################################### log ############################### 
  62.  [log]
  63.  # either "debug", "info", "warn", "error", "critical", default is "info"
  64.  level = info
  66.  #################################### monitor ############################### 
  67.  [monitor]
  68.  # with the module and format of the MPI, the format is {module}_{purpose}
  69.  # the module is Either "mem", "net", "cpu", "storage"
  70.  # the purpose is "topo"
  71.  module = mem_topo, cpu_topo
  73.  #################################### system ############################### 
  74.  # you can add arbitrary key-value here, just like key = value
  75.  # you can use the key in the profile
  76.  [system]
  77.  # the disk to be analysis
  78.  disk = sda
  80.  # the network to be analysis
  81.  network = enp189s0f0
  83.  user = root
  85.  #################################### tuning ###############################
  86.  # tuning configs
  87.  [tuning]
  88.  noise = 0.000000001
  89.  sel_feature = false

A-Tune engine配置文件/etc/atuned/engine.cnf的配置项说明如下：

  • A-Tune engine服务启动配置

可根据需要进行修改。

  • engine_host：系统atune engine service的侦听地址，默认为localhost。
  • engine_port：系统atune engine service的侦听端口，范围为0~65535未使用的端口，默认为3838。
  • engine_tls：系统atune engine service的SSL/TLS证书校验开关，默认开启。
  • tlsenginecacertfile：系统atune engine service的服务端CA证书路径。
  • tlsengineservercertfile：系统atune engine service的服务端证书路径

  • tlsengineserverkeyfile：系统atune engine service的服务端秘钥路径。

  • 日志信息

根据情况修改日志的级别，默认为info级别，日志信息打印在/var/log/messages中。

配置示例

  1.  #################################### engine ###############################
  2.  [server]
  3.  # the tuning optimizer host and port, start by engine.service
  4.  # if engine_host is same as rest_host, two ports cannot be same
  5.  # the port can be set between 0 to 65535 which not be used
  6.  engine_host = localhost
  7.  engine_port = 3838
  9.  # enable engine server authentication SSL/TLS
  10.  # default is true
  11.  engine_tls = true
  12.  tlsenginecacertfile = /etc/atuned/engine_certs/ca.crt
  13.  tlsengineservercertfile = /etc/atuned/engine_certs/server.crt
  14.  tlsengineserverkeyfile = /etc/atuned/engine_certs/server.key
  16.  #################################### log ###############################
  17.  [log]
  18.  # either "debug", "info", "warn", "error", "critical", default is "info"
  19.  level = info

启动A-Tune

A-Tune安装完成后，需要启动A-Tune服务才能使用。

  • 启动atuned服务：

    1. # systemctl start atuned

  • 查询atuned服务状态：

    1. # systemctl status atuned

    若回显为如下，则服务启动成功。

    安装与部署 - 图3

启动A-Tune engine

若需要使用AI相关的功能，需要启动A-Tune engine服务才能使用。

  • 启动atune-engine服务：

    1. # systemctl start atune-engine

  • 查询atune-engine服务状态：

    1. # systemctl status atune-engine

若回显为如下，则服务启动成功。

安装与部署 - 图4