HPC ACM客户端
hpc-acm-cli的Python项目详细描述
#hpc pack acm cli
hpc pack acm诊断工具是一组用于诊断hpc集群的命令行工具。它们基于[hpc-pack-acm-api]（https://github.com/azure/hpcpack-acm-api-python" rel="nofollow">https://github.com/azure/hpcpack-acm-api-python）在python包中分发。
##先决条件
需要python 2.7、3.5或3.6。
##安装
有几种安装方法。通常，你应该使用pypi。其他方式主要用于软件包开发。
###从pypi安装
这是安装python包的标准方法。
TT> python-mpip install--用户hpc acm cli
注意：python对于python2或python3对于python2或python3对于某些linux发行版。
###从Github安装
您可以通过
TT> python-mpip install--用户git+https://github.com/azure/hpcpack acm cli.git egg=hpc acm cli
###从源安装
将源代码调到本地，然后执行
TT> python-mpip install--用户-e<；到源目录的路径
注意：-e选项为软件包启用"可编辑"模式，以便在不重新安装的情况下对源代码所做的任何更改都将生效。
##用法
安装后，有3个命令可用：clusnode，clusdiag和clusrun分别用于检查群集节点、检查/执行诊断作业和检查/运行常规命令。它们都有子命令，例如list，shownew等。
###Windows上的Python注释
如果您使用的是[python release for windows]（https://www.python.org/downloads/windows/），请确保python安装的脚本目录的路径位于路径上，因为上面的命令安装在这个目录中。
以Python3.6为例。默认情况下，它将安装到c:users<；username>；appdatalocalprogramspython36。因此，您需要将c:users<；username>；appdatalocalprogramspython36scripts添加到路径
###常见用法
- 使用-h参数执行命令以列出其子命令，如clusnode-h
- 要获得子命令的帮助，请说list，将其显示为clusnode list-h
- 所有这些命令都需要一些公共参数。它们是主机、用户和密码。您可以将它们的值保存在配置文件中，从而避免在每次运行命令时输入它们。有关更多信息，请参见下面的配置部分。
- 下面的示例假设您在配置文件中提供了所需的参数。您可以在命令行上提供它们。但是如果它们丢失了，在运行时会遇到一个错误。
###俱乐部
clusnode用于检查群集节点。
例如，要列出群集中的节点，请执行
TT> 俱乐部名单
默认情况下，它将一次列出100个节点。如果您更喜欢，请使用–count参数，如
TT> clusnode list--计数1000
还有一个参数–last id用于分页。有关详细信息，请参阅命令帮助。
检查特定节点
TT> clusnode显示<；节点名称>；
###clusdiag
clusdiag用于检查/执行群集上的诊断测试。
例如，列出可用的诊断测试
TT> clusdiag测试
运行诊断测试
TT> clusdiag new<；test name>；--模式<；您的节点名称模式
–模式是一个glob模式，就像大多数操作系统上的文件名globbing一样。例如，abc*匹配以abc开头的名称，因此abc，abc1和abc2都匹配。您可以使用*匹配所有节点。
您还可以通过–nodes参数指定要运行测试的几个节点，如
TT> clusdiag new节点
指定名为n1、n2和n3的节点，这些节点由一个空格表示，并在一对"中赋值。
查看诊断测试列表
TT> clusdiag列表
检查测试的详细结果
TT> clusdiag show<；id>；
###俱乐部
clusrun用于检查/运行群集上的常规命令。
例如，要在集群的所有节点上运行命令：
TT> clusrun new"主机名和日期"
它将在群集中的所有节点上执行主机名和日期。
##配置
以上命令共享一个公共配置文件.hpc\u acm\u cli\u config，作为命令行的默认值。
文件将在您第一次运行任何命令时生成。它将放在用户的主目录下（~）。一般来说，Linux是/home/{username}，Windows是c:users{username}。
配置文件为命令参数设置默认值，默认值可以由命令行上提供的值覆盖。有关可配置选项和示例，请参见文件中的注释。
欢迎加入QQ群-->： 979659372
