# 常见问题

本文主要介绍使用 Armory 过程中可能遇到的常见问题及解决方法。

1. 在 Windows 7 系统上使用 PowerShell 执行 Armory 客户端命令时，出现Unrecognized token in source text.错误，如何正确执行 Armory 命令？

   在 Windows 7 系统上使用 PowerShell 终端中执行 Armory 客户端命令时，为避免因特殊字符导致的识别问题，请将参数值用单引号或双引号括起来，例如，可以使用 armory get "@cloudnative/armory-cli" 或 armory get '@cloudnative/armory-cli'来正确执行软件包下载命令。

2. 在 Git Bash 终端上执行 Armory 客户端命令时，出现Armory Error: RangeError: Invalid count value错误，该如何解决？

   由于 Git 默认使用的 MinTTY 终端环境不支持某些交互式终端程序（如 Python、Node.js 等），故在 Git Bash 中执行 Armory 交互式命令时可能会遇到错误，此时可通过如下两种方式解决此问题：

   • 启动 Git Bash 后，执行winpty bash命令，以执行 Armory 交互式命令。
   • 在安装 Git 时，勾选 Add a GitBash Profile to Windows Terminal 组件，将 Git Bash 添加到 Windows Terminal 中作为一个可选终端；或者设置终端类型为 Use Windows's default console window，直接在 Windows 默认控制台窗口（cmd.exe）中打开 Git 终端。建议选择前者，即添加 GitBash 到 Windows Terminal 中作为一个可选终端配置。

3. 当在 Jenkins 流水线中配置自动上传构建的软件制品至 Armory 时，构建失败，Stage Logs 显示Armory Error: Error: Terminal is not capable错误，该如何处理？

   当在 Jenkins 流水线中配置自动上传构建的软件制品至 Armory 时，可能会由于进度条功能与任务执行产生冲突而引起此错误。此时，需要禁用进度条功能，具体操作如下：
   在 Jenkins 流水线的 Pipeline 脚本中，在执行armory publish命令之前，添加armory config set disableProgressBar=true配置，将进度条功能禁用，从而避免干扰上传任务的执行。

4. 使用armory install命令在远程计算机上安装软件包时，若出现Someone's locking on, please try again later.错误，该如何处理？

   4. 使用 armory install 命令在远程计算机上安装软件包时，出现 Someone's locking on, please try again later. 错误，该如何处理？

   该问题在 Armory 2.0.0 版本中已优化，建议优先升级至最新版本。

   在低版本中，系统为防止多用户并发安装引发的安全问题，会在目标计算机上设置全局锁。安装完成后锁会自动释放，但若安装过程中发生异常（如设备断电、进程终止），或其他用户正在执行安装操作，就可能导致锁未释放，从而出现该错误。

   若您暂无法升级版本，可以手动删除远程计算机上的“/tmp/.amr/locks/apm.lock”文件夹，以释放锁并重新尝试安装。