From c1a3d56840b9af2f0e2aca48a120278536f8560e Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:26:25 +0800 Subject: [PATCH 01/46] update README.md. --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index f10ea0cc..8da60291 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ A-Tune介绍 ============ -A-Tune是一款系统性能自优化的系统级基础软件，目标是智能识别出系统的负载类型，并进行业务模型到资源模型的动态调度，以充分释放鲲鹏服务器算力，使运行在鲲鹏服务器上的应用得到最佳性能表现。 +A-Tune是一款基于AI的操作系统性能调优软件。A-Tune利用AI技术，使操作系统“懂”业务，简化IT系统调优工作的同时，让应用程序发挥出色性能。 ````....---::::////////////-.` @@ -144,4 +144,4 @@ atune-adm analysis –model ./model/new-model.m atune-adm analysis mysql ``` -其他命令使用详见atune-adm help信息 +其他命令使用详见atune-adm help信息或A-Tune用户指南。 -- Gitee From 05aef43ab61eb43e0c3b386628d7bd79f42e0266 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:36:54 +0800 Subject: [PATCH 02/46] =?UTF-8?q?=E5=90=88=E5=B9=B6md=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...50\346\210\267\346\214\207\345\215\227.md" | 1372 +++++++++++++++++ 1 file changed, 1372 insertions(+) create mode 100644 "Documentation/UserGuide/A-Tune\347\224\250\346\210\267\346\214\207\345\215\227.md" diff --git "a/Documentation/UserGuide/A-Tune\347\224\250\346\210\267\346\214\207\345\215\227.md" "b/Documentation/UserGuide/A-Tune\347\224\250\346\210\267\346\214\207\345\215\227.md" new file mode 100644 index 00000000..376f1db4 --- /dev/null +++ "b/Documentation/UserGuide/A-Tune\347\224\250\346\210\267\346\214\207\345\215\227.md" @@ -0,0 +1,1372 @@ +# A-Tune用户指南 + +

法律申明

