升级 Anaconda Enterprise Notebooks (AEN 4.1.2)

总结

重要提示:这些说明仅用于将 Anaconda Enterprise Notebooks (AEN) 从 4.1.1 升级到当前版本 4.1.2。每个版本都必须从以前的版本迭代升级。不要跳过版本。

升级到以前版本的说明:

要从所列版本之前的版本升级,请联系您的企业支持代表寻求帮助。

注意:命名服务帐户功能仅适用于新安装的 Anaconda Enterprise Notebooks 4.0.0+。它不适用于升级安装。有关详细信息,请联系您的企业支持代表。

升级到 Anaconda Enterprise Notebooks Platform 需要单独升级三个服务类别的所有实例:

  • 服务器
  • AEN网关
  • AEN计算

Anaconda Enterprise Notebooks 的安装通常由在独立计算节点上运行的多个计算实例组成,如果有多个数据中心 与 AEN 相关联,则由多个网关组成。可以在概述中找到更多详细信息。

升级过程要求所有 AEN 服务实例停止、升级,然后重新启动。这些说明描述了如何执行此过程。

注意:任何调用root用户的命令也可以使用sudo.

如果您在此过程中遇到任何困难,请参阅 故障排除指南,其中提供了以下方面的指导:

  • 流程
  • 配置文件
  • 日志文件
  • 港口

如果您无法解决安装或升级问题,请联系您的企业支持代表。

飞行前检查

注意:在开始升级之前,对您的安装进行测试备份。升级到更高版本的 AEN 是不可逆的。升级过程中的任何错误都可能导致部分或全部数据丢失,并需要从备份中恢复数据。

重要提示:在开始升级过程之前,请终止所有 AEN 应用程序并停止所有项目。

在升级每台主机上的每个服务之前,请执行以下操作:

  1. 使用以下命令暂停每个节点上的服务:

    sudo  service  wakari -服务器 停止
    sudo  service  wakari -网关 停止
    sudo  service  wakari -计算 停止
    
  2. 设置 AEN 功能 ID (NFI) 和 AEN 功能组 (NFG),它们在安装说明中有所描述。

    NFI 是用于运行所有 AEN 服务的 AEN 服务帐户的用户名,也是 AEN 管理员帐户的用户名。

    NFG 是包含 AEN 服务帐户的 Linux 组,因此具有所有者 NFI 的所有文件和目录也具有组 NFG。

    升级 AEN 时,将 NFI 和 NFG 设置为当前安装的 NFI 和 NFG。

    默认 NFI 是“wakari”,可以使用“aen_admin”或任何其他名称代替。

    使用这些命令设置 NFI 和 NFG,如果您使用其他名称,请替换“wakari”:

    export  AEN_SRVC_ACCT = "wakari" 
    export  AEN_SRVC_GRP = "wakari"
    
  3. 安装wget

    yum 安装 wget
    

AEN 服务器

注意:如果您使用基于 LDAP 的身份验证,请备份配置文件:

/opt/wakari/wakari-server/etc/wakari/wk-server-config.json

在之后服务器已经升级,将该文件拷贝回相同的位置升级之前。

