A-Tune介绍
============

A-Tune是一款系统性能自优化的系统级基础软件，目标是智能识别出系统的负载类型，并进行业务模型到资源模型的动态调度，以充分释放鲲鹏服务器算力，使运行在鲲鹏服务器上的应用得到最佳性能表现。


                                          ````....---::::////////////-.`
                                      `.-//////::::/++/--++.```````./++//-.`
                                  `.-://:.``     -//:.`  .+/`       .++-.:++/:.`
                               `-://:-``       `:+:`      .+/`    `://:. `:+/-///:.``
                           `.:///-.`          `:+-         .+/`    :+-    `/+. `.-://:-``
                       `.-///:.``...`        `/+-          `:+-    `:+`    `/+---..`.-://:-``
                      -//:.`    -:.-/`      `/+/-.---`    `/+-`     `//`    .++::///.` `.-://:-.`
                    ./+-`       `:-://-`    `.--:+-`::   -//.       `:+.     :+.  `:+:--.  ``-://:`
                 `-://.           ` `-//:.`      .---` `:+:`        :+-      `+/`   /-`-:       -+:`
              .-///-`                  ./+/.          .//.        `:+:        :+-   `---`        -+:`
            `:+:.`          `..`      `-//-           -+/`      `--+:         .+/     ```         -+:`
            :+-            ./.-/`    ./+-`             -+-      :-`-:         :+.    -:-:-         -+/`
           :+:            .//--:`  `/+:`    `.-.``````../+-     `---`        `+/     -:.:/`        .++/`
          -+:`          ./+:.``    -+-      :-`:///////:::-                  `+/-`    ..:+-       .+/-+/`
         -+:          ./+:.        .+/      .:-:.``            ``.-:.`       -:`./`     .+:      -+/` .+/`
        .++-..``   `./+:`           /+`        `..`     `.``.-:///:://:-`    `:-:-     `/+.   `.:+/`   .+/`
        .++::////::/+:`           `:+/`       ./.-/`   :-.:+/:.``    `-/+/-`          `.+/``-///:.`     .+/`
         ++`   ``.-+/`           -+/.         ./-::    -:-:.            `-/+-    ``.-:/+/. /+-`          :+-
         -+-       .+/`          ++` .---`     -+:       `      ``..       /+..-////-.`   `+/`          `++`
         `+/`       .+/`        .+/ `/``:-    :+:`         ``.://++-       .+//-.`        .+:           -+-
          :+.        `+/`       :+-  .-:/+- `:+:    `----:/+//-.`.+:        `             :+.          `/+`
          .+:         /+.      `/+`     `:+//+-     -: .+-.`     .+/                     `/+`          .+:
           /+`      `-//.      `+/        `/+:      `-::.        `/+:::::::::-`         .:-:-   `....../+`
           ./+:.    :: ./      -+-          -+/-.        .:/-.    ..........-:+/-`      -:.-:`  :+//////:
             .:+/-` `---`  `.-:++-`         `/.`:-    `-/+:.:/+:.`            `-/+/.`    `.`    :+.
                .:+/-``.-:/+/:-.-/+/-`       -:::`  `-+/-`    .-/+/-`            `-/+:.         :+.
                  `-/++/:..`      `-/+:.`         .:+/.          `.:+/:.` `         .:+/:.     ./+`
                     `               `:/+:.    `./+/---:::.`        `.:/+:-:.         `.:+/-.-/+:.
                                       `.://::/+++//:::---/+/:.`       `:-.::            `/++/-`
                                          `.-..```         `.:/+/-.`     ..`           `:+/-`
                                                               `.:///-``            `-/+:.`
                                                                   `-://:-``...--::/+/-`
                                                                      `.-////:::--..`
                                                                          `
                                  ______        ________
                                 /      \      /        |
                                /$$$$$$  |     $$$$$$$$/__    __  _______    ______
                                $$ |__$$ | ______ $$ | /  |  /  |/       \  /      \
                                $$    $$ |/      |$$ | $$ |  $$ |$$$$$$$  |/$$$$$$  |
                                $$$$$$$$ |$$$$$$/ $$ | $$ |  $$ |$$ |  $$ |$$    $$ |
                                $$ |  $$ |        $$ | $$ \__$$ |$$ |  $$ |$$$$$$$$/
                                $$ |  $$ |        $$ | $$    $$/ $$ |  $$ |$$       |
                                $$/   $$/         $$/   $$$$$$/  $$/   $$/  $$$$$$$/



一、安装A-Tune
----------

支持操作系统：openEuler 1.0及以上版本

### 方法一（适用于普通用户）：使用openEuler默认自带的A-Tune

```bash
yum install -y atune
```

### 方法二（适用于开发者）：从本仓库源码安装

#### 1、安装依赖系统软件包
```bash
yum install -y golang-bin python3 perf sysstat hwloc-gui
```

#### 2、安装python依赖包
```bash
yum install -y python3-dict2xml python3-flask-restful python3-pandas python3-scikit-optimize python3-xgboost
```
或
```bash
pip3 install dict2xml Flask-RESTful pandas scikit-optimize xgboost
```

#### 3、下载源码
```bash
mkdir -p /home/gopath/src
cd /home/gopath/src
git clone https://gitee.com/openeuler/A-Tune.git atune
```

#### 4、编译
```bash
cd atune
make
```

#### 5、安装
```bash
make install
```

二、快速使用指南
------------

### 1、管理atuned服务

#### 启动atuned服务
```bash
systemctl start atuned
```

#### 查看atuned服务状态
```bash
systemctl status atuned
```

### 2、atune-adm命令

#### list命令
列出系统当前支持的workload类型和对应的profile，当前处于active状态的workload类型。

接口语法：

atune-adm list

示例：
```bash
atune-adm list
```

#### analysis命令
实时采集系统的信息进行负载类型的识别，并自动执行对应的优化。

接口语法：

atune-adm analysis [OPTIONS] [APP_NAME]

运行示例1：使用默认的模型进行分类识别
```bash
atune-adm analysis
```
运行示例2：使用自定义训练的模型进行识别
```bash
atune-adm analysis –model ./model/new-model.m
```
运行示例3：指定当前的系统应用为mysql，仅作为参考。
```bash
atune-adm analysis mysql
```

其他命令使用详见atune-adm help信息