+ +**版权所有 © 2020 华为技术有限公司。** + +您对“本文档”的复制，使用，修改及分发受知识共享\(Creative Commons\)署名—相同方式共享4.0国际公共许可协议\(以下简称“CC BY-SA 4.0”\)的约束。为了方便用户理解，您可以通过访问[https://creativecommons.org/licenses/by-sa/4.0/](https://creativecommons.org/licenses/by-sa/4.0/) 了解CC BY-SA 4.0的概要 \(但不是替代\)。CC BY-SA 4.0的完整协议内容您可以访问如下网址获取：[https://creativecommons.org/licenses/by-sa/4.0/legalcode](https://creativecommons.org/licenses/by-sa/4.0/legalcode)。 + +**商标声明** + +A-Tune和其他华为商标均为华为技术有限公司的商标。本文档提及的其他所有商标或注册商标，由各自的所有人拥有。 + +**免责声明** + +本文档仅作为使用指导，除非适用法强制规定或者双方有明确书面约定, 华为技术有限公司对本文档中的所有陈述、信息和建议不做任何明示或默示的声明或保证，包括但不限于不侵权，时效性或满足特定目的的担保。 + +

前言

+ +## 概述 + +本文档介绍openEuler系统性能自优化软件A-Tune的安装部署和使用方法，以指导用户快速了解并使用A-Tune。 + +## 读者对象 + +本文档适用于使用openEuler系统并希望了解和使用A-Tune的社区开发者、开源爱好者以及相关合作伙伴。使用人员需要具备基本的Linux操作系统知识。 + +## 符号约定 + +在本文中可能出现下列标志，它们所代表的含义如下。 + + + + + + + + + + + + + +

符号

+

说明

+

![](figures/zh-cn_image_0213178479.png)

+

用于传递设备或环境安全警示信息。如不避免则可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果。

+

“须知”不涉及人身伤害。

+

![](figures/zh-cn_image_0213178480.png)

+

对正文中重点信息的补充说明。

+

“说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。

+
+ +

认识A-Tune

+ +

简介

+ +操作系统作为衔接应用和硬件的基础软件，如何调整系统和应用配置，充分发挥软硬件能力，从而提升业务性能，对用户来说至关重要。然而，运行在操作系统上的业务类型成百上千，应用形态千差万别，对资源的要求各不相同，且当前硬件和基础软件组成的应用环境涉及高达7000多个配置对象，随着调优对象的增加，调优所需的时间成本以指数级增长，配置调优成为了一项极其复杂的工程，超出了一般工程师的能力范围。为了应对这些挑战，A-Tune就应运而生了。 + +A-Tune是一款基于openEuler系统开发的性能智能自优化的基础软件，它利用人工智能技术，对应用建立精准的系统画像，通过AI感知并推理出业务特征，从而进行智能决策，匹配得出最佳的系统配置组合，使业务处于最佳运行状态。 + +![](figures/zh-cn_image_0215192422.png) + +

架构

+ +A-Tune核心技术架构如下图，主要包括智能决策、系统画像和交互系统三层。 + +- 智能决策层：包含感知和决策两个子系统，分别承担对应用的智能感知和对系统的调优决策。 +- 系统画像层：主要包括标注和学习系统，标注系统用于业务模型的聚类，学习系统用于业务模型的学习和分类。 +- 交互系统层：用于各类系统资源的监控和配置，其中调优策略执行在本层进行。 + +![](figures/zh-cn_image_0215591510.png) + +

支持特性与业务模型

+ +## 支持特性 + +A-Tune支持的主要特性、特性成熟度以及使用建议请参见[表1](#table1919220557576)。 + +**表 1** 特性成熟度 + + + + + + + + + + + + + + + + + + + + +

特性

+

成熟度

+

使用建议

+

七大类11款应用负载类型自动优化

+

已测试

+

试用

+

自定义负载类型和业务模型

+

已测试

+

试用

+

参数自调优

+

已测试

+

试用

+
+ +## 支持业务模型 + +根据应用的负载特征，A-Tune将业务分为七大类，各类型的负载特征和A-Tune支持的应用请参见[表2](#table2819164611311)。 + +**表 2** 支持的业务类型和应用 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

业务类型（workload_type）

+

类型说明

+

负载特征

+

支持的应用

+

default

+

默认类型

+

CPU、内存带宽、网络、IO各维度资源使用率都不高

+

N/A

+

webserver

+

https应用

+

CPU使用率高

+

Nginx

+

big_database

+

数据库

+
  • 关系型数据库

    读： CPU、内存带宽、网络使用率高

    +

    写：IO使用率高

    +
+
  • 非关系型数据库

    CPU、IO使用率高

    +
+

MongoDB、MySQL、PostgreSQL、MariaDB

+

big_data

+

大数据

+

CPU、IO使用率较高

+

Hadoop、Spark

+

in-memory_computing

+

内存密集型应用

+

CPU、内存带宽使用率高

+

SPECjbb2015

+

in-memory_database

+

计算+网络密集型应用

+

CPU单核使用率高，多实例下网络使用率高

+

Redis

+

single_computer_intensive_jobs

+

计算密集型应用

+

CPU单核使用率高，部分子项内存带宽使用率高

+

SPECCPU2006

+

communication

+

网络密集型应用

+

CPU、网络使用率高

+

Dubbo

+

idle

+

系统idle

+

系统处于空闲状态，无任何应用运行

+

N/A

+
+ +

安装与部署

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

软硬件要求

+ +## 硬件要求 + +- 鲲鹏920处理器 + +## 软件要求 + +- 操作系统：openEuler 1.0 + +

环境准备

+ +安装openEuler系统，安装方法参考《openEuler 1.0 安装指南》。 + +

安装A-Tune

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

安装模式介绍

+ +A-Tune支持单机模式和分布式模式安装： + +- 单机模式 + + client和server安装到同一台机器上。 + +- 分布式模式 + + client和server分别安装在不同的机器上。 + + +![](figures/zh-cn_image_0214540005.png) + +

安装操作

+ +安装A-Tune的操作步骤如下： + +1. 挂载openEuler的iso文件。 + + ``` + # mount openEuler-1.0-aarch64-dvd.iso /mnt + ``` + +2. 配置本地yum源。 + + ``` + # vim /etc/yum.repos.d/local.repo + ``` + + 配置内容如下所示： + + ``` + [local] + name=local + baseurl=file:///mnt + gpgcheck=0 + enabled=1 + ``` + +3. 安装A-Tune服务端。 + + >![](public_sys-resources/icon-note.gif) **说明：** + >本步骤会同时安装服务端和客户端软件包，对于单机部署模式，请跳过**步骤4**。 + + ``` + # yum install atune -y + ``` + +4. 安装A-Tune客户端。 + + ``` + # yum install atune-client -y + ``` + +5. 验证是否安装成功。 + + ``` + # rpm -qa | grep atune + atune-client-xxx + atune-db-xxx + atune-xxx + ``` + + 有如上回显信息表示安装成功。 + + +

部署A-Tune

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

配置介绍

+ +A-Tune配置文件/etc/atuned/atuned.cnf的配置项说明如下： + +- A-Tune服务启动配置 + + 可根据需要进行修改。 + + - address：系统grpc服务的侦听地址，默认为127.0.0.1，若为多机部署，需进行修改。 + - port：系统grpc服务的侦听端口，范围为0\~65535未使用的端口。 + - rest\_port：系统restservice的侦听端口, 范围为0\~65535未使用的端口。 + - sample\_num：系统执行analysis流程时采集样本的数量。 + +- system信息 + + system为系统执行相关的优化需要用到的参数信息，必须根据系统实际情况进行修改。 + + - disk：执行analysis流程时需要采集的对应磁盘的信息或执行磁盘相关优化时需要指定的磁盘。 + - network：执行analysis时需要采集的对应的网卡的信息或执行网卡相关优化时需要指定的网卡。 + - user：执行ulimit相关优化时用到的用户名。目前只支持root用户。 + - tls：开启A-Tune的gRPC和http服务SSL/TLS证书校验，默认不开启。开启TLS后atune-adm命令在使用前需要设置以下环境变量方可与服务端进行通讯： + - export ATUNE\_TLS=yes + - export ATUNE\_CLICERT=<客户端证书路径\> + + - tlsservercertfile：gPRC服务端证书路径。 + - tlsserverkeyfile：gPRC服务端秘钥路径。 + - tlshttpcertfile：http服务端证书路径。 + - tlshttpkeyfile：http服务端秘钥路径。 + - tlshttpcacertfile：http服务端CA证书路径。 + +- 日志信息 + + 根据情况修改日志的路径和级别，默认的日志信息在/var/log/message中。 + +- monitor信息 + + 为系统启动时默认采集的系统的硬件信息。 + + +## 配置示例 + +``` +#################################### server ############################### +# atuned config +[server] +# the address the grpc server to bind to, default is 127.0.0.1 +address = 127.0.0.1 + +# the atuned grpc listening port, default is 60001 +# the port can be set between 0 to 65535 the not be used +port = 60001 + +# the rest service listening port, default is 8383 +# the port can be set between 0 to 65535 than not be used +rest_port = 8383 + +# when run analysis command, the numbers of collected data. +# default is 20 +sample_num = 20 + +# Enable gRPC and http server authentication SSL/TLS +# default is false +# tls = true +# tlsservercertfile = /etc/atuned/server.pem +# tlsserverkeyfile = /etc/atuned/server.key +# tlshttpcertfile = /etc/atuned/http/server.pem +# tlshttpkeyfile = /etc/atuned/http/server.key +# tlshttpcacertfile = /etc/atuned/http/cacert.pem + +#################################### log ############################### +# Either "debug", "info", "warn", "error", "critical", default is "info" +level = info + +#################################### monitor ############################### +[monitor] +# With the module and format of the MPI, the format is {module}_{purpose} +# The module is Either "mem", "net", "cpu", "storage" +# The purpose is "topo" +module = mem_topo, cpu_topo + +#################################### system ############################### +# you can add arbitrary key-value here, just like key = value +# you can use the key in the profile +[system] +# the disk to be analysis +disk = sda + +# the network to be analysis +network = enp189s0f0 + +user = root +``` + +

启动A-Tune

+ +A-Tune安装完成后，需要启动A-Tune服务才能使用。 + +- 启动atuned服务： + + ``` + $ systemctl start atuned + ``` + + +- 查询atuned服务状态： + + ``` + $ systemctl status atuned + ``` + + 若回显为如下，则服务启动成功。 + + ![](figures/zh-cn_image_0214540398.png) + + +

使用方法

+ +用户可以通过调用A-Tune提供的命令行接口使用A-Tune提供的功能。本章介绍A-Tune命令行接口的功能和使用方式。 + +

查询负载类型

+ +

list

+ +## 功能描述 + +查询系统当前支持的workload\_type和对应的profile，以及当前处于active状态的profile。 + +## 命令格式 + +**atune-adm list** + +## 使用示例 + +``` +$ atune-adm list + +Support WorkloadTypes: ++-----------------------------------+------------------------+-----------+ +| WorkloadType | ProfileName | Active | ++===================================+========================+===========+ +| default | default | true | ++-----------------------------------+------------------------+-----------+ +| webserver | ssl_webserver | false | ++-----------------------------------+------------------------+-----------+ +| big_database | database | false | ++-----------------------------------+------------------------+-----------+ +| big_data | big_data | false | ++-----------------------------------+------------------------+-----------+ +| in-memory_computing | in-memory_computing | false | ++-----------------------------------+------------------------+-----------+ +| in-memory_database | in-memory_database | false | ++-----------------------------------+------------------------+-----------+ +| single_computer_intensive_jobs | compute-intensive | false | ++-----------------------------------+------------------------+-----------+ +| communication | rpc_communication | false | ++-----------------------------------+------------------------+-----------+ +| idle | default | false | ++-----------------------------------+------------------------+-----------+ + +``` + +>![](public_sys-resources/icon-note.gif) **说明：** +>Active为true表示当前激活的profile，示例表示当前激活的是default类型对应的profile。 + +

自定义负载类型

+ +除了系统已定义的负载类型，A-Tune也支持用户定义新的workload\_type及对应profile，并允许更新或删除自定义的workload\_type。 + +用户也可以将“使用方法 \> 自定义模型”中用户训练的自定义模型添加到A-Tune中。 + +

define

+ +## 功能描述 + +添加用户自定义的workload\_type，及对应的profile优化项。 + +## 命令格式 + +**atune-adm define** + +## 使用示例 + +新增一个workload type，workload type的名称为test\_type，profile name的名称为test\_name，优化项的配置文件为example.conf。 + +``` +$ atune-adm define test_type test_name ./example.conf +``` + +example.conf 可以参考如下方式书写（以下各优化项非必填，仅供参考），也可通过**atune-adm info**查看已有的profile是如何书写的。 + +``` +[main] +# list it's parent profile +[tip] +# the recommended optimization, which should be performed manunaly +[check] +# check the environment +[affinity.irq] +# to change the affinity of irqs +[affinity.task] +# to change the affinity of tasks +[bios] +# to change the bios config +[bootloader.grub2] +# to change the grub2 config +[kernel_config] +# to change the kernel config +[script] +# the script extention of cpi +[sysctl] +# to change the /proc/sys/* config +[sysfs] +# to change the /sys/* config +[systemctl] +# to change the system service config +[ulimit] +# to change the resources limit of user +``` + +

update

+ +## 功能描述 + +将workload\_type原来的优化项更新为new.conf中的内容。 + +## 命令格式 + +**atune-adm update** + +## 使用示例 + +更新负载类型为test\_type，优化项名称为test\_name的优化项为new.conf。 + +``` +$ atune-adm update test_type test_name ./new.conf +``` + +

undefine

+ +## 功能描述 + +删除用户自定义的workload\_type。 + +## 命令格式 + +**atune-adm undefine** + +## 使用示例 + +删除自定义的负载类型test\_type。 + +``` +$ atune-adm undefine test_type +``` + +

自定义模型

+ +A-Tune支持用户训练新的workload\_type。训练方法非常简单，用户只要通过collection和train两条命令，即可完成新模型的训练。 + +

collection

+ +## 功能描述 + +采集业务运行时系统的全局资源使用情况以及OS的各项状态信息，并将收集的结果保存到csv格式的输出文件中，作为模型训练的输入数据集。 + +>![](public_sys-resources/icon-note.gif) **说明：** +>本命令依赖采样工具perf，mpstat，vmstat，iostat，sar。CPU型号目前仅支持鲲鹏920，可通过dmidecode -t processor检查CPU型号。 + +## 命令格式 + +**atune-adm collection** + +## 参数说明 + +- OPTIONS + + + + + + + + + + + + + + + + + + + + + + + + + +

参数

+

描述

+

--filename, -f

+

生成的用于训练的csv文件名：name-时间戳.csv

+

--output_path, -o

+

生成的csv文件的存放路径

+

--disk, -b

+

业务运行时实际使用的磁盘，如/dev/sda

+

--network, -n

+

业务运行时使用的网络接口，如eth0

+

--workload_type, -t

+

标记业务的负载类型，作为后续训练的标签

+

--duration, -d

+

业务运行时采集数据的时间

+
+ + +## 使用示例 + +``` +$ atune-adm collection --filename name --interval 5 --duration 1200 --output_path ./data –-disk sda --network eth0 --workload_type test_type +``` + +

train

+ +## 功能描述 + +使用采集的数据进行模型的训练。训练时至少采集两种workload\_type的数据，否则会报错。 + +## 命令格式 + +**atune-adm train** + +## 参数说明 + +- OPTIONS + + + + + + + + + + + + + +

参数

+

描述

+

--data_path, -d

+

存放模型训练所需的csv文件的目录

+

--output_file, -o

+

训练生成的新模型

+
+ + +## 使用示例 + +使用data目录下的csv文件作为训练输入，生成的新模型new-model.m存放在model目录下。 + +``` +$ atune-adm train --data_path ./data –output_file ./model/new-model.m +``` + +

分析负载类型并自优化

+ + +

analysis

+ +## 功能描述 + +采集系统的实时统计数据进行负载类型识别，并进行自动优化。 + +## 命令格式 + +**atune-adm analysis** \[OPTIONS\] + +## 参数说明 + + + + + + + + + + +

参数

+

描述

+

--model, -m

+

用户自训练产生的新模型

+
+ +## 使用示例 + +- 使用默认的模型进行分类识别 + + ``` + $ atune-adm analysis + ``` + +- 使用自训练的模型进行识别 + + ``` + $ atune-adm analysis --model ./model/new-model.m + ``` + + +

查询profile

+ +

info

+ +## 功能描述 + +查看workload\_type对应的profile内容。 + +## 命令格式 + +**atune-adm info** <_WORKLOAD\_TYPE\>_ + +## 使用示例 + +查看webserver的profile内容： + +``` +$ atune-adm info webserver + +*** ssl_webserver: + +# +# webserver tuned configuration +# +[main] +#TODO CONFIG + +[kernel_config] +#TODO CONFIG + +[bios] +#TODO CONFIG + +[sysfs] +#TODO CONFIG + +[sysctl] +fs.file-max=6553600 +fs.suid_dumpable = 1 +fs.aio-max-nr = 1048576 +kernel.shmmax = 68719476736 +kernel.shmall = 4294967296 +kernel.shmmni = 4096 +kernel.sem = 250 32000 100 128 +net.ipv4.tcp_tw_reuse = 1 +net.ipv4.tcp_syncookies = 1 +net.ipv4.ip_local_port_range = 1024 65500 +net.ipv4.tcp_max_tw_buckets = 5000 +net.core.somaxconn = 65535 +net.core.netdev_max_backlog = 262144 +net.ipv4.tcp_max_orphans = 262144 +net.ipv4.tcp_max_syn_backlog = 262144 +net.ipv4.tcp_timestamps = 0 +net.ipv4.tcp_synack_retries = 1 +net.ipv4.tcp_syn_retries = 1 +net.ipv4.tcp_fin_timeout = 1 +net.ipv4.tcp_keepalive_time = 60 +net.ipv4.tcp_mem = 362619 483495 725238 +net.ipv4.tcp_rmem = 4096 87380 6291456 +net.ipv4.tcp_wmem = 4096 16384 4194304 +net.core.wmem_default = 8388608 +net.core.rmem_default = 8388608 +net.core.rmem_max = 16777216 +net.core.wmem_max = 16777216 + +[systemctl] +sysmonitor=stop +irqbalance=stop + +[bootloader.grub2] +selinux=0 +iommu.passthrough=1 + +[tip] +bind your master process to the CPU near the network = affinity +bind your network interrupt to the CPU that has this network = affinity +relogin into the system to enable limits setting = OS + +[script] +openssl_hpre = 0 +prefetch = off + +[ulimit] +{user}.hard.nofile = 102400 +{user}.soft.nofile = 102400 + +[affinity.task] +#TODO CONFIG + +[affinity.irq] +#TODO CONFIG + +[check] +#TODO CONFIG + +``` + +

设置profile

+ +

profile

+ +## 功能描述 + +手动激活workload\_type对应的profile，使得workload\_type处于active状态。 + +## 命令格式 + +**atune-adm profile **_<_WORKLOAD\_TYPE_\>_ + +## 参数说明 + +WORKLOAD\_TYPE 支持的类型参考list命令查询结果。 + +## 使用示例 + +激活webserver对应的profile配置。 + +``` +$ atune-adm profile webserver +``` + +

回滚profile

+ +

rollback

+ +## 功能描述 + +回退当前的配置到系统的初始配置。 + +## 命令格式 + +**atune-adm rollback** + +## 使用示例 + +``` +$ atune-adm rollback +``` + +

更新数据库

+ +

upgrade

+ +## 功能描述 + +更新系统的数据库。 + +## 命令格式 + +**atune-adm upgrade** + +## 使用示例 + +数据库更新为new\_sqlite.db。 + +``` +$ atune-adm upgrade ./new_sqlite.db +``` + +

系统信息查询

+ +

check

+ +## 功能描述 + +检查系统当前的cpu、bios、os、网卡等信息。 + +## 命令格式 + +**atune-adm check** + +## 使用示例 + +``` +$ atune-adm check + cpu information: + cpu:0 version: Kunpeng 920-6426 speed: 2600000000 HZ cores: 64 + cpu:1 version: Kunpeng 920-6426 speed: 2600000000 HZ cores: 64 + system information: + DMIBIOSVersion: 0.59 + OSRelease: 4.19.36-vhulk1906.3.0.h356.eulerosv2r8.aarch64 + network information: + name: eth0 product: HNS GE/10GE/25GE RDMA Network Controller + name: eth1 product: HNS GE/10GE/25GE Network Controller + name: eth2 product: HNS GE/10GE/25GE RDMA Network Controller + name: eth3 product: HNS GE/10GE/25GE Network Controller + name: eth4 product: HNS GE/10GE/25GE RDMA Network Controller + name: eth5 product: HNS GE/10GE/25GE Network Controller + name: eth6 product: HNS GE/10GE/25GE RDMA Network Controller + name: eth7 product: HNS GE/10GE/25GE Network Controller + name: docker0 product: +``` + +

参数自调优

+ +A-Tune提供了最佳配置的自动搜索能力，免去人工反复做参数调整、性能评价的调优过程，极大地提升最优配置的搜寻效率。 + +

tuning

+ +## 功能描述 + +使用指定的项目文件对参数进行动态空间的搜索，找到当前环境配置下的最优解。 + +## 命令格式 + +>![](public_sys-resources/icon-note.gif) **说明：** +>在运行命令前，需要满足如下条件： +>1. 编辑好服务端yaml配置文件，且需要服务端管理员将该配置文件放到服务端的/etc/atuned/tuning/目录下。 +>2. 编辑好客户端yaml配置文件并放在客户端任一目录。 + +**atune-adm tuning** + +其中PROJECT\_YAML为客户端yaml配置文件。 + +## 配置说明 + +**服务端yaml文件配置说明** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

配置名称

+

配置说明

+

参数类型

+

取值范围

+

project

+

项目名称

+

字符串

+

-

+

startworkload

+

待调服务的启动脚本

+

字符串

+

-

+

stopworkload

+

待调服务的停止脚本

+

字符串

+

-

+

maxiterations

+

最大调优迭代次数，用于限制客户端的迭代次数

+

整型

+

>=10

+

object

+

需要调节的参数项及信息

+

-

+

-

+
+ +**表 1** object项配置说明 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

配置名称

+

配置说明

+

参数类型

+

取值范围

+

name

+

待调参数名称

+

字符串

+

-

+

desc

+

待调参数描述

+

字符串

+

-

+

get

+

查询参数值的脚本

+

-

+

-

+

set

+

设置参数值的脚本

+

-

+

-

+

needrestart

+

参数生效是否需要重启业务

+

枚举

+

"true", "false"

+

type

+

参数的类型，目前支持discrete, continuous两种类型，对应离散型、连续型参数

+

枚举

+

"discrete", "continuous"

+

dtype

+

type为discrete类型时的参数值类型，目前支持int和string两种

+

枚举

+

int, string

+

scope

+

参数设置范围，dtype为int时使用

+

整型

+

用户自定义，取值在该参数的合法范围

+

step

+

参数值步长，dtype为int时使用

+

整型

+

用户自定义

+

items

+

参数值在选定范围之外的枚举值，dtype为int时使用

+

整型

+

用户自定义，取值在该参数的合法范围

+

options

+

参数值的枚举范围，dtype为string时使用

+

字符串

+

用户自定义，取值在该参数的合法范围

+

ref

+

参数的推荐初始值

+

整型或字符串

+

用户自定义，取值在该参数的合法范围

+
+ +**客户端yaml文件配置说明** + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

配置名称

+

配置说明

+

参数类型

+

取值范围

+

project

+

项目名称，需要与服务端对应配置文件中的project匹配

+

字符串

+

-

+

iterations

+

调优迭代次数

+

整型

+

>=10

+

benchmark

+

性能测试脚本

+

-

+

-

+

evaluations

+

性能测试评估指标

+

-

+

-

+
+ +**表 2** evaluations项配置说明 + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +

配置名称

+

配置说明

+

参数类型

+

取值范围

+

name

+

评价指标名称

+

字符串

+

-

+

get

+

获取性能评估结果的脚本

+

-

+

-

+

type

+

评估结果的正负类型，positive代表最小化对应性能值，negative代表最大化对应性能

+

枚举

+

"positive","negative"

+

weight

+

该指标的权重百分比，0-100

+

整型

+

0-100

+

threshold

+

该指标的最低性能要求

+

整型

+

用户指定

+
+ +## 配置示例 + +服务端yaml文件配置样例： + +``` +project: "example" +maxiterations: 10 +startworkload: "" +stopworkload: "" +object : + - + name : "vm.swappiness" + info : + desc : "the vm.swappiness" + get : "sysctl -a | grep vm.swappiness" + set : "sysctl -w vm.swappiness=$value" + needrestart: "false" + type : "continuous" + scope : + - 0 + - 10 + ref : 1 + - + name : "irqbalance" + info : + desc : "system irqbalance" + get : "systemctl status irqbalance" + set : "systemctl $value sysmonitor;systemctl $value irqbalance" + needrestart: "false" + type : "discrete" + options: + - "start" + - "stop" + dtype : "string" + ref : "start" + - + name : "net.tcp_min_tso_segs" + info : + desc : "the minimum tso number" + get : "cat /proc/sys/net/ipv4/tcp_min_tso_segs" + set : "echo $value > /proc/sys/net/ipv4/tcp_min_tso_segs" + needrestart: "false" + type : "continuous" + scope: + - 1 + - 16 + ref : 2 + - + name : "prefetcher" + info : + desc : "" + get : "cat /sys/class/misc/prefetch/policy" + set : "echo $value > /sys/class/misc/prefetch/policy" + needrestart: "false" + type : "discrete" + options: + - "0" + - "15" + dtype : "string" + ref : "15" + - + name : "kernel.sched_min_granularity_ns" + info : + desc : "Minimal preemption granularity for CPU-bound tasks" + get : "sysctl kernel.sched_min_granularity_ns" + set : "sysctl -w kernel.sched_min_granularity_ns=$value" + needrestart: "false" + type : "continuous" + scope: + - 5000000 + - 50000000 + ref : 10000000 + - + name : "kernel.sched_latency_ns" + info : + desc : "" + get : "sysctl kernel.sched_latency_ns" + set : "sysctl -w kernel.sched_latency_ns=$value" + needrestart: "false" + type : "continuous" + scope: + - 10000000 + - 100000000 + ref : 16000000 + +``` + +客户端yaml文件配置样例： + +``` +project: "example" +iterations : 10 +benchmark : "sh /home/Benchmarks/mysql/tunning_mysql.sh" +evaluations : + - + name: "tps" + info: + get: "echo -e '$out' |grep 'transactions:' |awk '{print $3}' | cut -c 2-" + type: "negative" + weight: 100 + threshold: 100 +``` + +## 使用示例 + +``` +$ atune-adm tuning example-client.yaml +``` + +

附录

+ +

术语和缩略语

+ +**表 1** 术语表 + + + + + + + + + + + + + +

术语

+

含义

+

workload_type

+

负载类型，用于标记具有相同特征的一类业务

+

profile

+

优化项集合，最佳的参数配置

+
+ -- Gitee From 596eaa74ea83d62833082d355a6797462d34678a Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:43:03 +0800 Subject: [PATCH 03/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/public=5Fsys-resources?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../public_sys-resources/icon-caution.gif | Bin 580 -> 0 bytes .../public_sys-resources/icon-danger.gif | Bin 580 -> 0 bytes .../UserGuide/public_sys-resources/icon-note.gif | Bin 394 -> 0 bytes .../public_sys-resources/icon-notice.gif | Bin 406 -> 0 bytes .../UserGuide/public_sys-resources/icon-tip.gif | Bin 253 -> 0 bytes .../public_sys-resources/icon-warning.gif | Bin 580 -> 0 bytes 6 files changed, 0 insertions(+), 0 deletions(-) delete mode 100755 Documentation/UserGuide/public_sys-resources/icon-caution.gif delete mode 100755 Documentation/UserGuide/public_sys-resources/icon-danger.gif delete mode 100755 Documentation/UserGuide/public_sys-resources/icon-note.gif delete mode 100755 Documentation/UserGuide/public_sys-resources/icon-notice.gif delete mode 100755 Documentation/UserGuide/public_sys-resources/icon-tip.gif delete mode 100755 Documentation/UserGuide/public_sys-resources/icon-warning.gif diff --git a/Documentation/UserGuide/public_sys-resources/icon-caution.gif b/Documentation/UserGuide/public_sys-resources/icon-caution.gif deleted file mode 100755 index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 580 zcmV-K0=xZ3Nk%w1VIu$?0Hp~4{QBgqmQ+MG9K51r{QB&)np^||1PlfQ%(86!{`~yv zv{XhUWKt}AZaiE{EOcHp{O-j3`t;<+eEiycJT4p@77X;(jQsMfB$R?oG%6hQ z+MMLZbQBH@)Vg&1^3?qHb(5!%>3r0+`eq=&V&E}0Dypi0000000000 z00000A^8LW000R9EC2ui03!e$000L5z=Uu}ED8YtqjJd<+B}(9bIOb$3-31_h|V>=0A{ z1Hh0#H30>fNT})^fRU_83uewx9oRr{f{Sx1Ml`t)EQ zGkHZ67&~y{W5Jpq4H_WfuLxp*3<7O}GEl;1ESe36fLNs=B0&LQM1Buf(R)qg(BRd`t1OPjI1m_q4 diff --git a/Documentation/UserGuide/public_sys-resources/icon-danger.gif b/Documentation/UserGuide/public_sys-resources/icon-danger.gif deleted file mode 100755 index 6e90d7cfc2193e39e10bb58c38d01a23f045d571..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 580 zcmV-K0=xZ3Nk%w1VIu$?0Hp~4{QBgqmQ+MG9K51r{QB&)np^||1PlfQ%(86!{`~yv zv{XhUWKt}AZaiE{EOcHp{O-j3`t;<+eEiycJT4p@77X;(jQsMfB$R?oG%6hQ z+MMLZbQBH@)Vg&1^3?qHb(5!%>3r0+`eq=&V&E}0Dypi0000000000 z00000A^8LW000R9EC2ui03!e$000L5z=Uu}ED8YtqjJd<+B}(9bIOb$3-31_h|V>=0A{ z1Hh0#H30>fNT})^fRU_83uewx9oRr{f{Sx1Ml`t)EQ zGkHZ67&~y{W5Jpq4H_WfuLxp*3<7O}GEl;1ESe36fLNs=B0&LQM1Buf(R)qg(BRd`t1OPjI1m_q4 diff --git a/Documentation/UserGuide/public_sys-resources/icon-note.gif b/Documentation/UserGuide/public_sys-resources/icon-note.gif deleted file mode 100755 index 6314297e45c1de184204098efd4814d6dc8b1cda..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 394 zcmZ?wbhEHblx7fPSjxcg=ii?@_wH=jwxy=7CMGH-B`L+l$wfv=#>UF#$gv|VY%C^b zCQFtrnKN(Bo_%|sJbO}7RAORe!otL&qo<>yq_Sq+8Xqqo5h0P3w3Lvb5E(g{p01vl zxR@)KuDH0l^z`+-dH3eaw=XqSH7aTIx{kzVBN;X&hha0dQSgWuiw0NWUvMRmkD|> diff --git a/Documentation/UserGuide/public_sys-resources/icon-notice.gif b/Documentation/UserGuide/public_sys-resources/icon-notice.gif deleted file mode 100755 index 86024f61b691400bea99e5b1f506d9d9aef36e27..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 406 zcmV;H0crk6Nk%w1VIu$@0J8u9|NsB@_xJDb@8;&_*4Ea}&d#;9wWXz{jEszHYim+c zQaU<1At50E0000000000A^8Le000gEEC2ui03!e%000R7038S%NU)&51O^i-Tu6`s z0)`MFE@;3YqD6xSC^kTNu_J>91{PH8XfZ(p1pp2-SU@u3#{mEUC}_}tg3+I#{z}{Ok@D_ZUDg- zt0stin4;pC8M{WLSlRH*1pzqEw1}3oOskyNN?j;7HD{BBZ*OEcv4HK!6Bk6beR+04 z&8}k>SkTusVTDmkyOz#5fCA$JTPGJVQvr3uZ?QzzPQFvD0rGf_PdrcF`pMs}p^BcF zKtKTd`0wipR%nKN&Wj+V}pX;WC3SdJV!a_8Qi zE7z`U*|Y^H0^}fB$R?oG%6hQ z+MMLZbQBH@)Vg&1^3?qHb(5!%>3r0+`eq=&V&E}0Dypi0000000000 z00000A^8LW000R9EC2ui03!e$000L5z=Uu}ED8YtqjJd<+B}(9bIOb$3-31_h|V>=0A{ z1Hh0#H30>fNT})^fRU_83uewx9oRr{f{Sx1Ml`t)EQ zGkHZ67&~y{W5Jpq4H_WfuLxp*3<7O}GEl;1ESe36fLNs=B0&LQM1Buf(R)qg(BRd`t1OPjI1m_q4 -- Gitee From c1d9850075d14b46026ab3e8727aa054968f0eda Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:43:30 +0800 Subject: [PATCH 04/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/analysis.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/analysis.md | 42 ----------------------------- 1 file changed, 42 deletions(-) delete mode 100755 Documentation/UserGuide/analysis.md diff --git a/Documentation/UserGuide/analysis.md b/Documentation/UserGuide/analysis.md deleted file mode 100755 index 52eb3c2d..00000000 --- a/Documentation/UserGuide/analysis.md +++ /dev/null @@ -1,42 +0,0 @@ -# analysis - -## 功能描述 - -采集系统的实时统计数据进行负载类型识别，并进行自动优化。 - -## 命令格式 - -**atune-adm analysis** \[OPTIONS\] - -## 参数说明 - - - - - - - - - - -

参数

-

描述

-

--model, -m

-

用户自训练产生的新模型

-
- -## 使用示例 - -- 使用默认的模型进行分类识别 - - ``` - $ atune-adm analysis - ``` - -- 使用自训练的模型进行识别 - - ``` - $ atune-adm analysis --model ./model/new-model.m - ``` - - -- Gitee From e25652c9e8feee3d5cf75afb60e76192e6590eaf Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:43:37 +0800 Subject: [PATCH 05/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/check.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/check.md | 32 -------------------------------- 1 file changed, 32 deletions(-) delete mode 100755 Documentation/UserGuide/check.md diff --git a/Documentation/UserGuide/check.md b/Documentation/UserGuide/check.md deleted file mode 100755 index 3cb01289..00000000 --- a/Documentation/UserGuide/check.md +++ /dev/null @@ -1,32 +0,0 @@ -# check - -## 功能描述 - -检查系统当前的cpu、bios、os、网卡等信息。 - -## 命令格式 - -**atune-adm check** - -## 使用示例 - -``` -$ atune-adm check - cpu information: - cpu:0 version: Kunpeng 920-6426 speed: 2600000000 HZ cores: 64 - cpu:1 version: Kunpeng 920-6426 speed: 2600000000 HZ cores: 64 - system information: - DMIBIOSVersion: 0.59 - OSRelease: 4.19.36-vhulk1906.3.0.h356.eulerosv2r8.aarch64 - network information: - name: eth0 product: HNS GE/10GE/25GE RDMA Network Controller - name: eth1 product: HNS GE/10GE/25GE Network Controller - name: eth2 product: HNS GE/10GE/25GE RDMA Network Controller - name: eth3 product: HNS GE/10GE/25GE Network Controller - name: eth4 product: HNS GE/10GE/25GE RDMA Network Controller - name: eth5 product: HNS GE/10GE/25GE Network Controller - name: eth6 product: HNS GE/10GE/25GE RDMA Network Controller - name: eth7 product: HNS GE/10GE/25GE Network Controller - name: docker0 product: -``` - -- Gitee From 6e93cb1a249921ab3c9e3197e62a1a731fb43cdb Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:43:45 +0800 Subject: [PATCH 06/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/collection.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/collection.md | 64 --------------------------- 1 file changed, 64 deletions(-) delete mode 100755 Documentation/UserGuide/collection.md diff --git a/Documentation/UserGuide/collection.md b/Documentation/UserGuide/collection.md deleted file mode 100755 index db77849c..00000000 --- a/Documentation/UserGuide/collection.md +++ /dev/null @@ -1,64 +0,0 @@ -# collection - -## 功能描述 - -采集业务运行时系统的全局资源使用情况以及OS的各项状态信息，并将收集的结果保存到csv格式的输出文件中，作为模型训练的输入数据集。 - ->![](public_sys-resources/icon-note.gif) **说明：** ->本命令依赖采样工具perf，mpstat，vmstat，iostat，sar。CPU型号目前仅支持鲲鹏920，可通过dmidecode -t processor检查CPU型号。 - -## 命令格式 - -**atune-adm collection** - -## 参数说明 - -- OPTIONS - - - - - - - - - - - - - - - - - - - - - - - - - -

参数

-

描述

-

--filename, -f

-

生成的用于训练的csv文件名：name-时间戳.csv

-

--output_path, -o

-

生成的csv文件的存放路径

-

--disk, -b

-

业务运行时实际使用的磁盘，如/dev/sda

-

--network, -n

-

业务运行时使用的网络接口，如eth0

-

--workload_type, -t

-

标记业务的负载类型，作为后续训练的标签

-

--duration, -d

-

业务运行时采集数据的时间

-
- - -## 使用示例 - -``` -$ atune-adm collection --filename name --interval 5 --duration 1200 --output_path ./data –-disk sda --network eth0 --workload_type test_type -``` - -- Gitee From 2fd24112d03cd56dce7b9c0cec8bf0a2f6fd10d2 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:43:50 +0800 Subject: [PATCH 07/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/define.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/define.md | 49 ------------------------------- 1 file changed, 49 deletions(-) delete mode 100755 Documentation/UserGuide/define.md diff --git a/Documentation/UserGuide/define.md b/Documentation/UserGuide/define.md deleted file mode 100755 index b5b49c8e..00000000 --- a/Documentation/UserGuide/define.md +++ /dev/null @@ -1,49 +0,0 @@ -# define - -## 功能描述 - -添加用户自定义的workload\_type，及对应的profile优化项。 - -## 命令格式 - -**atune-adm define** - -## 使用示例 - -新增一个workload type，workload type的名称为test\_type，profile name的名称为test\_name，优化项的配置文件为example.conf。 - -``` -$ atune-adm define test_type test_name ./example.conf -``` - -example.conf 可以参考如下方式书写（以下各优化项非必填，仅供参考），也可通过**atune-adm info**查看已有的profile是如何书写的。 - -``` -[main] -# list it's parent profile -[tip] -# the recommended optimization, which should be performed manunaly -[check] -# check the environment -[affinity.irq] -# to change the affinity of irqs -[affinity.task] -# to change the affinity of tasks -[bios] -# to change the bios config -[bootloader.grub2] -# to change the grub2 config -[kernel_config] -# to change the kernel config -[script] -# the script extention of cpi -[sysctl] -# to change the /proc/sys/* config -[sysfs] -# to change the /sys/* config -[systemctl] -# to change the system service config -[ulimit] -# to change the resources limit of user -``` - -- Gitee From e8c8ea08dae7be936c1d7508abded0bfc059b8e3 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:43:56 +0800 Subject: [PATCH 08/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/info.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/info.md | 95 --------------------------------- 1 file changed, 95 deletions(-) delete mode 100755 Documentation/UserGuide/info.md diff --git a/Documentation/UserGuide/info.md b/Documentation/UserGuide/info.md deleted file mode 100755 index 3ac862df..00000000 --- a/Documentation/UserGuide/info.md +++ /dev/null @@ -1,95 +0,0 @@ -# info - -## 功能描述 - -查看workload\_type对应的profile内容。 - -## 命令格式 - -**atune-adm info** <_WORKLOAD\_TYPE\>_ - -## 使用示例 - -查看webserver的profile内容： - -``` -$ atune-adm info webserver - -*** ssl_webserver: - -# -# webserver tuned configuration -# -[main] -#TODO CONFIG - -[kernel_config] -#TODO CONFIG - -[bios] -#TODO CONFIG - -[sysfs] -#TODO CONFIG - -[sysctl] -fs.file-max=6553600 -fs.suid_dumpable = 1 -fs.aio-max-nr = 1048576 -kernel.shmmax = 68719476736 -kernel.shmall = 4294967296 -kernel.shmmni = 4096 -kernel.sem = 250 32000 100 128 -net.ipv4.tcp_tw_reuse = 1 -net.ipv4.tcp_syncookies = 1 -net.ipv4.ip_local_port_range = 1024 65500 -net.ipv4.tcp_max_tw_buckets = 5000 -net.core.somaxconn = 65535 -net.core.netdev_max_backlog = 262144 -net.ipv4.tcp_max_orphans = 262144 -net.ipv4.tcp_max_syn_backlog = 262144 -net.ipv4.tcp_timestamps = 0 -net.ipv4.tcp_synack_retries = 1 -net.ipv4.tcp_syn_retries = 1 -net.ipv4.tcp_fin_timeout = 1 -net.ipv4.tcp_keepalive_time = 60 -net.ipv4.tcp_mem = 362619 483495 725238 -net.ipv4.tcp_rmem = 4096 87380 6291456 -net.ipv4.tcp_wmem = 4096 16384 4194304 -net.core.wmem_default = 8388608 -net.core.rmem_default = 8388608 -net.core.rmem_max = 16777216 -net.core.wmem_max = 16777216 - -[systemctl] -sysmonitor=stop -irqbalance=stop - -[bootloader.grub2] -selinux=0 -iommu.passthrough=1 - -[tip] -bind your master process to the CPU near the network = affinity -bind your network interrupt to the CPU that has this network = affinity -relogin into the system to enable limits setting = OS - -[script] -openssl_hpre = 0 -prefetch = off - -[ulimit] -{user}.hard.nofile = 102400 -{user}.soft.nofile = 102400 - -[affinity.task] -#TODO CONFIG - -[affinity.irq] -#TODO CONFIG - -[check] -#TODO CONFIG - -``` - -- Gitee From 29dc5de670025ad0801ebe38b2dbdfc8109dfaa1 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:01 +0800 Subject: [PATCH 09/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/list.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/list.md | 43 --------------------------------- 1 file changed, 43 deletions(-) delete mode 100755 Documentation/UserGuide/list.md diff --git a/Documentation/UserGuide/list.md b/Documentation/UserGuide/list.md deleted file mode 100755 index ae7542e3..00000000 --- a/Documentation/UserGuide/list.md +++ /dev/null @@ -1,43 +0,0 @@ -# list - -## 功能描述 - -查询系统当前支持的workload\_type和对应的profile，以及当前处于active状态的profile。 - -## 命令格式 - -**atune-adm list** - -## 使用示例 - -``` -$ atune-adm list - -Support WorkloadTypes: -+-----------------------------------+------------------------+-----------+ -| WorkloadType | ProfileName | Active | -+===================================+========================+===========+ -| default | default | true | -+-----------------------------------+------------------------+-----------+ -| webserver | ssl_webserver | false | -+-----------------------------------+------------------------+-----------+ -| big_database | database | false | -+-----------------------------------+------------------------+-----------+ -| big_data | big_data | false | -+-----------------------------------+------------------------+-----------+ -| in-memory_computing | in-memory_computing | false | -+-----------------------------------+------------------------+-----------+ -| in-memory_database | in-memory_database | false | -+-----------------------------------+------------------------+-----------+ -| single_computer_intensive_jobs | compute-intensive | false | -+-----------------------------------+------------------------+-----------+ -| communication | rpc_communication | false | -+-----------------------------------+------------------------+-----------+ -| idle | default | false | -+-----------------------------------+------------------------+-----------+ - -``` - ->![](public_sys-resources/icon-note.gif) **说明：** ->Active为true表示当前激活的profile，示例表示当前激活的是default类型对应的profile。 - -- Gitee From c39e9b82d3e013b9d32a9095876e8b0da4d19643 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:08 +0800 Subject: [PATCH 10/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/profile.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/profile.md | 22 ---------------------- 1 file changed, 22 deletions(-) delete mode 100755 Documentation/UserGuide/profile.md diff --git a/Documentation/UserGuide/profile.md b/Documentation/UserGuide/profile.md deleted file mode 100755 index a085c3c9..00000000 --- a/Documentation/UserGuide/profile.md +++ /dev/null @@ -1,22 +0,0 @@ -# profile - -## 功能描述 - -手动激活workload\_type对应的profile，使得workload\_type处于active状态。 - -## 命令格式 - -**atune-adm profile **_<_WORKLOAD\_TYPE_\>_ - -## 参数说明 - -WORKLOAD\_TYPE 支持的类型参考list命令查询结果。 - -## 使用示例 - -激活webserver对应的profile配置。 - -``` -$ atune-adm profile webserver -``` - -- Gitee From b1b19b55139c53686f206e1c343208907172661e Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:15 +0800 Subject: [PATCH 11/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/rollback.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/rollback.md | 16 ---------------- 1 file changed, 16 deletions(-) delete mode 100755 Documentation/UserGuide/rollback.md diff --git a/Documentation/UserGuide/rollback.md b/Documentation/UserGuide/rollback.md deleted file mode 100755 index 6b8b03b7..00000000 --- a/Documentation/UserGuide/rollback.md +++ /dev/null @@ -1,16 +0,0 @@ -# rollback - -## 功能描述 - -回退当前的配置到系统的初始配置。 - -## 命令格式 - -**atune-adm rollback** - -## 使用示例 - -``` -$ atune-adm rollback -``` - -- Gitee From bfbfbd47739d6ace805505d7cd73a69a5a17d90b Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:20 +0800 Subject: [PATCH 12/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/train.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/train.md | 43 -------------------------------- 1 file changed, 43 deletions(-) delete mode 100755 Documentation/UserGuide/train.md diff --git a/Documentation/UserGuide/train.md b/Documentation/UserGuide/train.md deleted file mode 100755 index 2841cf2d..00000000 --- a/Documentation/UserGuide/train.md +++ /dev/null @@ -1,43 +0,0 @@ -# train - -## 功能描述 - -使用采集的数据进行模型的训练。训练时至少采集两种workload\_type的数据，否则会报错。 - -## 命令格式 - -**atune-adm train** - -## 参数说明 - -- OPTIONS - - - - - - - - - - - - - -

参数

-

描述

-

--data_path, -d

-

存放模型训练所需的csv文件的目录

-

--output_file, -o

-

训练生成的新模型

-
- - -## 使用示例 - -使用data目录下的csv文件作为训练输入，生成的新模型new-model.m存放在model目录下。 - -``` -$ atune-adm train --data_path ./data –output_file ./model/new-model.m -``` - -- Gitee From aa5711e1be1ac472b7d53e78d05211e9993d27e6 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:26 +0800 Subject: [PATCH 13/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/tuning.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/tuning.md | 426 ------------------------------ 1 file changed, 426 deletions(-) delete mode 100755 Documentation/UserGuide/tuning.md diff --git a/Documentation/UserGuide/tuning.md b/Documentation/UserGuide/tuning.md deleted file mode 100755 index 1ab6334f..00000000 --- a/Documentation/UserGuide/tuning.md +++ /dev/null @@ -1,426 +0,0 @@ -# tuning - -## 功能描述 - -使用指定的项目文件对参数进行动态空间的搜索，找到当前环境配置下的最优解。 - -## 命令格式 - ->![](public_sys-resources/icon-note.gif) **说明：** ->在运行命令前，需要满足如下条件： ->1. 编辑好服务端yaml配置文件，且需要服务端管理员将该配置文件放到服务端的/etc/atuned/tuning/目录下。 ->2. 编辑好客户端yaml配置文件并放在客户端任一目录。 - -**atune-adm tuning** - -其中PROJECT\_YAML为客户端yaml配置文件。 - -## 配置说明 - -**服务端yaml文件配置说明** - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

配置名称

-

配置说明

-

参数类型

-

取值范围

-

project

-

项目名称

-

字符串

-

-

-

startworkload

-

待调服务的启动脚本

-

字符串

-

-

-

stopworkload

-

待调服务的停止脚本

-

字符串

-

-

-

maxiterations

-

最大调优迭代次数，用于限制客户端的迭代次数

-

整型

-

>=10

-

object

-

需要调节的参数项及信息

-

-

-

-

-
- -**表 1** object项配置说明 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

配置名称

-

配置说明

-

参数类型

-

取值范围

-

name

-

待调参数名称

-

字符串

-

-

-

desc

-

待调参数描述

-

字符串

-

-

-

get

-

查询参数值的脚本

-

-

-

-

-

set

-

设置参数值的脚本

-

-

-

-

-

needrestart

-

参数生效是否需要重启业务

-

枚举

-

"true", "false"

-

type

-

参数的类型，目前支持discrete, continuous两种类型，对应离散型、连续型参数

-

枚举

-

"discrete", "continuous"

-

dtype

-

type为discrete类型时的参数值类型，目前支持int和string两种

-

枚举

-

int, string

-

scope

-

参数设置范围，dtype为int时使用

-

整型

-

用户自定义，取值在该参数的合法范围

-

step

-

参数值步长，dtype为int时使用

-

整型

-

用户自定义

-

items

-

参数值在选定范围之外的枚举值，dtype为int时使用

-

整型

-

用户自定义，取值在该参数的合法范围

-

options

-

参数值的枚举范围，dtype为string时使用

-

字符串

-

用户自定义，取值在该参数的合法范围

-

ref

-

参数的推荐初始值

-

整型或字符串

-

用户自定义，取值在该参数的合法范围

-
- -**客户端yaml文件配置说明** - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

配置名称

-

配置说明

-

参数类型

-

取值范围

-

project

-

项目名称，需要与服务端对应配置文件中的project匹配

-

字符串

-

-

-

iterations

-

调优迭代次数

-

整型

-

>=10

-

benchmark

-

性能测试脚本

-

-

-

-

-

evaluations

-

性能测试评估指标

-

-

-

-

-
- -**表 2** evaluations项配置说明 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

配置名称

-

配置说明

-

参数类型

-

取值范围

-

name

-

评价指标名称

-

字符串

-

-

-

get

-

获取性能评估结果的脚本

-

-

-

-

-

type

-

评估结果的正负类型，positive代表最小化对应性能值，negative代表最大化对应性能

-

枚举

-

"positive","negative"

-

weight

-

该指标的权重百分比，0-100

-

整型

-

0-100

-

threshold

-

该指标的最低性能要求

-

整型

-

用户指定

-
- -## 配置示例 - -服务端yaml文件配置样例： - -``` -project: "example" -maxiterations: 10 -startworkload: "" -stopworkload: "" -object : - - - name : "vm.swappiness" - info : - desc : "the vm.swappiness" - get : "sysctl -a | grep vm.swappiness" - set : "sysctl -w vm.swappiness=$value" - needrestart: "false" - type : "continuous" - scope : - - 0 - - 10 - ref : 1 - - - name : "irqbalance" - info : - desc : "system irqbalance" - get : "systemctl status irqbalance" - set : "systemctl $value sysmonitor;systemctl $value irqbalance" - needrestart: "false" - type : "discrete" - options: - - "start" - - "stop" - dtype : "string" - ref : "start" - - - name : "net.tcp_min_tso_segs" - info : - desc : "the minimum tso number" - get : "cat /proc/sys/net/ipv4/tcp_min_tso_segs" - set : "echo $value > /proc/sys/net/ipv4/tcp_min_tso_segs" - needrestart: "false" - type : "continuous" - scope: - - 1 - - 16 - ref : 2 - - - name : "prefetcher" - info : - desc : "" - get : "cat /sys/class/misc/prefetch/policy" - set : "echo $value > /sys/class/misc/prefetch/policy" - needrestart: "false" - type : "discrete" - options: - - "0" - - "15" - dtype : "string" - ref : "15" - - - name : "kernel.sched_min_granularity_ns" - info : - desc : "Minimal preemption granularity for CPU-bound tasks" - get : "sysctl kernel.sched_min_granularity_ns" - set : "sysctl -w kernel.sched_min_granularity_ns=$value" - needrestart: "false" - type : "continuous" - scope: - - 5000000 - - 50000000 - ref : 10000000 - - - name : "kernel.sched_latency_ns" - info : - desc : "" - get : "sysctl kernel.sched_latency_ns" - set : "sysctl -w kernel.sched_latency_ns=$value" - needrestart: "false" - type : "continuous" - scope: - - 10000000 - - 100000000 - ref : 16000000 - -``` - -客户端yaml文件配置样例： - -``` -project: "example" -iterations : 10 -benchmark : "sh /home/Benchmarks/mysql/tunning_mysql.sh" -evaluations : - - - name: "tps" - info: - get: "echo -e '$out' |grep 'transactions:' |awk '{print $3}' | cut -c 2-" - type: "negative" - weight: 100 - threshold: 100 -``` - -## 使用示例 - -``` -$ atune-adm tuning example-client.yaml -``` - -- Gitee From 8e56f9c5539741db47ce1ac881bf85c49243cc77 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:31 +0800 Subject: [PATCH 14/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/undefine.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/undefine.md | 18 ------------------ 1 file changed, 18 deletions(-) delete mode 100755 Documentation/UserGuide/undefine.md diff --git a/Documentation/UserGuide/undefine.md b/Documentation/UserGuide/undefine.md deleted file mode 100755 index c0c1cd3f..00000000 --- a/Documentation/UserGuide/undefine.md +++ /dev/null @@ -1,18 +0,0 @@ -# undefine - -## 功能描述 - -删除用户自定义的workload\_type。 - -## 命令格式 - -**atune-adm undefine** - -## 使用示例 - -删除自定义的负载类型test\_type。 - -``` -$ atune-adm undefine test_type -``` - -- Gitee From fa441a070d501e25eae64fdd7a76bfe22abd2a99 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:35 +0800 Subject: [PATCH 15/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/update.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/update.md | 18 ------------------ 1 file changed, 18 deletions(-) delete mode 100755 Documentation/UserGuide/update.md diff --git a/Documentation/UserGuide/update.md b/Documentation/UserGuide/update.md deleted file mode 100755 index efb014d4..00000000 --- a/Documentation/UserGuide/update.md +++ /dev/null @@ -1,18 +0,0 @@ -# update - -## 功能描述 - -将workload\_type原来的优化项更新为new.conf中的内容。 - -## 命令格式 - -**atune-adm update** - -## 使用示例 - -更新负载类型为test\_type，优化项名称为test\_name的优化项为new.conf。 - -``` -$ atune-adm update test_type test_name ./new.conf -``` - -- Gitee From 3855ee1583625770e8655592cad6d49c977fb20b Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:42 +0800 Subject: [PATCH 16/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/upgrade.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Documentation/UserGuide/upgrade.md | 18 ------------------ 1 file changed, 18 deletions(-) delete mode 100755 Documentation/UserGuide/upgrade.md diff --git a/Documentation/UserGuide/upgrade.md b/Documentation/UserGuide/upgrade.md deleted file mode 100755 index 019dcf78..00000000 --- a/Documentation/UserGuide/upgrade.md +++ /dev/null @@ -1,18 +0,0 @@ -# upgrade - -## 功能描述 - -更新系统的数据库。 - -## 命令格式 - -**atune-adm upgrade** - -## 使用示例 - -数据库更新为new\_sqlite.db。 - -``` -$ atune-adm upgrade ./new_sqlite.db -``` - -- Gitee From 94b94814fe741c5e9cb3344f936f5ee3ee045f2d Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:48 +0800 Subject: [PATCH 17/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E4=BD=BF=E7=94=A8=E6=96=B9=E6=B3=95.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...77\347\224\250\346\226\271\346\263\225.md" | 25 ------------------- 1 file changed, 25 deletions(-) delete mode 100755 "Documentation/UserGuide/\344\275\277\347\224\250\346\226\271\346\263\225.md" diff --git "a/Documentation/UserGuide/\344\275\277\347\224\250\346\226\271\346\263\225.md" "b/Documentation/UserGuide/\344\275\277\347\224\250\346\226\271\346\263\225.md" deleted file mode 100755 index 52ef40a4..00000000 --- "a/Documentation/UserGuide/\344\275\277\347\224\250\346\226\271\346\263\225.md" +++ /dev/null @@ -1,25 +0,0 @@ -# 使用方法 - -用户可以通过调用A-Tune提供的命令行接口使用A-Tune提供的功能。本章介绍A-Tune命令行接口的功能和使用方式。 - -- **[查询负载类型](查询负载类型.md)** - -- **[自定义负载类型](自定义负载类型.md)** - -- **[自定义模型](自定义模型.md)** - -- **[分析负载类型并自优化](分析负载类型并自优化.md)** - -- **[查询profile](查询profile.md)** - -- **[设置profile](设置profile.md)** - -- **[回滚profile](回滚profile.md)** - -- **[更新数据库](更新数据库.md)** - -- **[系统信息查询](系统信息查询.md)** - -- **[参数自调优](参数自调优.md)** - - -- Gitee From 2465201cfb5319daef4ec21834b1032fdf529fd1 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:52 +0800 Subject: [PATCH 18/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E5=88=86=E6=9E=90=E8=B4=9F=E8=BD=BD?= =?UTF-8?q?=E7=B1=BB=E5=9E=8B=E5=B9=B6=E8=87=AA=E4=BC=98=E5=8C=96.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...6\213\345\271\266\350\207\252\344\274\230\345\214\226.md" | 5 ----- 1 file changed, 5 deletions(-) delete mode 100755 "Documentation/UserGuide/\345\210\206\346\236\220\350\264\237\350\275\275\347\261\273\345\236\213\345\271\266\350\207\252\344\274\230\345\214\226.md" diff --git "a/Documentation/UserGuide/\345\210\206\346\236\220\350\264\237\350\275\275\347\261\273\345\236\213\345\271\266\350\207\252\344\274\230\345\214\226.md" "b/Documentation/UserGuide/\345\210\206\346\236\220\350\264\237\350\275\275\347\261\273\345\236\213\345\271\266\350\207\252\344\274\230\345\214\226.md" deleted file mode 100755 index ce05d551..00000000 --- "a/Documentation/UserGuide/\345\210\206\346\236\220\350\264\237\350\275\275\347\261\273\345\236\213\345\271\266\350\207\252\344\274\230\345\214\226.md" +++ /dev/null @@ -1,5 +0,0 @@ -# 分析负载类型并自优化 - -- **[analysis](analysis.md)** - - -- Gitee From 784316b8b47f688e999d94e13a4abd4137d131de Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:44:59 +0800 Subject: [PATCH 19/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/zh-cn=5Fbookmap=5F0213174665.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../UserGuide/zh-cn_bookmap_0213174665.md | 60 ------------------- 1 file changed, 60 deletions(-) delete mode 100755 Documentation/UserGuide/zh-cn_bookmap_0213174665.md diff --git a/Documentation/UserGuide/zh-cn_bookmap_0213174665.md b/Documentation/UserGuide/zh-cn_bookmap_0213174665.md deleted file mode 100755 index 1864d839..00000000 --- a/Documentation/UserGuide/zh-cn_bookmap_0213174665.md +++ /dev/null @@ -1,60 +0,0 @@ -# A-Tune使用指南 - -- [前言](前言.md) -- [法律申明](法律申明.md) -- [认识A-Tune](认识A-Tune.md) - - [简介](简介.md) - - [架构](架构.md) - - [支持特性与业务模型](支持特性与业务模型.md) - -- [安装与部署](安装与部署.md) - - [软硬件要求](软硬件要求.md) - - [环境准备](环境准备.md) - - [安装A-Tune](安装A-Tune.md) - - [安装模式介绍](安装模式介绍.md) - - [安装操作](安装操作.md) - - - [部署A-Tune](部署A-Tune.md) - - [配置介绍](配置介绍.md) - - - [启动A-Tune](启动A-Tune.md) - -- [使用方法](使用方法.md) - - [查询负载类型](查询负载类型.md) - - [list](list.md) - - - [自定义负载类型](自定义负载类型.md) - - [define](define.md) - - [update](update.md) - - [undefine](undefine.md) - - - [自定义模型](自定义模型.md) - - [collection](collection.md) - - [train](train.md) - - - [分析负载类型并自优化](分析负载类型并自优化.md) - - [analysis](analysis.md) - - - [查询profile](查询profile.md) - - [info](info.md) - - - [设置profile](设置profile.md) - - [profile](profile.md) - - - [回滚profile](回滚profile.md) - - [rollback](rollback.md) - - - [更新数据库](更新数据库.md) - - [upgrade](upgrade.md) - - - [系统信息查询](系统信息查询.md) - - [check](check.md) - - - [参数自调优](参数自调优.md) - - [tuning](tuning.md) - - -- [附录](附录.md) - - [术语和缩略语](术语和缩略语.md) - - -- Gitee From e16a05ef5fa8fee4de430b89e5242f1aa7ebe790 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:45:07 +0800 Subject: [PATCH 20/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E5=89=8D=E8=A8=80.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../UserGuide/\345\211\215\350\250\200.md" | 36 ------------------- 1 file changed, 36 deletions(-) delete mode 100755 "Documentation/UserGuide/\345\211\215\350\250\200.md" diff --git "a/Documentation/UserGuide/\345\211\215\350\250\200.md" "b/Documentation/UserGuide/\345\211\215\350\250\200.md" deleted file mode 100755 index db5f8ca9..00000000 --- "a/Documentation/UserGuide/\345\211\215\350\250\200.md" +++ /dev/null @@ -1,36 +0,0 @@ -# 前言 - -## 概述 - -本文档介绍openEuler系统性能自优化软件A-Tune的安装部署和使用方法，以指导用户快速了解并使用A-Tune。 - -## 读者对象 - -本文档适用于使用openEuler系统并希望了解和使用A-Tune的社区开发者、开源爱好者以及相关合作伙伴。使用人员需要具备基本的Linux操作系统知识。 - -## 符号约定 - -在本文中可能出现下列标志，它们所代表的含义如下。 - - - - - - - - - - - - - -

符号

-

说明

-

-

用于传递设备或环境安全警示信息。如不避免则可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果。

-

“须知”不涉及人身伤害。

-

-

对正文中重点信息的补充说明。

-

“说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。

-
- -- Gitee From 18307778b60a0827c86bc95bd80caa4a0ced6ea0 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:45:12 +0800 Subject: [PATCH 21/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E5=8F=82=E6=95=B0=E8=87=AA=E8=B0=83?= =?UTF-8?q?=E4=BC=98.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...202\346\225\260\350\207\252\350\260\203\344\274\230.md" | 7 ------- 1 file changed, 7 deletions(-) delete mode 100755 "Documentation/UserGuide/\345\217\202\346\225\260\350\207\252\350\260\203\344\274\230.md" diff --git "a/Documentation/UserGuide/\345\217\202\346\225\260\350\207\252\350\260\203\344\274\230.md" "b/Documentation/UserGuide/\345\217\202\346\225\260\350\207\252\350\260\203\344\274\230.md" deleted file mode 100755 index 955732b2..00000000 --- "a/Documentation/UserGuide/\345\217\202\346\225\260\350\207\252\350\260\203\344\274\230.md" +++ /dev/null @@ -1,7 +0,0 @@ -# 参数自调优 - -A-Tune提供了最佳配置的自动搜索能力，免去人工反复做参数调整、性能评价的调优过程，极大地提升最优配置的搜寻效率。 - -- **[tuning](tuning.md)** - - -- Gitee From fec5e002eb37ec0cc07172aa3a4ef94f647f10c4 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:45:18 +0800 Subject: [PATCH 22/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E5=90=AF=E5=8A=A8A-Tune.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../\345\220\257\345\212\250A-Tune.md" | 22 ------------------- 1 file changed, 22 deletions(-) delete mode 100755 "Documentation/UserGuide/\345\220\257\345\212\250A-Tune.md" diff --git "a/Documentation/UserGuide/\345\220\257\345\212\250A-Tune.md" "b/Documentation/UserGuide/\345\220\257\345\212\250A-Tune.md" deleted file mode 100755 index cf8fc5d5..00000000 --- "a/Documentation/UserGuide/\345\220\257\345\212\250A-Tune.md" +++ /dev/null @@ -1,22 +0,0 @@ -# 启动A-Tune - -A-Tune安装完成后，需要启动A-Tune服务才能使用。 - -- 启动atuned服务： - - ``` - $ systemctl start atuned - ``` - - -- 查询atuned服务状态： - - ``` - $ systemctl status atuned - ``` - - 若回显为如下，则服务启动成功。 - - ![](figures/zh-cn_image_0214540398.png) - - -- Gitee From a4297b89201acc203646a32148e61bcd44c65bac Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:45:23 +0800 Subject: [PATCH 23/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E5=9B=9E=E6=BB=9Aprofile.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- "Documentation/UserGuide/\345\233\236\346\273\232profile.md" | 5 ----- 1 file changed, 5 deletions(-) delete mode 100755 "Documentation/UserGuide/\345\233\236\346\273\232profile.md" diff --git "a/Documentation/UserGuide/\345\233\236\346\273\232profile.md" "b/Documentation/UserGuide/\345\233\236\346\273\232profile.md" deleted file mode 100755 index 633e200a..00000000 --- "a/Documentation/UserGuide/\345\233\236\346\273\232profile.md" +++ /dev/null @@ -1,5 +0,0 @@ -# 回滚profile - -- **[rollback](rollback.md)** - - -- Gitee From a3e1ce369c257829ac267935fbc62e4729e5a57a Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:45:28 +0800 Subject: [PATCH 24/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E5=AE=89=E8=A3=85A-Tune.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../UserGuide/\345\256\211\350\243\205A-Tune.md" | 9 --------- 1 file changed, 9 deletions(-) delete mode 100755 "Documentation/UserGuide/\345\256\211\350\243\205A-Tune.md" diff --git "a/Documentation/UserGuide/\345\256\211\350\243\205A-Tune.md" "b/Documentation/UserGuide/\345\256\211\350\243\205A-Tune.md" deleted file mode 100755 index f9870a13..00000000 --- "a/Documentation/UserGuide/\345\256\211\350\243\205A-Tune.md" +++ /dev/null @@ -1,9 +0,0 @@ -# 安装A-Tune - -本章介绍A-Tune的安装模式和安装方法。 - -- **[安装模式介绍](安装模式介绍.md)** - -- **[安装操作](安装操作.md)** - - -- Gitee From 493bb81d72ed73186f4217d426c20d8485fb4c78 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:45:35 +0800 Subject: [PATCH 25/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E5=AE=89=E8=A3=85=E4=B8=8E=E9=83=A8?= =?UTF-8?q?=E7=BD=B2.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...43\205\344\270\216\351\203\250\347\275\262.md" | 15 --------------- 1 file changed, 15 deletions(-) delete mode 100755 "Documentation/UserGuide/\345\256\211\350\243\205\344\270\216\351\203\250\347\275\262.md" diff --git "a/Documentation/UserGuide/\345\256\211\350\243\205\344\270\216\351\203\250\347\275\262.md" "b/Documentation/UserGuide/\345\256\211\350\243\205\344\270\216\351\203\250\347\275\262.md" deleted file mode 100755 index e53e3035..00000000 --- "a/Documentation/UserGuide/\345\256\211\350\243\205\344\270\216\351\203\250\347\275\262.md" +++ /dev/null @@ -1,15 +0,0 @@ -# 安装与部署 - -本章介绍如何安装和部署A-Tune。 - -- **[软硬件要求](软硬件要求.md)** - -- **[环境准备](环境准备.md)** - -- **[安装A-Tune](安装A-Tune.md)** - -- **[部署A-Tune](部署A-Tune.md)** - -- **[启动A-Tune](启动A-Tune.md)** - - -- Gitee From 39c8b6ec678bb6c4729500c37393dfc2ea53913d Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:45:42 +0800 Subject: [PATCH 26/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E5=AE=89=E8=A3=85=E6=93=8D=E4=BD=9C.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...11\350\243\205\346\223\215\344\275\234.md" | 53 ------------------- 1 file changed, 53 deletions(-) delete mode 100755 "Documentation/UserGuide/\345\256\211\350\243\205\346\223\215\344\275\234.md" diff --git "a/Documentation/UserGuide/\345\256\211\350\243\205\346\223\215\344\275\234.md" "b/Documentation/UserGuide/\345\256\211\350\243\205\346\223\215\344\275\234.md" deleted file mode 100755 index bf42d990..00000000 --- "a/Documentation/UserGuide/\345\256\211\350\243\205\346\223\215\344\275\234.md" +++ /dev/null @@ -1,53 +0,0 @@ -# 安装操作 - -安装A-Tune的操作步骤如下： - -1. 挂载openEuler的iso文件。 - - ``` - # mount openEuler-1.0-aarch64-dvd.iso /mnt - ``` - -2. 配置本地yum源。 - - ``` - # vim /etc/yum.repos.d/local.repo - ``` - - 配置内容如下所示： - - ``` - [local] - name=local - baseurl=file:///mnt - gpgcheck=0 - enabled=1 - ``` - -3. 安装A-Tune服务端。 - - >![](public_sys-resources/icon-note.gif) **说明：** - >本步骤会同时安装服务端和客户端软件包，对于单机部署模式，请跳过**步骤4**。 - - ``` - # yum install atune -y - ``` - -4. 安装A-Tune客户端。 - - ``` - # yum install atune-client -y - ``` - -5. 验证是否安装成功。 - - ``` - # rpm -qa | grep atune - atune-client-xxx - atune-db-xxx - atune-xxx - ``` - - 有如上回显信息表示安装成功。 - - -- Gitee From a820b658e3eb731ff93fcd6155e01403158e3534 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:45:49 +0800 Subject: [PATCH 27/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E5=AE=89=E8=A3=85=E6=A8=A1=E5=BC=8F?= =?UTF-8?q?=E4=BB=8B=E7=BB=8D.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...50\241\345\274\217\344\273\213\347\273\215.md" | 15 --------------- 1 file changed, 15 deletions(-) delete mode 100755 "Documentation/UserGuide/\345\256\211\350\243\205\346\250\241\345\274\217\344\273\213\347\273\215.md" diff --git "a/Documentation/UserGuide/\345\256\211\350\243\205\346\250\241\345\274\217\344\273\213\347\273\215.md" "b/Documentation/UserGuide/\345\256\211\350\243\205\346\250\241\345\274\217\344\273\213\347\273\215.md" deleted file mode 100755 index d183b165..00000000 --- "a/Documentation/UserGuide/\345\256\211\350\243\205\346\250\241\345\274\217\344\273\213\347\273\215.md" +++ /dev/null @@ -1,15 +0,0 @@ -# 安装模式介绍 - -A-Tune支持单机模式和分布式模式安装： - -- 单机模式 - - client和server安装到同一台机器上。 - -- 分布式模式 - - client和server分别安装在不同的机器上。 - - -![](figures/zh-cn_image_0214540005.png) - -- Gitee From 8a12cf0c38a2c648a81d7202ec4e68679e1b993c Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:46:00 +0800 Subject: [PATCH 28/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E6=94=AF=E6=8C=81=E7=89=B9=E6=80=A7?= =?UTF-8?q?=E4=B8=8E=E4=B8=9A=E5=8A=A1=E6=A8=A1=E5=9E=8B.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...32\345\212\241\346\250\241\345\236\213.md" | 146 ------------------ 1 file changed, 146 deletions(-) delete mode 100755 "Documentation/UserGuide/\346\224\257\346\214\201\347\211\271\346\200\247\344\270\216\344\270\232\345\212\241\346\250\241\345\236\213.md" diff --git "a/Documentation/UserGuide/\346\224\257\346\214\201\347\211\271\346\200\247\344\270\216\344\270\232\345\212\241\346\250\241\345\236\213.md" "b/Documentation/UserGuide/\346\224\257\346\214\201\347\211\271\346\200\247\344\270\216\344\270\232\345\212\241\346\250\241\345\236\213.md" deleted file mode 100755 index 92e103e7..00000000 --- "a/Documentation/UserGuide/\346\224\257\346\214\201\347\211\271\346\200\247\344\270\216\344\270\232\345\212\241\346\250\241\345\236\213.md" +++ /dev/null @@ -1,146 +0,0 @@ -# 支持特性与业务模型 - -## 支持特性 - -A-Tune支持的主要特性、特性成熟度以及使用建议请参见[表1](#table1919220557576)。 - -**表 1** 特性成熟度 - - - - - - - - - - - - - - - - - - - - -

特性

-

成熟度

-

使用建议

-

七大类11款应用负载类型自动优化

-

已测试

-

试用

-

自定义负载类型和业务模型

-

已测试

-

试用

-

参数自调优

-

已测试

-

试用

-
- -## 支持业务模型 - -根据应用的负载特征，A-Tune将业务分为七大类，各类型的负载特征和A-Tune支持的应用请参见[表2](#table2819164611311)。 - -**表 2** 支持的业务类型和应用 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

业务类型（workload_type）

-

类型说明

-

负载特征

-

支持的应用

-

default

-

默认类型

-

CPU、内存带宽、网络、IO各维度资源使用率都不高

-

N/A

-

webserver

-

https应用

-

CPU使用率高

-

Nginx

-

big_database

-

数据库

-
  • 关系型数据库

    读： CPU、内存带宽、网络使用率高

    -

    写：IO使用率高

    -
-
  • 非关系型数据库

    CPU、IO使用率高

    -
-

MongoDB、MySQL、PostgreSQL、MariaDB

-

big_data

-

大数据

-

CPU、IO使用率较高

-

Hadoop、Spark

-

in-memory_computing

-

内存密集型应用

-

CPU、内存带宽使用率高

-

SPECjbb2015

-

in-memory_database

-

计算+网络密集型应用

-

CPU单核使用率高，多实例下网络使用率高

-

Redis

-

single_computer_intensive_jobs

-

计算密集型应用

-

CPU单核使用率高，部分子项内存带宽使用率高

-

SPECCPU2006

-

communication

-

网络密集型应用

-

CPU、网络使用率高

-

Dubbo

-

idle

-

系统idle

-

系统处于空闲状态，无任何应用运行

-

N/A

-
- -- Gitee From ae1ac6068d893366c3966286db1ccc5800079786 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:46:06 +0800 Subject: [PATCH 29/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E6=9B=B4=E6=96=B0=E6=95=B0=E6=8D=AE?= =?UTF-8?q?=E5=BA=93.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...3\264\346\226\260\346\225\260\346\215\256\345\272\223.md" | 5 ----- 1 file changed, 5 deletions(-) delete mode 100755 "Documentation/UserGuide/\346\233\264\346\226\260\346\225\260\346\215\256\345\272\223.md" diff --git "a/Documentation/UserGuide/\346\233\264\346\226\260\346\225\260\346\215\256\345\272\223.md" "b/Documentation/UserGuide/\346\233\264\346\226\260\346\225\260\346\215\256\345\272\223.md" deleted file mode 100755 index e0d88065..00000000 --- "a/Documentation/UserGuide/\346\233\264\346\226\260\346\225\260\346\215\256\345\272\223.md" +++ /dev/null @@ -1,5 +0,0 @@ -# 更新数据库 - -- **[upgrade](upgrade.md)** - - -- Gitee From 7fa714c388c4d4bd275b8c6c6bedeb1668d36868 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:46:11 +0800 Subject: [PATCH 30/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E6=9C=AF=E8=AF=AD=E5=92=8C=E7=BC=A9?= =?UTF-8?q?=E7=95=A5=E8=AF=AD.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...14\347\274\251\347\225\245\350\257\255.md" | 24 ------------------- 1 file changed, 24 deletions(-) delete mode 100755 "Documentation/UserGuide/\346\234\257\350\257\255\345\222\214\347\274\251\347\225\245\350\257\255.md" diff --git "a/Documentation/UserGuide/\346\234\257\350\257\255\345\222\214\347\274\251\347\225\245\350\257\255.md" "b/Documentation/UserGuide/\346\234\257\350\257\255\345\222\214\347\274\251\347\225\245\350\257\255.md" deleted file mode 100755 index 8ca36fe7..00000000 --- "a/Documentation/UserGuide/\346\234\257\350\257\255\345\222\214\347\274\251\347\225\245\350\257\255.md" +++ /dev/null @@ -1,24 +0,0 @@ -# 术语和缩略语 - -**表 1** 术语表 - - - - - - - - - - - - - -

术语

-

含义

-

workload_type

-

负载类型，用于标记具有相同特征的一类业务

-

profile

-

优化项集合，最佳的参数配置

-
- -- Gitee From a701e4f2151fcc798b7810ea9d028e353d170fab Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:46:17 +0800 Subject: [PATCH 31/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E6=9E=B6=E6=9E=84.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- "Documentation/UserGuide/\346\236\266\346\236\204.md" | 10 ---------- 1 file changed, 10 deletions(-) delete mode 100755 "Documentation/UserGuide/\346\236\266\346\236\204.md" diff --git "a/Documentation/UserGuide/\346\236\266\346\236\204.md" "b/Documentation/UserGuide/\346\236\266\346\236\204.md" deleted file mode 100755 index b06eaeb6..00000000 --- "a/Documentation/UserGuide/\346\236\266\346\236\204.md" +++ /dev/null @@ -1,10 +0,0 @@ -# 架构 - -A-Tune核心技术架构如下图，主要包括智能决策、系统画像和交互系统三层。 - -- 智能决策层：包含感知和决策两个子系统，分别承担对应用的智能感知和对系统的调优决策。 -- 系统画像层：主要包括标注和学习系统，标注系统用于业务模型的聚类，学习系统用于业务模型的学习和分类。 -- 交互系统层：用于各类系统资源的监控和配置，其中调优策略执行在本层进行。 - -![](figures/zh-cn_image_0215591510.png) - -- Gitee From ccafe4100817104d1e1cf661d1f032b3324498e8 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:46:22 +0800 Subject: [PATCH 32/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E6=9F=A5=E8=AF=A2profile.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- "Documentation/UserGuide/\346\237\245\350\257\242profile.md" | 5 ----- 1 file changed, 5 deletions(-) delete mode 100755 "Documentation/UserGuide/\346\237\245\350\257\242profile.md" diff --git "a/Documentation/UserGuide/\346\237\245\350\257\242profile.md" "b/Documentation/UserGuide/\346\237\245\350\257\242profile.md" deleted file mode 100755 index 22e77152..00000000 --- "a/Documentation/UserGuide/\346\237\245\350\257\242profile.md" +++ /dev/null @@ -1,5 +0,0 @@ -# 查询profile - -- **[info](info.md)** - - -- Gitee From 1e57afdc5d64f0d84232021238edef6620a793e8 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:46:54 +0800 Subject: [PATCH 33/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E6=9F=A5=E8=AF=A2=E8=B4=9F=E8=BD=BD?= =?UTF-8?q?=E7=B1=BB=E5=9E=8B.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...7\242\350\264\237\350\275\275\347\261\273\345\236\213.md" | 5 ----- 1 file changed, 5 deletions(-) delete mode 100755 "Documentation/UserGuide/\346\237\245\350\257\242\350\264\237\350\275\275\347\261\273\345\236\213.md" diff --git "a/Documentation/UserGuide/\346\237\245\350\257\242\350\264\237\350\275\275\347\261\273\345\236\213.md" "b/Documentation/UserGuide/\346\237\245\350\257\242\350\264\237\350\275\275\347\261\273\345\236\213.md" deleted file mode 100755 index 8f074345..00000000 --- "a/Documentation/UserGuide/\346\237\245\350\257\242\350\264\237\350\275\275\347\261\273\345\236\213.md" +++ /dev/null @@ -1,5 +0,0 @@ -# 查询负载类型 - -- **[list](list.md)** - - -- Gitee From 0434b39263f3845116cca60484b44838c1a818d1 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:00 +0800 Subject: [PATCH 34/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E6=B3=95=E5=BE=8B=E7=94=B3=E6=98=8E.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...263\225\345\276\213\347\224\263\346\230\216.md" | 14 -------------- 1 file changed, 14 deletions(-) delete mode 100755 "Documentation/UserGuide/\346\263\225\345\276\213\347\224\263\346\230\216.md" diff --git "a/Documentation/UserGuide/\346\263\225\345\276\213\347\224\263\346\230\216.md" "b/Documentation/UserGuide/\346\263\225\345\276\213\347\224\263\346\230\216.md" deleted file mode 100755 index d40ab953..00000000 --- "a/Documentation/UserGuide/\346\263\225\345\276\213\347\224\263\346\230\216.md" +++ /dev/null @@ -1,14 +0,0 @@ -# 法律申明 - -**版权所有 © 2019 华为技术有限公司。** - -您对“本文档”的复制，使用，修改及分发受知识共享\(Creative Commons\)署名—相同方式共享4.0国际公共许可协议\(以下简称“CC BY-SA 4.0”\)的约束。为了方便用户理解，您可以通过访问[https://creativecommons.org/licenses/by-sa/4.0/](https://creativecommons.org/licenses/by-sa/4.0/) 了解CC BY-SA 4.0的概要 \(但不是替代\)。CC BY-SA 4.0的完整协议内容您可以访问如下网址获取：[https://creativecommons.org/licenses/by-sa/4.0/legalcode](https://creativecommons.org/licenses/by-sa/4.0/legalcode)。 - -**商标声明** - -A-Tune为华为技术有限公司的商标。本文档提及的其他所有商标或注册商标，由各自的所有人拥有。 - -**免责声明** - -本文档仅作为使用指导，除非适用法强制规定或者双方有明确书面约定, 华为技术有限公司对本文档中的所有陈述、信息和建议不做任何明示或默示的声明或保证，包括但不限于不侵权，时效性或满足特定目的的担保。 - -- Gitee From a2b9bf42a32ecc30eb8ecec132aed2e995915108 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:05 +0800 Subject: [PATCH 35/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E7=8E=AF=E5=A2=83=E5=87=86=E5=A4=87.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../\347\216\257\345\242\203\345\207\206\345\244\207.md" | 4 ---- 1 file changed, 4 deletions(-) delete mode 100755 "Documentation/UserGuide/\347\216\257\345\242\203\345\207\206\345\244\207.md" diff --git "a/Documentation/UserGuide/\347\216\257\345\242\203\345\207\206\345\244\207.md" "b/Documentation/UserGuide/\347\216\257\345\242\203\345\207\206\345\244\207.md" deleted file mode 100755 index 6c5b1698..00000000 --- "a/Documentation/UserGuide/\347\216\257\345\242\203\345\207\206\345\244\207.md" +++ /dev/null @@ -1,4 +0,0 @@ -# 环境准备 - -安装openEuler系统，安装方法参考《openEuler 1.0 安装指南》。 - -- Gitee From 8b313a3ba69e336abb628b0e9eb57ad8174b1279 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:09 +0800 Subject: [PATCH 36/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E7=AE=80=E4=BB=8B.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- "Documentation/UserGuide/\347\256\200\344\273\213.md" | 8 -------- 1 file changed, 8 deletions(-) delete mode 100755 "Documentation/UserGuide/\347\256\200\344\273\213.md" diff --git "a/Documentation/UserGuide/\347\256\200\344\273\213.md" "b/Documentation/UserGuide/\347\256\200\344\273\213.md" deleted file mode 100755 index 5a911028..00000000 --- "a/Documentation/UserGuide/\347\256\200\344\273\213.md" +++ /dev/null @@ -1,8 +0,0 @@ -# 简介 - -操作系统作为衔接应用和硬件的基础软件，如何调整系统和应用配置，充分发挥软硬件能力，从而提升业务性能，对用户来说至关重要。然而，运行在操作系统上的业务类型成百上千，应用形态千差万别，对资源的要求各不相同，且当前硬件和基础软件组成的应用环境涉及高达7000多个配置对象，随着调优对象的增加，调优所需的时间成本以指数级增长，配置调优成为了一项极其复杂的工程，超出了一般工程师的能力范围。为了应对这些挑战，A-Tune就应运而生了。 - -A-Tune是一款基于openEuler系统开发的性能智能自优化的基础软件，它利用人工智能技术，对应用建立精准的系统画像，通过AI感知并推理出业务特征，从而进行智能决策，匹配得出最佳的系统配置组合，使业务处于最佳运行状态。 - -![](figures/zh-cn_image_0215192422.png) - -- Gitee From 31c7822ed765cd872b87611594d28019a97beb1f Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:15 +0800 Subject: [PATCH 37/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E7=B3=BB=E7=BB=9F=E4=BF=A1=E6=81=AF?= =?UTF-8?q?=E6=9F=A5=E8=AF=A2.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...3\237\344\277\241\346\201\257\346\237\245\350\257\242.md" | 5 ----- 1 file changed, 5 deletions(-) delete mode 100755 "Documentation/UserGuide/\347\263\273\347\273\237\344\277\241\346\201\257\346\237\245\350\257\242.md" diff --git "a/Documentation/UserGuide/\347\263\273\347\273\237\344\277\241\346\201\257\346\237\245\350\257\242.md" "b/Documentation/UserGuide/\347\263\273\347\273\237\344\277\241\346\201\257\346\237\245\350\257\242.md" deleted file mode 100755 index cd39b38d..00000000 --- "a/Documentation/UserGuide/\347\263\273\347\273\237\344\277\241\346\201\257\346\237\245\350\257\242.md" +++ /dev/null @@ -1,5 +0,0 @@ -# 系统信息查询 - -- **[check](check.md)** - - -- Gitee From 63bee01a85b75fcec5665138d600f2100f96b91e Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:21 +0800 Subject: [PATCH 38/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E8=87=AA=E5=AE=9A=E4=B9=89=E6=A8=A1?= =?UTF-8?q?=E5=9E=8B.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...2\345\256\232\344\271\211\346\250\241\345\236\213.md" | 9 --------- 1 file changed, 9 deletions(-) delete mode 100755 "Documentation/UserGuide/\350\207\252\345\256\232\344\271\211\346\250\241\345\236\213.md" diff --git "a/Documentation/UserGuide/\350\207\252\345\256\232\344\271\211\346\250\241\345\236\213.md" "b/Documentation/UserGuide/\350\207\252\345\256\232\344\271\211\346\250\241\345\236\213.md" deleted file mode 100755 index d7688ec2..00000000 --- "a/Documentation/UserGuide/\350\207\252\345\256\232\344\271\211\346\250\241\345\236\213.md" +++ /dev/null @@ -1,9 +0,0 @@ -# 自定义模型 - -A-Tune支持用户训练新的workload\_type。训练方法非常简单，用户只要通过collection和train两条命令，即可完成新模型的训练。 - -- **[collection](collection.md)** - -- **[train](train.md)** - - -- Gitee From a5c4d440a9c49b0a9178d270c97c7146580a0415 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:26 +0800 Subject: [PATCH 39/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E8=87=AA=E5=AE=9A=E4=B9=89=E8=B4=9F?= =?UTF-8?q?=E8=BD=BD=E7=B1=BB=E5=9E=8B.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...\264\237\350\275\275\347\261\273\345\236\213.md" | 13 ------------- 1 file changed, 13 deletions(-) delete mode 100755 "Documentation/UserGuide/\350\207\252\345\256\232\344\271\211\350\264\237\350\275\275\347\261\273\345\236\213.md" diff --git "a/Documentation/UserGuide/\350\207\252\345\256\232\344\271\211\350\264\237\350\275\275\347\261\273\345\236\213.md" "b/Documentation/UserGuide/\350\207\252\345\256\232\344\271\211\350\264\237\350\275\275\347\261\273\345\236\213.md" deleted file mode 100755 index 31bba16a..00000000 --- "a/Documentation/UserGuide/\350\207\252\345\256\232\344\271\211\350\264\237\350\275\275\347\261\273\345\236\213.md" +++ /dev/null @@ -1,13 +0,0 @@ -# 自定义负载类型 - -除了系统已定义的负载类型，A-Tune也支持用户定义新的workload\_type及对应profile，并允许更新或删除自定义的workload\_type。 - -用户也可以将“使用方法 \> 自定义模型”中用户训练的自定义模型添加到A-Tune中。 - -- **[define](define.md)** - -- **[update](update.md)** - -- **[undefine](undefine.md)** - - -- Gitee From b9ae076478c194b102f1382e57525468063659a2 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:32 +0800 Subject: [PATCH 40/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E8=AE=A4=E8=AF=86A-Tune.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../UserGuide/\350\256\244\350\257\206A-Tune.md" | 9 --------- 1 file changed, 9 deletions(-) delete mode 100755 "Documentation/UserGuide/\350\256\244\350\257\206A-Tune.md" diff --git "a/Documentation/UserGuide/\350\256\244\350\257\206A-Tune.md" "b/Documentation/UserGuide/\350\256\244\350\257\206A-Tune.md" deleted file mode 100755 index 25a5896a..00000000 --- "a/Documentation/UserGuide/\350\256\244\350\257\206A-Tune.md" +++ /dev/null @@ -1,9 +0,0 @@ -# 认识A-Tune - -- **[简介](简介.md)** - -- **[架构](架构.md)** - -- **[支持特性与业务模型](支持特性与业务模型.md)** - - -- Gitee From e9159ea9e8269d2f7526a1b2ea124f4e5ee84056 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:37 +0800 Subject: [PATCH 41/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E8=AE=BE=E7=BD=AEprofile.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- "Documentation/UserGuide/\350\256\276\347\275\256profile.md" | 5 ----- 1 file changed, 5 deletions(-) delete mode 100755 "Documentation/UserGuide/\350\256\276\347\275\256profile.md" diff --git "a/Documentation/UserGuide/\350\256\276\347\275\256profile.md" "b/Documentation/UserGuide/\350\256\276\347\275\256profile.md" deleted file mode 100755 index 13340dcb..00000000 --- "a/Documentation/UserGuide/\350\256\276\347\275\256profile.md" +++ /dev/null @@ -1,5 +0,0 @@ -# 设置profile - -- **[profile](profile.md)** - - -- Gitee From 6d14784c239f5883c37ca2a0ea5450c86bd32dd4 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:42 +0800 Subject: [PATCH 42/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E8=BD=AF=E7=A1=AC=E4=BB=B6=E8=A6=81?= =?UTF-8?q?=E6=B1=82.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...347\241\254\344\273\266\350\246\201\346\261\202.md" | 10 ---------- 1 file changed, 10 deletions(-) delete mode 100755 "Documentation/UserGuide/\350\275\257\347\241\254\344\273\266\350\246\201\346\261\202.md" diff --git "a/Documentation/UserGuide/\350\275\257\347\241\254\344\273\266\350\246\201\346\261\202.md" "b/Documentation/UserGuide/\350\275\257\347\241\254\344\273\266\350\246\201\346\261\202.md" deleted file mode 100755 index a7dad39b..00000000 --- "a/Documentation/UserGuide/\350\275\257\347\241\254\344\273\266\350\246\201\346\261\202.md" +++ /dev/null @@ -1,10 +0,0 @@ -# 软硬件要求 - -## 硬件要求 - -- 鲲鹏920处理器 - -## 软件要求 - -- 操作系统：openEuler 1.0 - -- Gitee From 48436b46736d466cebcf64260293fbdefa2f3f84 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:51 +0800 Subject: [PATCH 43/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E9=83=A8=E7=BD=B2A-Tune.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../UserGuide/\351\203\250\347\275\262A-Tune.md" | 7 ------- 1 file changed, 7 deletions(-) delete mode 100755 "Documentation/UserGuide/\351\203\250\347\275\262A-Tune.md" diff --git "a/Documentation/UserGuide/\351\203\250\347\275\262A-Tune.md" "b/Documentation/UserGuide/\351\203\250\347\275\262A-Tune.md" deleted file mode 100755 index 8929b739..00000000 --- "a/Documentation/UserGuide/\351\203\250\347\275\262A-Tune.md" +++ /dev/null @@ -1,7 +0,0 @@ -# 部署A-Tune - -本章介绍A-Tune的配置部署。 - -- **[配置介绍](配置介绍.md)** - - -- Gitee From 3ffcc55bbf154835d6f98a453bb1cee97a3911d0 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:47:56 +0800 Subject: [PATCH 44/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E9=85=8D=E7=BD=AE=E4=BB=8B=E7=BB=8D.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...15\347\275\256\344\273\213\347\273\215.md" | 93 ------------------- 1 file changed, 93 deletions(-) delete mode 100755 "Documentation/UserGuide/\351\205\215\347\275\256\344\273\213\347\273\215.md" diff --git "a/Documentation/UserGuide/\351\205\215\347\275\256\344\273\213\347\273\215.md" "b/Documentation/UserGuide/\351\205\215\347\275\256\344\273\213\347\273\215.md" deleted file mode 100755 index 88f94431..00000000 --- "a/Documentation/UserGuide/\351\205\215\347\275\256\344\273\213\347\273\215.md" +++ /dev/null @@ -1,93 +0,0 @@ -# 配置介绍 - -A-Tune配置文件/etc/atuned/atuned.cnf的配置项说明如下： - -- A-Tune服务启动配置 - - 可根据需要进行修改。 - - - address：系统grpc服务的侦听地址，默认为127.0.0.1，若为多机部署，需进行修改。 - - port：系统grpc服务的侦听端口，范围为0\~65535未使用的端口。 - - rest\_port：系统restservice的侦听端口, 范围为0\~65535未使用的端口。 - - sample\_num：系统执行analysis流程时采集样本的数量。 - -- system信息 - - system为系统执行相关的优化需要用到的参数信息，必须根据系统实际情况进行修改。 - - - disk：执行analysis流程时需要采集的对应磁盘的信息或执行磁盘相关优化时需要指定的磁盘。 - - network：执行analysis时需要采集的对应的网卡的信息或执行网卡相关优化时需要指定的网卡。 - - user：执行ulimit相关优化时用到的用户名。目前只支持root用户。 - - tls：开启A-Tune的gRPC和http服务SSL/TLS证书校验，默认不开启。开启TLS后atune-adm命令在使用前需要设置以下环境变量方可与服务端进行通讯： - - export ATUNE\_TLS=yes - - export ATUNE\_CLICERT=<客户端证书路径\> - - - tlsservercertfile：gPRC服务端证书路径。 - - tlsserverkeyfile：gPRC服务端秘钥路径。 - - tlshttpcertfile：http服务端证书路径。 - - tlshttpkeyfile：http服务端秘钥路径。 - - tlshttpcacertfile：http服务端CA证书路径。 - -- 日志信息 - - 根据情况修改日志的路径和级别，默认的日志信息在/var/log/message中。 - -- monitor信息 - - 为系统启动时默认采集的系统的硬件信息。 - - -## 配置示例 - -``` -#################################### server ############################### -# atuned config -[server] -# the address the grpc server to bind to, default is 127.0.0.1 -address = 127.0.0.1 - -# the atuned grpc listening port, default is 60001 -# the port can be set between 0 to 65535 the not be used -port = 60001 - -# the rest service listening port, default is 8383 -# the port can be set between 0 to 65535 than not be used -rest_port = 8383 - -# when run analysis command, the numbers of collected data. -# default is 20 -sample_num = 20 - -# Enable gRPC and http server authentication SSL/TLS -# default is false -# tls = true -# tlsservercertfile = /etc/atuned/server.pem -# tlsserverkeyfile = /etc/atuned/server.key -# tlshttpcertfile = /etc/atuned/http/server.pem -# tlshttpkeyfile = /etc/atuned/http/server.key -# tlshttpcacertfile = /etc/atuned/http/cacert.pem - -#################################### log ############################### -# Either "debug", "info", "warn", "error", "critical", default is "info" -level = info - -#################################### monitor ############################### -[monitor] -# With the module and format of the MPI, the format is {module}_{purpose} -# The module is Either "mem", "net", "cpu", "storage" -# The purpose is "topo" -module = mem_topo, cpu_topo - -#################################### system ############################### -# you can add arbitrary key-value here, just like key = value -# you can use the key in the profile -[system] -# the disk to be analysis -disk = sda - -# the network to be analysis -network = enp189s0f0 - -user = root -``` - -- Gitee From 4de04c8f746bb8a57071159f9d39480d1b8600e5 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 13:48:04 +0800 Subject: [PATCH 45/46] =?UTF-8?q?=E5=88=A0=E9=99=A4=E6=96=87=E4=BB=B6=20Do?= =?UTF-8?q?cumentation/UserGuide/=E9=99=84=E5=BD=95.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- "Documentation/UserGuide/\351\231\204\345\275\225.md" | 5 ----- 1 file changed, 5 deletions(-) delete mode 100755 "Documentation/UserGuide/\351\231\204\345\275\225.md" diff --git "a/Documentation/UserGuide/\351\231\204\345\275\225.md" "b/Documentation/UserGuide/\351\231\204\345\275\225.md" deleted file mode 100755 index d6719518..00000000 --- "a/Documentation/UserGuide/\351\231\204\345\275\225.md" +++ /dev/null @@ -1,5 +0,0 @@ -# 附录 - -- **[术语和缩略语](术语和缩略语.md)** - - -- Gitee From 2790ae6841557ebe75e516ffc724dd6bf7874c01 Mon Sep 17 00:00:00 2001 From: shanshishi Date: Fri, 3 Jan 2020 14:00:55 +0800 Subject: [PATCH 46/46] =?UTF-8?q?update=20Documentation/UserGuide/A-Tune?= =?UTF-8?q?=E7=94=A8=E6=88=B7=E6=8C=87=E5=8D=97.md.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...50\346\210\267\346\214\207\345\215\227.md" | 26 ------------------- 1 file changed, 26 deletions(-) diff --git "a/Documentation/UserGuide/A-Tune\347\224\250\346\210\267\346\214\207\345\215\227.md" "b/Documentation/UserGuide/A-Tune\347\224\250\346\210\267\346\214\207\345\215\227.md" index 376f1db4..dc9eacce 100644 --- "a/Documentation/UserGuide/A-Tune\347\224\250\346\210\267\346\214\207\345\215\227.md" +++ "b/Documentation/UserGuide/A-Tune\347\224\250\346\210\267\346\214\207\345\215\227.md" @@ -24,32 +24,6 @@ A-Tune和其他华为商标均为华为技术有限公司的商标。本文档 本文档适用于使用openEuler系统并希望了解和使用A-Tune的社区开发者、开源爱好者以及相关合作伙伴。使用人员需要具备基本的Linux操作系统知识。 -## 符号约定 - -在本文中可能出现下列标志，它们所代表的含义如下。 - - - - - - - - - - - - - -

符号

-

说明

-

![](figures/zh-cn_image_0213178479.png)

-

用于传递设备或环境安全警示信息。如不避免则可能会导致设备损坏、数据丢失、设备性能降低或其它不可预知的结果。

-

“须知”不涉及人身伤害。

-

![](figures/zh-cn_image_0213178480.png)

-

对正文中重点信息的补充说明。

-

“说明”不是安全警示信息，不涉及人身、设备及环境伤害信息。

-
-

认识A-Tune

简介

-- Gitee