以下操作均在Server主机上完成:

  1. 停止 ElasticSearch 服务:

    须藤 服务 弹性搜索 停止
    
  2. 删除任何以前的索引:

    sudo  rm  - rf  / var / lib / elasticsearch /*
    

    注意:您可以选择保留旧索引,但如果您在升级后检测到任何搜索功能问题,您将需要执行以下步骤以开始使用干净的索引:

    执行sudo 服务 wakari -服务器 停止
    须藤 服务 elasticsearch 停止
    须藤 RM  -射频 /无功/ lib中/ elasticsearch / * 
    sudo的 服务 elasticsearch 开始
    须藤 服务 wakari -服务器 启动
    
  3. 升级服务器

    推/tmp
    wget http://j.mp/aen-server-update-4-1-2
    
    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \
                     -p /opt/wakari/wakari-server \
                     --file aen-server-update-4-1-2
    
    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \
                     -p /opt/wakari/wakari-server \
                     --no-deps \
                     wakari-enterprise-server-conf-update=2.0.3
    弹出
    
  4. 启动弹性搜索:

    须藤 服务 弹性搜索 开始
    

    或者,如果你希望使用的搜索功能,编辑您的服务器config.json

    / opt / wakari / wakari - server / etc / wakari / config . json
    

    添加订单项:。"SEARCH_ENABLED": false

  5. 启动服务器

    须藤 服务 wakari -服务器 启动
    
  6. 检查服务器是否正常运行:

    须藤 服务 wakari -服务器 状态
    
  7. 最后,使用您的网络浏览器连接到 AEN 服务器,使用正确的协议(httphttps)、主机名和端口号。

AEN 网关

在每个网关主机上重复以下操作。

  1. 升级网关

    推/tmp
    wget http://j.mp/aen-gateway-update-4-1-2
    
    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \
                     -p /opt/wakari/wakari-gateway \
                     --file aen-gateway-update-4-1-2
    
    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \
                     -p /opt/wakari/wakari-gateway \
                     --no-deps \
                     wakari-enterprise-gateway-conf-update=2.0.3
    弹出
    
  2. 启动网关

    须藤 服务 wakari -网关 启动
    
  3. 检查网关是否正常运行:

    须藤 服务 wakari -网关 状态
    
  4. 最后,使用 Web 浏览器连接到Gateway,使用正确的协议(httphttps)、主机名和端口号。

AEN 计算

在运行 AEN Compute 服务的每个主机上重复以下操作。

被杀死的进程killall$AEN_SRVC_ACCT用户运行,因此它们可以作为 root 被杀死或作为 用户被杀死。这些示例命令显示了该选项。sudo killall$AEN_SRVC_ACCTsudo -u $AEN_SRVC_ACCT killallsudo killall

  1. 检查是否有任何wakari-indexer正在运行的进程:

    ps 辅助 |  grep  wakari -索引器
    

    注意:如果您停止了所有项目,您将看不到任何 wakari-indexer 进程正在运行。

  2. 终止任何剩余的wakari-indexer进程:

    sudo  killall  wakari -索引器
    
  3. 检查正在运行的任何 AEN 应用程序(gateone、工作台、查看器、终端、笔记本)进程:

    ps 辅助 |  grep  wk - app - gateone 
    ps  aux  |  grep  wk -应用程序-工作台
    ps  aux  |  grep  wk -应用程序-查看器
    ps  aux  |  grep  wk -应用程序-终端
    ps  aux  |  grep  jupyter -笔记本
    

    注意:如果您停止了所有项目,您将看不到任何 AEN 应用进程正在运行。

  4. 终止您发现的所有剩余 AEN 应用程序进程:

    sudo  killall  wk - app - gateone 
    sudo  killall  wk - app -工作台
    sudo  killall  wk - app -查看器
    sudo  killall  wk - app -终端
    sudo  killall  jupyter - notebook
    
  5. 验证内容/opt/wakari/anaconda/.condarc。修改它以包含以下条目(如果您自定义了.condarc文件,可能还有其他条目)。请务必删除 , 因为我们将在以下步骤中升级 conda。auto_update_conda: false

    注意:以AEN_SRVC_ACCT用户身份修改文件(或确保保持相同的所有权)。

    频道: 
      -  https : // conda . 蟒蛇org / t /< TOKEN >/ anaconda - nb - extensions 
      -  r 
      -  https : // conda . 蟒蛇组织/ wakari 
      - 默认值
    
    create_default_packages : 
      -  anaconda -客户端
      -  ipykernel
    

    注意:请联系您的企业支持代表以获取<TOKEN>上面提到的 Anaconda 频道。

    注意:替换<TOKEN>为来自企业支持代表的实际令牌。

  6. 在root环境升级conda

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda install \
                    -p /opt/wakari/anaconda conda=4.3.14
    

    conda升级成功后,修改/opt/wakari/anaconda/.condarc文件,重新添加上一步去掉的那一行。auto_update_conda: false

  7. 在root环境下升级Anaconda

    推/tmp
    wget http://j.mp/aen-anaconda-update-4-1-2
    
    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda install \
                    -p /opt/wakari/anaconda \
                    --file aen-anaconda-update-4-1-2
    
    弹出
    
  8. 初始化根环境以准备包缓存:

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda create \
                    -p /opt/wakari/testenv \
                    --克隆根
    

    并使用以下命令测试离线克隆步骤:

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda create \
                    -p /opt/wakari/testenvoffline \
                    --clone root --offline
    

    最后删除那些测试环境:

    sudo  rm  - rf  / opt / wakari / testenv 
    sudo  rm  - rf  / opt / wakari / testenvoffline
    
  9. 升级每个Compute服务:

    推/tmp
    wget http://j.mp/aen-compute-update-4-1-2
    
    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda install \
                     -p /opt/wakari/wakari-compute \
                     --file aen-compute-update-4-1-2
    
    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda install \
                     --no-deps \
                     -p /opt/wakari/wakari-compute \
                     wakari-enterprise-compute-conf-update=2.0.4
    弹出
    

    注意:从 AEN 4.1.0 及更高版本开始,wakari-app-gateone已弃用且不再受支持。

    注意:升级 wakari-compute 环境时,您可能会看到 带有一些 nbextensions 的ImportError警告。只要Validating消息是 OKImportError警告就是无害的(只是这些包上存在链接后的结果)。

  10. 运行 upgrade_412.sh 脚本以使您的 4.1.1 项目与 4.1.2 代码库兼容:

    PUSHD  / tmp目录
    的wget  - Ø  upgrade_412 sh  http : // j . mp / upgrade_412 
    chmod  a + x  upgrade_412 sh 
    ./ upgrade_412 SH 
    POPD
    
  11. 安装必要的依赖项:

    注意:如果您已经从以前的安装中安装了这些依赖项,请跳过此步骤。

    sudo  yum  groupinstall  "X Window System"  - y 
    sudo  yum  install  git  - y
    

    注意:如果您不想安装整个 X Window 系统,则至少需要安装以下软件包才能获得 R 绘图支持:

    须藤 yum的 安装 - Ÿ  libXrender  libXext  libXdmcp  libSM  libICE  libXt \
     DEJAVU - SANS -字体 幻觉记忆-衬线-字体 幻觉记忆-字体-通用\
     fontpackages -文件系统
    
  12. 启动计算服务:

    须藤 服务 wakari -计算 开始
    
  13. 验证Compute服务是否正常运行:

    须藤 服务 wakari -计算 状态
    
  14. 对数据中心内的所有计算节点重复升级过程。

飞行后检查

  1. 您现在可以启动项目并开始使用 AEN 应用程序。
  2. 如果您有自定义的默认环境,您可以根据用户的需要选择升级它。

注意:在defaultat升级环境 /opt/wakari/anaconda/envs/default不会自动升级default用户预先存在的项目中的 环境。对于预先存在的项目,升级(如果被请求)应该在每个用户的基础上完成。

  1. 如果您在升级前没有停止所有项目,那么第一次启动应用程序时,您会看到一个错误页面,要求您重新启动应用程序。重新启动应用程序以完成升级。
  2. 如果您仍然在笔记本应用程序中看到旧应用程序或旧 IPython 徽标,请重新加载页面以重置浏览器缓存。