升级 AEN (AEN 4.2.1)

注意:这些说明仅用于将 AEN 从 4.2.0 升级到当前版本 4.2.1。每个版本都必须从以前的版本迭代升级。不要跳过版本。

以前版本的升级说明:

对于从上面列出的版本之前的版本进行升级,请联系您的企业支持代表。

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

AEN 平台更新需要单独升级 3 种节点类型的每个实例:

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

升级过程要求所有 AEN 服务实例停止、升级,然后重新启动。

注意:任何需要 root 用户的命令也可以使用 sudo 来完成。

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

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

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

升级之前

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

注意:在开始升级过程之前,终止所有 AEN 应用程序并停止所有项目。

在升级每台主机上的每项服务之前:

  1. 暂停每个节点上的服务:

    须藤服务 wakari 服务器停止
    须藤服务 wakari-gateway 站
    须藤服务 wakari-计算停止
    
  2. 将 AEN 功能 ID(“NFI”)和 AEN 功能组(“NFG”)设置为当前安装的 NFI 和 NFG:

    export  AEN_SRVC_ACCT = "wakari" 
    export  AEN_SRVC_GRP = "wakari"
    

    注意:默认的 NFI 是wakari,但aen_admin也可以使用任何其他名称来代替。

    有关 NFI 和 NFG 的更多信息,请参阅 安装说明

  3. 安装wget

    yum 安装 wget
    

升级 AEN 服务器节点

注意:如果您使用基于 LDAP 的身份验证,请备份 /opt/wakari/wakari-server/etc/wakari/wk-server-config.json 配置文件。服务器升级后,将该文件复制回升级前的相同位置。

在服务器主机上完成以下步骤:

  1. 停止 Elasticsearch 服务:

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

    须藤 rm -rf /var/lib/elasticsearch/*
    

    注意:您可以选择保留旧索引,但如果您在升级后检测到搜索功能有任何问题,您将需要运行以下命令以从一个干净的索引开始:

    须藤服务 wakari 服务器停止
    须藤服务弹性搜索停止
    须藤 rm -rf /var/lib/elasticsearch/*
    须藤服务弹性搜索开始
    须藤服务 wakari 服务器启动
    
  3. 升级服务器:

    /tmp
    wget http://j.mp/aen-server-update-4_2_1
    
    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \ 
                    -p /opt/wakari/wakari-server           \
                    --file aen-server-update-4_2_1
    
    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.7
     popd
    
  4. 启动 Elasticsearch:

    须藤服务弹性搜索开始
    

    或者,如果您不想使用搜索功能,请/opt/wakari/wakari-server/etc/wakari/config.json 通过添加行来编辑您的服务器文件。"SEARCH_ENABLED": false

  5. 重启NGINX服务器:

    AEN 服务器版本 >= 4.1.3 使用 Unix 套接字与 NGINX 通信。重新启动 NGINX 以加载这个新配置:

    须藤服务 nginx 重启
    

    或者,您可以使用以下命令重新启动 NGINX:

    须藤 nginx -s 停止
    须藤nginx
    
  6. 启动服务器:

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

    须藤服务 wakari 服务器状态
    
  8. 如果您看到 NGINX 错误,请检查配置/opt/wakari/wakari-server/etc/nginx/conf.d/www.enterprise.conf:18

  9. 使用具有正确协议(http 或 https)、主机名和端口号的 Web 浏览器连接到 AEN 服务器。

升级 AEN 网关节点

在每个网关主机上完成以下步骤:

  1. 升级网关:

    /tmp
    wget http://j.mp/aen-gateway-update-4_2_1
    
    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \ 
                    -p /opt/wakari/wakari-gateway          \
                    --file aen-gateway-update-4_2_1
    
    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.7
     popd
    
  2. 启动网关:

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

    须藤服务 wakari 网关状态
    
  4. 使用 Web 浏览器和正确的 http/https、主机名和端口号连接到网关。

升级 AEN 计算节点

在运行 AEN 计算服务的每个主机上完成以下步骤:

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

    ps辅助| grep wakari-indexer
    

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

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

    sudo killall wakari-indexer
    

    注意:被杀死的进程killall是由 $AEN_SRVC_ACCT 用户运行的,因此它们可以作为 root 被杀死,或者作为 $AEN_SRVC_ACCT 用户 被杀死 。示例命令显示该选项。sudo killallsudo -u $AEN_SRVC_ACCT killallsudo killall

  2. 检查正在运行的任何 AEN 应用程序进程——工作台、查看器、终端或笔记本:

    ps辅助| grep wk-app-gateone
    ps辅助| grep wk-app-workbench
    ps辅助| grep wk-app-viewer
    ps辅助| grep wk-app-终端
    ps辅助| grep jupyter-笔记本
    

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

    通过运行以下一项或多项来终止任何剩余的 AEN 应用程序进程:

    须藤 killall wk-app-gateone
    须藤 killall wk-app-workbench
    sudo killall wk-app-viewer
    须藤killall wk-app-终端
    须藤killall jupyter笔记本
    
  3. 验证内容/opt/wakari/anaconda/.condarc。修改它以包含以下条目,如果您自定义了该.condarc文件,还可能包含其他条目。

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

    频道
      -  https://conda.anaconda.org/t/<TOKEN>/anaconda-nb-extensions 
      -  r 
      -  https://conda.anaconda.org/wakari 
      - 默认值
    
    create_default_packages : 
      -  anaconda-client 
      -  ipykernel
    

    注意:请联系您的企业支持代表以获取上面提到的 Anaconda 频道的令牌。替换 <TOKEN>为来自企业支持代表的实际令牌。

  4. 升级每个计算服务:

    /tmp
    wget http://j.mp/aen-compute-update-4_2_1
    
    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda install \ 
                    -p /opt/wakari/wakari-compute         \
                    --file aen-compute-update-4_2_1
    
    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.12
     popd
    

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

  5. 初始化根环境以准备包缓存:

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda create \ 
                    -p /opt/wakari/testenv \
                    --克隆根
    
  6. 测试离线克隆步骤:

    sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda create \ 
                    -p /opt/wakari/testenvoffline \
                    --clone root --offline
    
  7. 删除测试环境:

    须藤 rm -rf /opt/wakari/testenv
    须藤 rm -rf /opt/wakari/testenvoffline
    
  8. 安装必要的依赖项:

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

    sudo yum groupinstall "X Window System" -y
    须藤 yum 安装 git -y
    

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

    sudo yum install -y libXrender libXext libXdmcp libSM libICE libXt \ dejavu 
    -sans-fonts dejavu-serif-fonts dejavu-fonts-common \
    fontpackages-文件系统
    
  9. 启动计算服务:

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

    须藤服务 wakari 计算状态
    
  11. 使用以下命令重新启动 AEN 服务器:

    须藤服务 wakari 服务器重启
    
  12. 对数据中心内的所有计算节点重复此升级过程。

升级后

  1. 重新启动项目并开始使用 AEN 应用程序。

  2. 如果您有自定义的默认环境,您可以根据用户的需要选择升级它。

    注意:在 at 升级默认环境 /opt/wakari/anaconda/envs/default不会自动升级用户预先存在的项目中的默认环境。对于预先存在的项目,如果需要,升级应按用户进行。

  3. 如果您在升级前没有停止所有项目,那么第一次启动应用程序时,您将看到一个错误页面,要求您重新启动应用程序。

  4. 重新启动应用程序以完成升级。

  5. 如果重启后仍然看到旧的应用程序或图标,请重新加载页面以重置浏览器缓存。