ibmcom/spectrum-symphony

IBM Spectrum Symphony Community Edition

IBM Spectrum Symphony是企业级网格管理器，用于可扩展共享网格上的计算和数据密集型工作负载。它为数十个分布式并行应用提供高效计算环境，以实现更快的结果和更好的资源利用率。

本Docker镜像是IBM Spectrum Symphony的免费客户管理版，即IBM Spectrum Symphony Community Edition。通过此社区版，您可以将IBM Spectrum Symphony快速配置并部署为Docker容器应用，支持最多64核的集群。

支持的标签

• 7.3.2.0
• 7.3.1.0

新特性

• 镜像设计为与IBM Spectrum Symphony OpenShift Operator配合使用
• IBM Spectrum Symphony集群现在以简化工作负载执行模式安装，系统进程仅以内置集群管理员用户（'egoadmin'）身份运行。有关简化模式的详细信息，请参见工作负载执行模式。
• 对于'egoadmin'用户，之前硬编码的默认密码（'Admin'）现已禁用。此次更新后，'egoadmin'密码随机生成且未知。GENERATE_PASSWORD环境变量也随之过时。
• 要通过SSH访问客户端主机，现在必须在安装期间通过设置新的SSH_PUBLIC_KEY参数提供公钥。
• 现在可以通过在安装期间设置新的SHARED_TOP_SUBDIR参数，在共享卷挂载上为每个集群创建子目录。此更新允许单个卷在单个Pod中重复使用。
• 关键系统服务现在以内置集群管理员身份运行，而非root。此次更新后，访问客户端主机需要集群管理员凭据（用户名'egoadmin'，默认密码'Admin'）。您也可以选择为'egoadmin'用户启用在集群启动时生成随机密码，并通过指定安装期间的GENERATE_PASSWORD环境变量将其打印到容器日志。
• 默认启用Apache Derby演示数据库来存储报告数据。报告使您能够分析和提高集群性能并进行容量规划。虽然生产集群中的报告需要商业数据库，但derbydb数据库提供了即用型测试选项。
• 组件日志可以通过在安装期间指定LOGS_TO_SHARED环境变量保存到挂载的共享目录。此更新使跨多个工作节点的容器能够共享日志。

安装IBM Spectrum Symphony Community Edition

安装选项

通过以下环境变量自定义IBM Spectrum Symphony Community Edition的安装：

部署的IBM Spectrum Symphony应用由多个微服务组成，通过这些微服务可以访问IBM Spectrum Symphony集群并提交工作负载。可以使用-p选项更改以下关键服务公开的默认端口：

• 在管理容器上，WEBGUI服务默认在8443端口承载集群管理控制台。
• 在管理容器上，REST服务默认在8543端口承载资源管理REST API。
• 在管理容器上，SYMREST服务默认在8050端口承载来自IBM Spectrum Symphony客户端的工作负载提交REST API。
• 在客户端容器上，SSHD服务默认在2222端口允许访问IBM Spectrum Symphony客户端主机。

安装前准备

IBM Spectrum Symphony Docker容器进程以内置用户'egoadmin'（ID 1000）运行。确保为挂载卷设置用户ID 1000所需的权限。

安装

按照以下步骤使用IBM Spectrum Symphony Community Edition构建集群（注意以下命令仅为演示示例，需根据需要修改）：

注意： 要在Docker容器中运行IBM Spectrum Symphony，必须定义环境变量LICENSE=accept以接受许可条款和条件。

1. 为集群创建单独的Docker网络：

   docker network create symnet

   确保禁用userland-proxy参数（docker daemon --userland-proxy=false）。有关更多信息，请参见Docker网络文档。

2. 为高可用性，创建共享目录存储集群配置文件：

   mkdir -p /data/cluster1

   如果创建多个集群，确保每个集群有自己的共享目录。

3. 启动一个（或多个）管理主机并公开所需的服务端口：

   docker run --privileged --rm -d --network symnet -v /data/cluster1:/shared -p 8443 -p 8543 -p 8050 -e LICENSE=accept ibmcom/spectrum-symphony

4. 启动一个（或多个）计算主机：

   docker run --privileged --rm -d --network symnet -v /data/cluster1:/shared -e LICENSE=accept -e HOST_ROLE=COMPUTE ibmcom/spectrum-symphony

5. （可选）启动带有SSH访问的客户端主机：

   docker run --privileged --rm -d --network symnet -v /data/cluster1:/shared -p 2222 -e LICENSE=accept -e HOST_ROLE=CLIENT -e SSH_PUBLIC_KEY="$(cat ~/.ssh/id_rsa.pub)" ibmcom/spectrum-symphony

访问IBM Spectrum Symphony

应用部署后，可以通过以下方式访问IBM Spectrum Symphony集群（有关访问7.2.0.2集群的信息，请参见IBM知识中心）：

• 在管理容器上，通过支持的浏览器访问集群管理控制台，地址为https://<主机>:<端口>/platform。出现登录页面时，使用默认凭据首次登录集群管理控制台（用户名Admin，密码Admin）。登录后，即可开始探索和使用IBM Spectrum Symphony。有关详细信息，请参见IBM知识中心的集群管理控制台主题。

• 在管理容器上，访问资源管理REST API，地址为https://<主机>:<端口>/platform/rest/ego/v1/。有关详细信息，请参见EGO RESTful API参考。

• 在管理容器上，访问客户端工作负载提交SYMREST服务，基础URL为https://<主机>:<端口>/platform/rest/symrest/。使用任何REST API客户端（例如cURL或基于浏览器的插件）在https://<主机>:<端口>/platform/rest/symrest/v1/auth/login提交身份验证API调用。身份验证后，在https://<主机>:<端口>/platform/rest/symrest/v1/clientapi提交API调用以提交和检索工作负载。有关详细信息，请参见客户端工作负载提交RESTful API参考。

• 在客户端容器（环境变量HOST_ROLE=CLIENT）上，使用任何SSH客户端程序以集群管理员身份访问IBM Spectrum Symphony客户端主机，命令为ssh egoadmin@<主机> -p <端口>。

  • 如果使用7.2.1.1镜像，客户端主机身份验证使用SSH公钥（在安装期间通过SSH_PUBLIC_KEY变量设置）。
  • 如果使用7.2.1.0镜像，提示输入密码时，使用默认密码'Admin'。如果选择为集群管理员生成密码，请在容器日志中查找'egoadmin'密码。

注意：为确保生产环境安全，强烈建议首次登录后更改集群管理控制台默认密码：

1. 在集群管理控制台标题栏中，从Admin下拉列表中单击Log Out。

2. 在登录页面上，单击Change password链接。

3. 输入Admin用户的默认凭据；然后输入并确认新密码。

4. 单击Apply。

5. 通过SSH访问客户端容器，并从命令行界面关闭集群（参见命令行界面主题）：

   soamcontrol app disable all

   egosh service stop all

   egosh ego shutdown all

6. 再次启动集群：

   egosh ego start all

   soamcontrol app enable <appName>

7. 使用新密码重新登录集群管理控制台。

其他资源

IBM Developer社区

IBM知识中心

许可证

以下程序除了客户端与IBM先前同意的程序许可条款外，还根据以下许可信息条款和条件获得许可。如果客户端尚未同意程序的有效许可条款，则适用《非担保程序国际许可协议》（Z125-5589-05）。使用本程序前请查看许可证。使用本程序即表示您同意这些条款。

程序名称（程序编号）：IBM Spectrum Symphony Community Edition，7.2.1（Community）

有关单独许可代码和完整许可条款的详细信息，请单击此处。