配置引导节点以安装 Omnissa Access

引导节点充当部署控制器。可从此引导节点运行所有部署命令。请执行以下任务。

创建工作目录

过程：

• 运行以下命令以创建工作目录。

  占位符 <cluster_name> 代表您选择的目录名称，例如 access-cluster。您可以使用下面的 mkdir 命令创建此目录，并在本指南其余部分的命令和文件路径中重用同一名称。这与 cp-cluster 不同，稍后您会看到该名称作为控制平面集群本身的固定名称，例如，在 profile.yml 和 cp-cluster.ini 中。您无法创建或选择该名称：

  ssh configuser@<bootstrap-ip>
  sudo su
  mkdir -p /opt/wss/<cluster_name>/assets
  cd /opt/wss/<cluster_name>
  

  文件夹结构必须如下所示：

  • /opt/wss/<cluster_name>
  • /opt/wss/<cluster_name>/assets

  资产包必须始终放置在资产文件夹中。

下载资产包并将其复制到引导虚拟机

过程：

1. 从共享位置下载资产包 xxxxxx.zip，然后使用任何 FTP 工具或 Linux 实用程序 (scp) 将其复制到引导虚拟机：

   # Copy the asset to the following location:
   /opt/wss/<cluster_name>/assets/xxxxxx.zip
   

2. 解压缩该包。该过程可能需要大约 5 分钟才能完成。

   # Navigate to assets directory to unzip
   cd /opt/wss/<cluster_name>/assets
   unzip xxxxxx.zip
   
   # OUTPUT
   Archive: xxxxxx.zip
       inflating: control-plane-manifest.json
       creating: cli-distribution/
       creating: cli-distribution/linux/
       inflating: cli-distribution/linux/wso
       inflating: control-plane-images.tar.gz
       inflating: offline-hydrater.tar.gz
   

安装 WSO CLI

过程：

• 按照以下内嵌说明，安装 WSO CLI（Workspace ONE 命令行界面）并验证该安装：

  # Add WSO CLI to PATH
  cp cli-distribution/linux/wso /usr/bin/
  
  ## Verify WSO CLI is installed successfully
  wso version
  
  # OUTPUT
  Workspace ONE CLI 
  Platform: linux/amd64 
  Version: 26.07.0.0-2026.07.13-528-eb05a4e  
  Build time: Mon Jul 13 10:26:53 UTC 2026
  CP  Image Version: 0.5.0-2026.07.10-829-05c0b8a 
  CPS Image Version: 0.1.2-2026.07.13.0-e4b30287895ad3339b27adf97e2273a082a4a033
  

配置资产

过程：

1. 阅读并接受 EULA。例如：

       # After you run the following command, read the EULA and enter Y to accept or N to decline when prompted.
       wso eula
   
       # OUTPUT
      <timestamp> Review the eula at https://www.omnissa.com/general-terms/
       Do you agree to these terms ? [y/n]: y
       <timestamp> EULA accepted
   

2. 加载映像。例如：

   wso configure /opt/wss/<cluster_name>/assets/
   
   # OUTPUT
   <timestamp> Version control is enabled but no current version details file found. First time configure skipping version check.
   <timestamp> Copying files to cli home directory /opt/wss/.wso-cli
   <timestamp> Loading Workspace ONE components
   

   **注意：**建议您从 /opt/wss/<cluster_name>/ 目录运行所有 WSO 命令。如果从其他目录运行命令，可能会收到以下错误：

   The cluster work directory does not seem to be initialized. Please run init command on the directory.

3. 验证映像。例如：

   docker images
   
   # OUTPUT
   REPOSITORY                                                            TAG                                                           IMAGE ID       CREATED       SIZE
   docker-local-xxxxxx-builds/control-plane                              0.5.0-2026.01.23-446-ee28f9f                                  013df7d6281d   10 days ago   1.69GB
   docker-local-ws1access/access-onprem/control-plane-services   0.1.2-2026.01.22.0-117d3c12b269ddfc25aef69eec8bafbe5fd73bb6   7ea2678a6f81   10 days ago   511MB