在 Linux 上安装 Jupyter Notebook Server

可以将 IBM® Cognos® Analytics for Jupyter Notebook Server 安装在同一台计算机上，也可以安装在安装了 Cognos Analytics 的另一台计算机上。

Jupyter Notebook Server 支持 Linux 和 Windows 10 平台，并且需要安装 Docker 。

注: 此时支持 Docker CE (Community Edition) ， Docker Engine和 Docker Desktop (CE)。

下载并运行安装程序脚本时，将装入并启动 Docker 容器。 这些容器允许 Cognos Analytics 用户创建和编辑 Jupyter Notebook。 缺省情况下， Cognos Analytics for Jupyter Server 配置了许多最常见的数据科学/分析 Python 包。

提示: 稍后可以 升级现有安装中的 Python 软件包 。

开始之前

在安装 Jupyter Notebook Server 之前，请执行以下步骤:

  1. 将 Docker 或 Podman (在 RHEL 8 或 RHEL 9 上) 安装为 Jupyter Notebook的容器引擎。
    要安装 Docker:
    遵循下列其中一个 Linux 发行版的过程:

    必须将您添加到 Docker 组，任何 Docker 命令才能在没有 root 用户特权的情况下运行。

    在 RHEL8 或 RHEL9: 上安装 Podman
    遵循 Podman上的安装和配置步骤。
    注: 在整个 Podman 文档中，您将看到 Podman 命令，这些命令对应于 Docker 命令可用的特定主题。
    Podman的最大优点之一是其与 Docker的完整 CLI 兼容性。 构建 Podman时， Docker 用户可以在不进行任何重大更改的情况下进行调整。 例如，可以使用 alias 命令为 Podman创建 Docker 别名:
    yum install podman-docker
    重要信息: 要在 Jupyter Server 中启用高级联网功能，还必须安装软件包 podman-plugins。 输入以下内容:
    yum install -y podman-plugins
    有关 Podman的更多信息，请参阅此 Podman 开发者博客。
  2. 在 Cognos Configuration中设置标准域。
    1. 在 IBM Cognos Configuration的 " 资源管理器 " 窗口中，单击 环境。
    2. 在 外部应用程序的分派器 URI 下，设置 IBM Cognos Analytics 服务器的标准域名 (FQDN)。
    3. 在 网关 URI 下，设置 IBM Cognos Analytics 服务器的标准域名 (FQDN)。
    4. 单击 文件> 保存。
    5. 重新启动 Cognos Analytics 服务。

过程

  1. 从 Passport Advantage 下载 IBM Cognos Analytics for Jupyter Notebook 服务器安装程序和服务器存储库。
    提示：请参见Cognos Analytics 11.1.2 下载文档，了解要下载的部件号。 请注意，仅在 Linux eAssemblies中找到 Jupyter Server 安装程序和服务器存储库。
  2. 双击安装程序文件。
  3. 遵循安装向导中的指示将文件复制并安装到计算机。
    提示: 您可以在较低版本的 Jupyter Server 上进行安装。
    文件夹 jupyter_installation_location/dist 文件夹包含两个子文件夹:
    • dist/images
    • dist/scripts
      提示: 文件夹 dist/scripts/unix 包含您需要运行的所有脚本。

      脚本

      		 用途
      build.sh 运行此命令以重建映像。
      config.conf 编辑此配置文件以更改 Jupyter 参数。
      install.sh 运行此命令以装入并启动 Docker 容器。
      prune.sh 运行此命令以除去旧的 Docker 映像。
      start.sh 运行此命令以启动 Jupyter 服务器。
      stop.sh 运行此命令以停止 Jupyter 服务器。
      uninstall.sh 运行此命令以卸载 Jupyter 服务器。
  4. 确保您对每个脚本都具有执行许可权:

    类型 chmod -R u+x dist/scripts/unix

  5. 浏览至 dist/scripts/unix 目录。
  6. 类型 ./install.sh

    安装脚本将运行。

结果

将从 jupyter_installation_location/dist/images 目录装入所有 Jupyter Server Docker 映像，并启动 Docker 容器。

后续步骤

安装 IBM Cognos Analytics for Jupyter Notebook Server 后，可以执行以下任务:

卸载 Jupyter Notebook Server

要卸载 Jupyter Notebook Server ，请浏览到 dist/scripts/unix 目录，然后输入 ./uninstall.sh