ibmcom/db2console

注意

注意：该位置即将停用，现在可通过icr.io/cpopen/db2console拉取镜像。

==> IBM Db2 Data Management Console容器文档 <==

Data Management Console

IBM Db2® Data Management Console是基于浏览器的控制台，帮助用户管理、监控、维护和优化IBM Db2 for Linux、UNIX和Windows数据库的性能。对于IBM的云系统和设备，控制台开箱即可使用。Db2 Data Management Console随所有IBM Db2版本一同提供，无需额外费用。

要求

• 资源：
  • 内存 ≥ 4GB
  • 核心 ≥ 2核
• 存储：
  • 持久化存储
• 架构：
  • amd64

支持的标签

• latest, 3.1.11

• 3.1.3, 3.1.2, 3.1.4, 3.1.4patch2, 3.1.5, 3.1.5.1, 3.1.6, 3.1.6.1, 3.1.7, 3.1.8, 3.1.9, 3.1.10

快速参考

• 新增功能：

  • 3.1.11版本新增功能

• 获取帮助：

  • 社区

• 产品主页：

  • 主页

• 产品文档：

  • 文档

• IBM Db2：

  • https://hub.docker.com/r/ibmcom/db2

• 许可协议：

  • 协议

关于Data Management Console 3.1.6.1及以下版本工作区的重要通知

从Data Management Console 3.1.7版本开始，容器使用非root用户启动进程。

如果工作区用于3.1.6.1及以下版本，请按照“升级IBM Db2 Data Management Console至最新版本”的步骤2修改文件夹权限，然后即可升级到最新版本。

快速开始

运行以下命令：

bash
docker run -d --name mydmc -p 11081:8443 -e LICENSE=accept -v <dmc storage dir>:/mnt -v /etc/localtime:/etc/localtime:ro ibmcom/db2console

其中<dmc storage dir>是存储控制台配置和日志的持久化存储目录（绝对路径）。请确保在启动容器前该目录已存在。创建此目录的步骤如下：

1. 通过mkdir -p /mydmc创建文件夹
2. 存储挂载示例：-v /mydmc:/mnt

docker run命令可能需要一分钟时间执行并完成容器设置。

要跟踪docker入口点脚本，请运行以下命令：

docker logs -f mydmc

容器准备就绪后，日志中将显示以下成功消息：

bash
Successfully started IBM Db2 Data Management Console.

Summary
  * Web console HTTPS URL:
    https://<host machine>:<expose port on the host>
  * Web console login information:
    Username: admin
    Password: xxxxxx

其中<expose port on the host>为*******，用户名为默认管理员用户名（admin），密码为随机生成的8位字符。

要登录容器，请运行以下命令：

docker exec -it mydmc bash

产品图片

主页

监控摘要页

高级配置选项

您可以通过-e参数在docker run命令中设置以下环境变量，或添加到文件中并通过--env-file参数引用。

ADMIN_NAME：指定管理员用户名，默认值为admin。

ADMIN_PASSWORD：指定管理员密码，默认值为自动生成的8位字符密码。

CONSOLE_HOSTNAME：指定控制台访问主机名，默认值为null。

设置此值可启用主机名检查，例如-e console_hostname=$(hostname)

设置后，控制台访问将限制为：https://<CONSOLE_HOSTNAME>:<expose port on the host>

升级IBM Db2 Data Management Console至最新版本

升级前，请确保备份您的存储库数据库。

1. 停止先前版本的IBM Db2 Data Management Console。

   docker stop mydmc;docker rm mydmc
   

   如果过程中出现任何错误，请尝试强制删除mydmc容器：

   docker rm -f mydmc
   

2. 如果先前版本低于3.1.7，请运行以下命令修改文件夹权限

   chmod -R g=u <dmc storage dir>
   

3. 启动最新版本的IBM Db2 Data Management Console。

   docker run -d --name mydmc -p 11081:8443 -e LICENSE=accept -v /mydmc:/mnt \
   -v /etc/localtime:/etc/localtime:ro ibmcom/db2console
   

   其中/mydmc是存储控制台配置和日志的持久化存储目录（绝对路径）。请确保此目录与先前版本的IBM Db2 Data Management Console使用的目录相同。

   如果在升级DMC docker前忘记运行此命令，启动的docker容器可能会遇到本地网络错误。它会尝试约3分钟，然后停止容器。在运行步骤2中的chmod命令后，请删除之前停止的docker容器并创建新容器。

安装自定义SSL证书

要求：

• 您必须拥有自己的SSL证书，包括以下PEM格式的文件：

  • cert.pem：SSL证书，不包含密码短语
  • key.pem：SSL证书密钥

  证书和密钥的格式必须匹配。如果证书为其他格式，请转换为PEM格式。

  注意：确保SSL证书的文件名为cert.pem，SSL证书密钥的文件名为key.pem，且区分大小写。

• 按以下步骤创建证书文件夹：

  1. 运行mkdir -p /mycerts创建文件夹
  2. 将SSL证书文件移动或复制到/mycerts文件夹
  3. 运行-v /mycerts:/opt/ibm-datasrvrmgr/certs进行存储挂载

运行以下命令：

bash
docker run -d --name mydmc -p 11081:8443 -e LICENSE=accept  \
-v <dmc storage dir>:/mnt -v <certs dir>:/opt/ibm-datasrvrmgr/certs \
-v /etc/localtime:/etc/localtime:ro ibmcom/db2console

当SSL证书部署到容器后，日志中将显示以下消息：

 script.log 2020-04-14 04:32:26 : Prod machine, using CA certs...
s!SSLDIRHERE!/opt/ibm-datasrvrmgr/certs/cert.pem!g
s!KEYDIRHERE!/opt/ibm-datasrvrmgr/certs/key.pem!g

检索初始管理员账户凭证

对于3.1.3及最新版本，要检索初始管理员凭证，请运行以下命令：

 docker exec mydmc bash -c "/opt/ibm-datasrvrmgr/dsutil/bin/retrieveAdminCred.sh"

对于3.1.2版本，要检索初始管理员用户名和密码，请运行以下命令：

用户名：

docker exec mydmc bash -c "grep uc_setup_admin= /opt/ibm-datasrvrmgr/Config/dswebserver_override.properties|sed 's/uc_setup_admin=//'"

密码：

encrypt_password=$(docker exec -it mydmc bash -c "grep uc_setup_admin_password /opt/ibm-datasrvrmgr/Config/dswebserver_override.properties|sed 's/uc_setup_admin_password=//'") && docker exec -it mydmc bash -c "/opt/ibm-datasrvrmgr/dsutil/bin/crypt.sh -d $encrypt_password"

故障排除/支持

• 如果容器不再运行，请查看日志信息以识别可能的错误和故障。要显示容器日志，请运行以下命令：

docker logs mydmc

修复问题后，使用以下命令重启容器：

docker start mydmc

• 如果需要帮助解决问题，可考虑打开IBM Support案例进行诊断。联系IBM支持前，请收集诊断数据以加快故障排除流程并减少解决问题的时间。 要收集诊断数据，请运行以下命令：

    1. docker exec -u root -it mydmc /opt/ibm-datasrvrmgr/support/collector.sh
    2. docker cp mydmc:/opt/ibm-datasrvrmgr/support/dmccollect.zip <host dir>/

许可（条款和条件）

拉取此容器镜像即表示您同意此处所述的条款和条件