升级AEN (AEN 4.2.0)#
注意：这些说明仅适用于从4.1.3升级AEN到当前版本4.2.0。每个版本必须从前一个版本逐步升级。不要跳过版本。
之前版本的升级说明：
对于从上述版本之前的版本升级，请联系您的企业支持代表。
注意：命名服务帐户功能仅适用于AEN 4.0.0+的新安装。升级安装不提供此功能。如需更多信息，请联系您的企业支持代表。
AEN平台更新要求每种3节点类型的实例分别进行升级：
- AEN Server
- AEN Gateway
- AEN Compute
升级过程要求所有AEN服务实例停止、升级，然后重新启动。
注意：任何需要root用户的命令也可以使用sudo来完成。
如果在升级过程中遇到任何困难，请参阅 Troubleshooting，它提供了以下指导：
- processes
- configuration files
- log files
- ports
如果您无法解决安装或升级问题，请联系您的企业支持代表。
升级前¶
注意：在开始升级之前，请对您的安装进行测试备份。 升级到更高版本的AEN是不可逆的。升级过程中的任何错误可能导致部分或全部数据丢失，并需要从备份中恢复数据。
注意：在开始升级过程之前，请终止所有AEN应用程序并停止所有项目。
在升级每台主机上的每个服务之前：
暂停每个节点上的服务：
sudo service wakari-server stop sudo service wakari-gateway stop sudo service wakari-compute stop
将AEN功能ID（“NFI”）和AEN功能组（“NFG”）设置为当前安装的NFI和NFG：
export AEN_SRVC_ACCT="wakari" export AEN_SRVC_GRP="wakari"
注意：默认的NFI是
wakari，但可以使用aen_admin或任何其他名称代替。有关NFI和NFG的更多信息，请参阅 安装说明。
安装
wget:yum install wget
升级AEN服务器节点¶
注意：如果您使用的是基于LDAP的认证，请备份
/opt/wakari/wakari-server/etc/wakari/wk-server-config.json
配置文件。服务器升级后，将该文件复制回升级前的位置。
在服务器主机上完成以下步骤：
停止Elasticsearch服务：
sudo service elasticsearch stop
移除任何之前的索引：
sudo rm -rf /var/lib/elasticsearch/*
注意：您可以选择保留旧索引，但如果在升级后发现搜索功能有任何问题，您将需要运行以下命令以从干净的索引开始：
sudo service wakari-server stop sudo service elasticsearch stop sudo rm -rf /var/lib/elasticsearch/* sudo service elasticsearch start sudo service wakari-server start
升级服务器：
pushd /tmp wget http://j.mp/aen-server-update-4_2_0 sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \ -p /opt/wakari/wakari-server \ --file aen-server-update-4_2_0 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.6 popd
启动 Elasticsearch：
sudo service elasticsearch start
或者，如果您不想使用搜索功能，请编辑您的服务器的
/opt/wakari/wakari-server/etc/wakari/config.json文件，添加一行"SEARCH_ENABLED": false。移除之前的 Unix 套接字：
AEN 服务器版本 >= 4.1.3 使用 Unix 套接字与 NGINX 进行通信。 版本 4.1.3 使用位于
/tmp的 Unix 套接字。版本 4.2.0 使用位于unix:/opt/wakari/wakari-server/var/run/wakari-server.sock的 Unix 套接字。使用以下命令移除残留的套接字：sudo rm /tmp/wakari-server.sock
重启NGINX服务器：
AEN服务器版本 >= 4.1.3 使用Unix套接字与NGINX进行通信。 重新启动NGINX以加载此新配置：
sudo service nginx restart
或者，您可以使用以下命令重新启动NGINX：
sudo nginx -s stop sudo nginx
启动服务器：
sudo service wakari-server start
检查服务器是否正常运行：
sudo service wakari-server status
如果您看到NGINX错误，请检查位于
/opt/wakari/wakari-server/etc/nginx/conf.d/www.enterprise.conf:18的配置。使用您的网页浏览器连接到AEN服务器，确保使用正确的协议（http或https）、主机名和端口号。
升级AEN网关节点¶
在每个网关主机上完成以下步骤：
升级网关：
pushd /tmp wget http://j.mp/aen-gateway-update-4_2_0 sudo -E -u $AEN_SRVC_ACCT /opt/wakari/miniconda/bin/conda install \ -p /opt/wakari/wakari-gateway \ --file aen-gateway-update-4_2_0 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.6 popd
启动网关：
sudo service wakari-gateway start
检查网关是否正常运行：
sudo service wakari-gateway status
使用您的网页浏览器，通过正确的http/https、主机名和端口号连接到网关。
升级AEN计算节点¶
在每个运行AEN计算服务的主机上完成以下步骤：
检查是否有任何
wakari-indexer进程正在运行：ps aux | grep wakari-indexer注意：如果您停止了所有项目，您将不会看到任何wakari-indexer进程在运行。
终止任何剩余的
wakari-indexer进程：sudo killall wakari-indexer
注意：使用
killall终止的进程是由$AEN_SRVC_ACCT用户运行的，因此可以使用sudo killall以root身份终止，或者使用sudo -u $AEN_SRVC_ACCT killall以$AEN_SRVC_ACCT用户身份终止。示例命令展示了sudo killall选项。检查是否有任何AEN应用程序进程正在运行——Workbench、Viewer、Terminal或Notebook：
ps aux | grep wk-app-gateone ps aux | grep wk-app-workbench ps aux | grep wk-app-viewer ps aux | grep wk-app-terminal ps aux | grep jupyter-notebook
注意：如果您停止了所有项目，您将不会看到任何AEN应用程序进程在运行。
通过运行以下一个或多个命令来终止任何剩余的AEN应用程序进程：
sudo killall wk-app-gateone sudo killall wk-app-workbench sudo killall wk-app-viewer sudo killall wk-app-terminal sudo killall jupyter-notebook
验证
/opt/wakari/anaconda/.condarc的内容。 修改它以包含以下条目，如果您自定义了.condarc文件，可能还需要包含其他条目。注意：以AEN_SRVC_ACCT用户身份修改文件（或确保保持相同的所有权）。
channels: - https://conda.anaconda.org/t/<TOKEN>/anaconda-nb-extensions - r - https://conda.anaconda.org/wakari - defaults create_default_packages: - anaconda-client - ipykernel
注意：请联系您的企业支持代表以获取上述Anaconda渠道的令牌。将
升级每个计算服务：
pushd /tmp wget http://j.mp/aen-compute-update-4_2_0 sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda install \ -p /opt/wakari/wakari-compute \ --file aen-compute-update-4_2_0 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.11 popd
注意：在升级wakari-compute环境时，您可能会看到一些nbextensions的ImportError警告。只要验证消息是OK的，这些ImportError警告是无害的——这是这些包在链接后存在的结果。
运行 upgrade_420.sh 脚本以使您的 4.1.3 项目与 4.2.0 代码库兼容：
pushd /tmp wget -O upgrade_420.sh http://j.mp/upgrade_420 chmod a+x upgrade_420.sh ./upgrade_420.sh popd
初始化根环境以准备包缓存：
sudo -E -u $AEN_SRVC_ACCT /opt/wakari/anaconda/bin/conda create \ -p /opt/wakari/testenv \ --clone root
测试离线克隆步骤：
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
安装必要的依赖项：
注意：如果您已经从之前的安装中安装了这些依赖项，请跳过此步骤。
sudo yum groupinstall "X Window System" -y sudo yum install 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-filesystem
启动计算服务：
sudo service wakari-compute start
验证计算服务是否正常运行：
sudo service wakari-compute status
重新启动AEN服务器，使用以下命令：
sudo service wakari-server restart
为您的数据中心中的所有计算节点重复此升级过程。