长期支持版本

    社区创新版本

      etmem内存分级扩展

      介绍

      随着CPU算力的发展,尤其是ARM核成本的降低,内存成本和内存容量成为约束业务成本和性能的核心痛点,因此如何节省内存成本,如何扩大内存容量成为存储迫切要解决的问题。

      etmem内存分级扩展技术,通过DRAM+内存压缩/高性能存储新介质形成多级内存存储,对内存数据进行分级,将分级后的内存冷数据从内存介质迁移到高性能存储介质中,达到内存容量扩展的目的,从而实现内存成本下降。(当前暂时还没有对非易失内存介质的支持)

      软件架构

      etmem客户端通过socket通信机制与服务端进行交互,下发创建/删除工程、启动/停止工程、查询工程的命令,服务端通过客户端下发的配置文件,读取project管理配置信息,以及engine配置信息,并执行客户端下发的操作。启动工程之后,服务端会对业务进程进行扫描,并根据扫描统计结果以及淘汰策略,对页面进行分级淘汰,实现节省内存的目标。

      编译教程

      1. 下载etmem源码。
         # git clone https://gitee.com/src-openeuler/etmem.git
      
      1. 编译和运行依赖。

      etmem的编译和运行依赖于libboundscheck组件。

      安装命令:

         yum install libboundscheck
      

      通过rpm包进行确认是否安装:

         rpm -qa |grep libboundscheck
      
      1. 编译。
         # cd etmem
         # mkdir build
         # cd build
         # cmake ..
         # make
      

      使用说明

      启动etmemd进程

      使用方法

      通过运行etmemd二进制运行服务端进程,例如:

      # etmemd -l 0 -s etmemd_socket
      

      帮助信息

      options:
      -l|--log-level <log-level>  Log level
      -s|--socket <sockect name>  Socket name to listen to
      -h|--help  Show this message
      

      命令行参数说明

      参数参数含义是否必须是否有参数参数范围示例说明
      -l或--log-leveletmemd日志级别0~30:debug级别 1:info级别 2:warning级别 3:error级别 只有大于等于配置的级别才会打印到/var/log/message文件中
      -s或--socketetmemd监听的名称,用于与客户端交互107个字符之内的字符串指定服务端监听的名称
      -h或--help帮助信息NA执行时带有此参数会打印后退出

      etmem配置文件

      在运行etmem进程之前,需要管理员预先规划哪些进程需要做内存扩展,将进程信息配置到etmem配置文件中,并配置内存扫描的周期、扫描次数、内存冷热阈值等信息。

      配置文件的示例文件在源码包中,放置在源码根目录的conf/example_conf.yaml,建议在使用时放置在/etc/etmem/目录下,示例内容为:

      options:    
      	loop : 3
          interval : 1
          sleep: 2
      	policies:
      		type : pid/name
         		value : 123456/mysql
          	max_threads: 3
          	engine : slide
      			param:
      				T: 3
      

      配置文件各字段说明:

      置项配置项含义是否必须是否有参数参数范围示例说明
      optionsproject公用配置段起始标识NA每个配置文件有且仅有一个此字段,并且文件以此字段开始
      loop内存扫描的循环次数1~120loop:3 //扫描3次
      interval每次内存扫描的时间间隔1~1200interval:5 //每次扫描之间间隔5s
      sleep每个内存扫描+操作的大周期之间时间间隔1~1200sleep:10 //每次大周期之间间隔10s
      policiesproject中各task任务配置段起始标识NA一个project中可以配置多个task,每个task以policies:开头
      type目标进程识别的方式pid/namepid代表通过进程号识别,name代表通过进程名称识别
      value目标进程识别的具体字段实际的进程号/进程名称与type字段配合使用,指定目标进程的进程号或进程名称,由使用者保证配置的正确及唯一性
      max_threadsetmemd内部线程池最大线程数,每个线程处理一个进程/子进程的内存扫描+操作任务1~2 * core数 + 1,默认为1对外部无表象,控制etmemd服务端内部处理线程个数,当目标进程有多个子进程时,配置越大,并发执行的个数也多,但占用资源也越多
      engine扫描引擎类型slide声明使用slide引擎进行冷热内存识别
      param扫描引擎私有参数配置起始标识NA引擎私有参数配置段以此标识起始,每个task对应一种引擎,每个引擎对应一个param及其字段
      Tslide引擎的水线配置1~3 * loop水线阈值,大于等于此值的内存会被识别为热内存,反之为冷内存

      etmem工程创建、删除、查询

      场景描述

      1)管理员创建etmem工程(一个工程可包含多个etmem任务)

      2)管理员查询已有的etmem工程

      3)管理员删除已有的etmem工程(删除工程前,会自动先停止该工程中的所有任务)

      使用方法

      通过etmem二进制执行工程创建/删除/查询操作,前提是服务端已经成功运行,并且配置文件(e.g. /etc/etmem/example_conf.yaml)内容正确。

      添加工程:

      # etmem project add -n test -f /etc/etmem/example_conf.yaml -s etmemd_socket
      

      删除工程:

      # etmem project del -n test -s etmemd_socket
      

      查询工程:

      # etmem project show -s etmemd_socket
      

      打印帮助:

      # etmem project help
      

      帮助信息

      Usage:
       etmem project add [options]
       etmem project del [options]
       etmem project show
       etmem project help
      
       Options:
       -f|--file <conf_file> Add configuration file
       -n|--name <proj_name> Add project name
       -s|--sock <sock_name> Socket name to connect
      
       Notes:
       1. Project name and socket name must be given when execute add or del option.
       2. Configuration file must be given when execute add option.
       3. Socket name must be given when execute show option.
      

      命令行参数说明

      add命令:

      参数参数含义是否必须是否有参数示例说明
      -n或--name指定project名称project名称,与配置文件一一对应
      -f或--file指定project的配置文件需要指定路径名称
      -s或--socket与etmemd服务端通信的socket名称,需要与etmemd启动时指定的保持一致必须配置,在有多个etmemd时,由管理员选择与哪个etmemd通信

      del命令:

      参数参数含义是否必须是否有参数示例说明
      -n或--name指定project名称project名称,与配置文件一一对应
      -s或--socket与etmemd服务端通信的socket名称,需要与etmemd启动时指定的保持一致必须配置,在有多个etmemd时,由管理员选择与哪个etmemd通信

      show命令:

      参数参数含义是否必须是否有参数示例说明
      -s或--socket与etmemd服务端通信的socket名称,需要与etmemd启动时指定的保持一致必须配置,在有多个etmemd时,由管理员选择与哪个etmemd通信

      etmem任务启动、停止

      场景描述

      在已经通过etmem project add添加工程之后,在还未调用etmem project del删除工程之前,可以对etmem的工程进行启动和停止。

      1)管理员启动已添加的工程

      2)管理员停止已启动的工程

      在管理员调用project del删除工程时,如果工程已经启动,则会自动停止。

      使用方法

      通过etmem二进制执行任务启动/停止操作,前提是服务端已经成功运行,配置文件(e.g. /etc/etmem/example_conf.yaml)内容正确,且etmem工程已经创建。

      启动工程

      # etmem migrate start -n test -s etmemd_socket
      

      停止工程

      # etmem migrate stop -n test -s etmemd_socket
      

      打印帮助

      # etmem migrate help
      

      帮助信息

      Usage:
       etmem migrate start [options]
       etmem migrate stop [options]
       etmem migrate help
      
       Options:
       -n|--name <proj_name> Add project name
       -s|--sock <sock_name> Socket name to connect
      
       Notes:
       Project name and socket name must be given when execute start or stop option.
      

      命令行参数说明

      参数参数含义是否必须是否有参数示例说明
      -n或--name指定project名称project名称,与配置文件一一对应
      -s或--socket与etmemd服务端通信的socket名称,需要与etmemd启动时指定的保持一致必须配置,在有多个etmemd时,由管理员选择与哪个etmemd通信

      文档捉虫

      “有虫”文档片段

      问题描述

      提交类型 issue

      有点复杂...

      找人问问吧。

      PR

      小问题,全程线上修改...

      一键搞定!

      问题类型
      规范和低错类

      ● 错别字或拼写错误;标点符号使用错误;

      ● 链接错误、空单元格、格式错误;

      ● 英文中包含中文字符;

      ● 界面和描述不一致,但不影响操作;

      ● 表述不通顺,但不影响理解;

      ● 版本号不匹配:如软件包名称、界面版本号;

      易用性

      ● 关键步骤错误或缺失,无法指导用户完成任务;

      ● 缺少必要的前提条件、注意事项等;

      ● 图形、表格、文字等晦涩难懂;

      ● 逻辑不清晰,该分类、分项、分步骤的没有给出;

      正确性

      ● 技术原理、功能、规格等描述和软件不一致,存在错误;

      ● 原理图、架构图等存在错误;

      ● 命令、命令参数等错误;

      ● 代码片段错误;

      ● 命令无法完成对应功能;

      ● 界面错误,无法指导操作;

      风险提示

      ● 对重要数据或系统存在风险的操作,缺少安全提示;

      内容合规

      ● 违反法律法规,涉及政治、领土主权等敏感词;

      ● 内容侵权;

      您对文档的总体满意度

      非常不满意
      非常满意
      提交
      根据您的反馈,会自动生成issue模板。您只需点击按钮,创建issue即可。
      文档捉虫
      编组 3备份