安装工具箱

您可以通过 npm 或 IBM® API Connect 云中的管理服务器来安装工具箱。

开始之前

工具箱的功能包括使用 DataPower® Gateway Docker 容器本地测试 API 的缺省能力。如果系统上存在 Docker 和 Docker Compose 且正常运行，那么可从 Docker Hub 下载 DataPower 映像。有关更多信息，请参阅：使用 IBM DataPower Gateway 测试 API。

以下步骤创建一个软件环境，此环境已准备好安装 IBM API Connect 工具箱。

注：在 Windows 上，以管理员身份使用 Windows 命令 shell 输入 Node 或 npm 命令，而不使用 Powershell 或 Cygwin（Windows bash shell 仿真器）。

安装以下一个受支持的 Node.js 版本：
- IBM SDK for Node.js。
- 社区 Node.js 分发版 V4.x 或 V6.x（推荐）。
- 对于 IBM API Connect Professional 和 Enterprise 版本，安装 IBM API Connect Create v5.0.1 for Node.js（包括 IBM SDK for Node.js）。
有关受支持的 Node.js 版本的详细信息，请参阅详细系统需求，然后单击先决条件选项卡。
确保 node 位于您的 PATH 中。
通过输入以下命令来更新 npm：
```
npm install -g npm
```
使用 npm -v 命令检查 npm 的版本并确保其大于 3.x.x。

关于此任务

您可以通过使用作为 Node.js 的一部分安装的 npm 命令来安装工具箱。安装工具箱会安装：

API Connect 命令行工具 apic。
API Connect API Designer 可视化工具。
API Connect Micro Gateway.

您还可以卸载工具箱，并可以显示当前安装的工具箱的版本号。

为获取最佳结果，安装对应于 API Connect 管理服务器版本的工具箱版本。要查找相应的工具箱版本，请使用 npm dist-tag ls apiconnect 命令。例如：

$ npm dist-tag ls apiconnect
1.0.3.0: 1.0.3
apic-v5.0.1.0: 2.0.18
apic-v5.0.2.1: 2.1.19
apic-v5.0.3.0-iFix1: 2.2.12
apic-v5.0.3.0-iFix2: 2.2.14
apic-v5.0.3.0-iFix4: 2.2.17
apic-v5.0.3.0: 2.2.9
apic-v5.0.4.0-iFix2: 2.3.10
apic-v5.0.4.0: 2.3.6
apic-v5.0.5.0: 2.4.11
apic-v5.0.6.0: 2.5.8
apic-v5.0.6.1: 2.5.17
apic-v5.0.6.2: 2.5.21
apic-v5.0.6.3: 2.5.33
apic-v5.0.7.0: 2.6.2
apic-v5.0.7.1: 2.6.55
apic-v5.0.7.2: 2.6.71
latest: 2.6.71

然后，要安装特定版本的工具箱，请使用命令 npm install apiconnect@<version>。例如，如果您具有 API Connect V5.0.6.3，那么使用以下命令：

npm install apiconnect@2.5.33

过程

注：请勿使用 npm 配置设置 engine-strict（或使用 --engine-strict 选项），因为它将阻止安装完成。

安装期间，您可能会看到 node-gyp 模块的错误，但由于这些错误源于可选依赖关系，安装过程应成功完成。

您可能还会看到 npm 警告 Possible EventEmitter memory leak detected，但这些为虚假的警告，不指示内存泄漏或任何其他问题。

要安装工具箱，请完成以下步骤：

如果未在使用可信证书，请输入以下命令：
```
npm config -g set strict-ssl false
```
如果使用的是代理服务器，请输入以下命令：
```
npm config set proxy http://proxy_address:port
npm config set https-proxy http://proxy_address:port
```
其中 proxy_address 是代理服务器的主机名或 IP 地址，port 是端口号。
您将以全局方式安装工具箱(-g)，因为它包含了命令行界面。您可以使用 npm config get prefix -g 来了解全局安装目录的位置。确保您在安装时具有足够的许可权来写入系统文件。通过以下任一方式安装工具箱：
- 要从 npm 安装工具箱，请输入以下命令：
```
npm install -g apiconnect
```
- 要从 IBM API Connect 云中的管理服务器安装工具箱，请输入以下命令：
```
npm install -g --unsafe-perm https://appliance/packages/apiconnect
```
  其中 appliance 是管理服务器设备的主机名或 IP 地址。
要显示当前安装的工具箱的版本号，请输入以下命令：
```
apic -v
```

卸载工具箱

开始之前

在卸载工具箱之前，通过输入以下命令停止正在本地运行的任何应用程序：

apic stop --all

注：工具箱的配置设置存储在 home_dir\.apiconnect 目录中，其中 home_dir 是安装工具箱的用户帐户的主目录。在卸载时，您可选择保留或删除配置设置。缺省行为是删除 home_dir\.apiconnect 目录。使用 --no-config-clear 命令可保留配置设置。

过程

使用 npm 进行卸载：
```
npm uninstall -g apiconnect
```
缺省情况下，此命令除去工具箱配置设置，如上所述。要保留工具箱配置设置，请改为输入以下命令：
```
npm uninstall -g apiconnect --no-config-clear
```
要卸载工具箱、清除 npm 高速缓存并除去工具箱配置，请改为输入以下命令：
```
npm cache clear
npm uninstall -g apiconnect
```
要卸载工具箱、清除 npm 高速缓存并保留工具箱配置，请改为输入以下命令：
```
npm cache clear
npm uninstall -g apiconnect --no-config-clear
```
在 Windows 上，删除 C:\Users\username\AppData\Local\Temp 中名称以 npm- 开头的所有文件

更新工具箱安装

开始之前

在更新工具箱安装之前，请通过输入以下命令确保停止正在本地运行的任何应用程序：

apic stop --all

过程

按卸载工具箱中所述，卸载工具箱。
输入以下命令来重新安装工具箱：
```
npm install -g apiconnect
```

上次更新时间：2017-10-24