以Postgre SQL冷备为主线实现Portal for ArcGIS 10.5至10.5.1的迁移

在Portal for ArcGIS的迁移中，我们最希望且最盼望的是实现原始机器上的平滑升级。然天不遂人愿，在实际场景中，基于原始机器的平滑迁移往往存在各种异常，导致升级失败；严重情况下，甚至导致整个Portal for ArcGIS宕掉。通过反复实践，我们总结了一套较为稳妥的升级方案，即先迁移后升级。
本文讲述了将Portal for ArcGIS 10.5从机器A迁移至机器B，并平滑升级至10.5.1的全过程。这里，A和B的机器名不同。
注：本迁移手册目前仅适用于Portal for ArcGIS中未联合ArcGIS for Server的情况。

---

前期准备

1 获取 Portal for ArcGIS 10.5和10.5.1安装包
2 获取 Portal for ArcGIS的许可

迁移

机器A上的操作

1 停止 Portal for ArcGIS系统服务

2 备份arcgisportal目录下的db文件夹以及content\items文件中除了portal和portal-ha之外的所有文件夹

机器B上的操作

3 安装和配置Portal for ArcGIS 10.5

4 对postgre sql数据库中的对cp_item和gw_groups_organizations两个文件进行备份

以cp_item为例：
pg_dump -U arcgis -p 7654 -t cp_item gwdb > c:\cp_item.sql

5 停止Portal for ArcGIS系统服务
6 将B机器上arcgisportal文件夹下的db文件夹剪切至其他磁盘或直接删除，同时将步骤3中备份的A源服务器上的db 拷贝并替换至arcgisportal下

7 手动启动服务器B上Portal for ArcGIS内置的PostgreSQL db

pg_ctl.exe start -D “c:\arcgisportal\db” -w

注：这一过程中可能会碰到如下错误：

请执行如下操作：
对db文件夹和Portal for ArcGIS安装目录】\framework\etc文件夹赋予Users用户的完全控制权限

8 打开arcgisportal目录下pgsql_9.3.12\bin中的pgAdmin3，连接至Portal for ArcGIS内置的PostgreSQL db；展开Database -> gwdb -> Schemas -> Tables，删除cp_item

9 恢复步骤1中备份出来的cp_item和gw_groups_organizations两个文件

以cp_item.sql为例：
psql.exe -U arcgis -p 7654 -d gwdb < c:\cp_item.sql

10 手动停止Portal for ArcGIS内置的PostgreSQL db

pg_ctl.exe stop -m fast -D “c:\arcgisportal\db”

11 将步骤3中备份的content\items文件夹下除了portal和portal-ha两个文件夹外的其他文件拷贝并合并替换至服务器B的content\items文件夹，包含groupinfo文件夹和所有的item

12 重启 Portal for ArcGIS
13 打开 Portal for ArcGIS的home页面，依次点击 group、content和organization选项卡检查群组、项目和用户是否存在。
14 登录 Portal for ArcGIS的portaladmin页面，点击 System -> Indexer -> Reindex重构索引；构建结束后，查看索引状态

15 双击Portal for ArcGIS 10.5.1的exe可执行文件直至10.5.1安装完毕。

16 清除浏览器缓存
17 点击 continue portal upgrade 继续Portal for ArcGIS的升级

18 在 Create a New Portal 界面上，输入服务器A上Portal for ArcGIS 初始化管理员账户的信息，或新建一个初始化管理员账户，点击 Create

19 点击 OK 完成账户的创建

20 按照步骤13的方法重构索引并检查索引状态
21 登录 Portal for ArcGIS的home页面，检查groups、my content和my organization各选项卡下内容无误。

至此，服务器A上Portal for ArcGIS 10.5至服务器B上Portal for ArcGIS 10.5.1升级完毕。