一. 测试环境概述
- 原始Enterprise版本:10.7.1
- 操作内容:测试迁移到另外的搭建好10.7.1Enterprise环境的虚拟机,并升级Enterprise到10.8版本
- 使用工具:Portal自带备份工具webgisdr
- 原始环境包含的测试服务:
测试服务为地图服务,切片缓存服务,三维服务各一个,共计三个服务。
二. 迁移
1. 官方参考帮助
https://enterprise.arcgis.com/zh-cn/get-started/latest/windows/upgrade-arcgis-enterprise.htm
https://enterprise.arcgis.com/zh-cn/portal/latest/administer/windows/create-web-gis-backup.htm
https://enterprise.arcgis.com/zh-cn/portal/latest/administer/windows/restore-web-gis.htm
2. 基本要求
新机器的ArcGIS操作系统账户密码,Server站点账户密码安装位置,Portal账户密码安装位置,要保持一致。
3. 10.7.1原始环境备份
使用工具:
工具备份内容:Portal,Server,DS 。运行状态下进行备份。
命令行运行:
webgisdr.bat -e -f webgisdr.properties
webgisdr.properties文件需要修改内容,本次测试内容如下,文本系统备份,其中需要修改的参数为:PORTAL_ADMIN_URL,PORTAL_ADMIN_USERNAME, PORTAL_ADMIN_PASSWORD, PORTAL_ADMIN_PASSWORD_ENCRYPTED, SHARED_LOCATION, INCLUDE_SCENE_TILE_CACHES, BACKUP_LOCATION.
#
# Configuration properties for WebGIS DR Tool
#
# Set the JAVA_HOME operating system environment variable to a Java 1.8 or later installation directory.
#
############################
########## Portal properties
############################
# Specify the URL to your portal.
# Example:
# https://webadaptor.domain.com/context
# or
# https://portalmachine.domain.com:7443/arcgis
PORTAL_ADMIN_URL = https://xxxx.xxx.com:7443/arcgis
# Provide credentials for the portal administrator.
# Initially, leave PORTAL_ADMIN_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and PORTAL_ADMIN_PASSWORD_ENCRYPTED will change to true.
PORTAL_ADMIN_USERNAME = xxxx
PORTAL_ADMIN_PASSWORD = tJY1fz6Ju44d4FtJ2PKkTw==
PORTAL_ADMIN_PASSWORD_ENCRYPTED = true
# Specify the Web GIS backup restore mode: full or incremental.
BACKUP_RESTORE_MODE = full
# Specify a shared location to store the Web GIS backup file. This is where the backups for
# individual components will be saved to before being moved to the storage that you specify
# for the BACKUP_STORE_PROVIDER property
# The following accounts must have read and write permissions on the shared location:
# 1) The domain account used to run the web GIS software.
# 2) The account to run this tool.
SHARED_LOCATION= C:\\backup
# Specify whether to include scene tile caches.
INCLUDE_SCENE_TILE_CACHES = true
####################################
########## Web GIS backup properties
####################################
# Specify a storage provider to store the Web GIS backup: FileSystem, AmazonS3, or AzureBlob.
BACKUP_STORE_PROVIDER = FileSystem
# Specify the Web GIS backup location if you've set the BACKUP_STORE_PROVIDER to FileSystem.
BACKUP_LOCATION = C:\\backup
# Specify Amazon S3 Storage properties if you've set the BACKUP_STORE_PROVIDER to AmazonS3.
S3_ACCESSKEY =
S3_SECRETKEY =
S3_ENCRYPTED =
S3_BUCKET =
# IAMRole or accessKey
S3_CREDENTIALTYPE =
S3_REGION =
# Specify a backup name used for the Web GIS restore only.
# Example:
# April-20-2017-5-04-14-PM-PDT-FULL
# or
# webgisdr-backup/10-5-1/full/April-20-2017-5-04-14-PM-PDT-FULL
S3_BACKUP_NAME =
# Specify Azure Blob Storage properties if you've set the BACKUP_STORE_PROVIDER to AzureBlob.
AZURE_BLOB_ACCOUNT_NAME =
AZURE_BLOB_ACCOUNT_KEY =
AZURE_BLOB_ACCOUNT_KEY_ENCRYPTED =
# Specify a Azure Blob storage endpoint suffix.
# Example: core.windows.net
AZURE_BLOB_ACCOUNT_ENDPOINT_SUFFIX =
AZURE_BLOB_CONTAINER_NAME =
# Optional.
# If you're using a custom blob storage endpoint, uncomment the AZURE_BLOB_ENDPOINT_URL
# If it's not a custom blob storage endpoint, the default URL is https://<accountname>.blob.core.windows.net
#AZURE_BLOB_ENDPOINT_URL =
# Specify a backup name used for the Web GIS restore only.
# Example:
# April-20-2017-5-04-14-PM-PDT-FULL
# or
# webgisdr-backup/10-5-1/full/April-20-2017-5-04-14-PM-PDT-FULL
AZURE_BLOB_BACKUP_NAME =
####################################
########## Portal PKI properties
####################################
# Set to true if use a public key infrastructure (PKI) to secure access to your portal.
IS_PORTAL_PKI_AUTHENTICATED = false
# The full path of the portal PKI certificate file used for client certificate authentication.
# This file needs to be in PKCS12 format.
PORTAL_CLIENT_CERTIFICATE_FILE_PATH =
# The corresponding password for the portal PKI certificate file.
# Initially, leave PORTAL_CLIENT_CERTIFICATE_PASSWORD_ENCRYPTED set to false.
# When you run the tool the first time, the password will be
# encrypted and PORTAL_CLIENT_CERTIFICATE_PASSWORD_ENCRYPTED will change to true.
PORTAL_CLIENT_CERTIFICATE_PASSWORD =
PORTAL_CLIENT_CERTIFICATE_PASSWORD_ENCRYPTED =
#################################################
########## Portal content on cloud properties
#################################################
# If your portal content directory is in Amazon S3, specify Amazon S3 Storage properties for portal content backups.
PORTAL_BACKUP_S3_BUCKET =
PORTAL_BACKUP_S3_REGION =
# If your portal content directory is in Azure Blob, specify Azure Blob Storage properties for portal content backups.
PORTAL_BACKUP_BLOB_ACCOUNT_NAME =
PORTAL_BACKUP_BLOB_ACCOUNT_KEY =
PORTAL_BACKUP_BLOB_ACCOUNT_KEY_ENCRYPTED =
# Specify a Azure Blob storage endpoint suffix.
# Example: core.windows.net
PORTAL_BACKUP_BLOB_ACCOUNT_ENDPOINT_SUFFIX =
PORTAL_BACKUP_BLOB_CONTAINER_NAME =
其中:
INCLUDE_SCENE_TILE_CACHES = true 备份ds切片缓存三维场景
另外原始填写以下设置为明文密码,执行后Enterprise自动修改为加密:
PORTAL_ADMIN_PASSWORD = esri1234
PORTAL_ADMIN_PASSWORD_ENCRYPTED = false
其中backup文件夹为自己创建的文件夹,并且安全赋予ArcGIS安全控制权限。
Server切片缓存需要单独备份
与Server单独恢复备份不同,经测试使用webgisdr工具地图服务也会进行备份,所以只需要拷贝切片缓存即可。这里只拷贝切片服务xzqhcache:
4. 新机器恢复Enterprise10.7.1服务
新的环境,重新安装了Server及Portal,ArcGIS及所有站点用户名密码、安装位置保持一致。
Server、DS、Portal运行状态下使用webgisdr.bat工具:此处properties文件内容可以复制之前的内容,在c盘也创建一个backup文件夹,把之前备份的文件拷贝进去。
然后Portal工具文件夹下运行命令:
webgisdr.bat -i -f webgisdr.properties
同样webgisdr文件要修改内容,参考之前内容。
*注:在运行工具之前,如果Server有注册的文件夹,先创建好同名文件夹,设置好访问权限,Server之后都是可以恢复注册的。
*
恢复完成之后,注意核查
Server配置目录是否正常为原目录,测试过程中遇到如果先拷贝了config目录下中data及service文件夹以及directories文件夹,再恢复;会出现Server恢复到了一个零时目录tmp,导致后期升级完成后原始服务无法访问。这里还未测试如果先恢复再拷贝覆盖以上文件夹是否可行。(经测试,map server相关文件不用拷贝,停止Server,只拷贝对应arcgiscache下的对应切片,重启server即可)
恢复后错误路径:
并且无法修改路径:
三. 升级
1. 官方升级步骤
按照官方升级步骤升级即可,Enterprise运行状态下升级,具体步骤为:
- Portal安装升级
- Portaladmin解除wa
- 安装配置新的wa
- Server安装升级
- Serveradmin解S除wa
- 安装配置新的wa
- DS升级
注:目前10.8版本需要先配置tilecache备份位置才能使用webgisdr工具备份安装完检查服务是否正常。