开源监控工具 Hyperic 的迁移和升级
常识告诉我们，升级到最新版通常是最佳实践，这是由于新版本往往提供更好的功能，性能等等。
Hyperic 升级主要分为两个部分：
升级Hyperic Server和数据库
如果您当前使用的不是 vPostgreSQL，那么您必须升级。
升级到 5.8， Windows平台
前提条件：
-
确认当前的 Hyperic Server 已停止，可使用 Windows服务控制面板。
-
(可选) 如果使用外部数据库，请确认已经备份。
-
(可选) 建议最好备份您当前的Hyperic Server目录。
过程：
-
以升级模式运行 Hyperic 安装程序
|
1
|
c:\hyperic\hyperic-hq-installer\setup.bat -upgrade. |
-
根据提示，输入当前Hyperic Server实例的完整路径。例如：
|
1
|
/opt/hyperic/server-5.0.0 |
-
输入新Hyperic server 实例准备安装的完整路径。例如， c:\hyperic\.
安装程序将完成升级。
如果使用随Hyperic 自带的数据库，升级过程将完成数据库的升级过程。
其他：
-
更新Windows Service，例如
|
1
|
c:\hyperic\server-5.1.0\bin\hq-server.bat install |
-
启动Hyperic Server 实例，例如：
|
1
|
/opt/hyperic/server-5.1.0/bin/hq-server.sh start. |
升级到 5.8， Unix-Based平台
前提条件：
-
确认待升级的Hyperic Server 未使用内置数据库；（如果使用了内置数据库，请联系我们）
-
确认当前的 Hyperic Server 已停止；可使用下面命令停止，例如：
|
1
|
/opt/hyperic/server-5.8.4/bin/hq-server.sh stop. |
-
备份 Hyperic 数据库；
-
(可选) 建议最好备份Hyperic Server的整个目录；例如：
|
1
|
tar -zcvf hq-server-5.8.4-archive.tgz hq-server-5.8.4 |
过程：
-
下载新版本的Hyperic Server安装程序;
-
以升级模式运行 Hyperic 安装程序；
|
1
|
/opt/hyperic/hyperic-hq-installer/setup.sh -upgrade |
-
根据提示，输入当前Hyperic Server实例的完整路径。例如：
|
1
|
/opt/hyperic/server-5.8.4 |
-
输入新Hyperic server 实例准备安装的完整路径。例如，/opt/hyperic.
安装程序将完成升级。
其他：
启动新版本的Hyperic Server 实例，例如
|
1
|
/opt/hyperic/server-5.8.4/bin/hq-server.sh start |
迁移到 vPostgreSQL 数据库
当前的Hyperic只支持 vPostgreSQL 数据库，如果使用的是其他数据库（Hyperic早期版本），那么可以在安装升级后的Hyperic Server后，将数据库迁移到 vPostgreSQL 。
整个过程包括从当前数据库导出数据，然后导入到 vPostgres 数据库；
注意，在导入过程中，Hyperic Server应是停止的。
前提条件
-
新版本的Hyperic Server 与 导入过程使用同一个数据库账户；
-
停止旧版本的Hyperic Server;
-
导入数据库时，必须有超级用户权限；
默认情况下，数据库的登录凭据存储在 hq-server.conf 文件的 属性 server.database-user 和 server.database-password 中，如果这个用户不是超级用户，必须在导入过程中提供超级用户的凭据；
-
安装 新版的 vPostgreSQL数据库；
-
安装目录属于 vCenter Hyperic 用户，必须使用命令确认
|
1
|
chown -R hyperic /opt/hyperic/hyperic-hqee-installer/installer/ |
过程
-
导出当前数据库和服务器配置；
-
从新Hyperic 的安装包中的 installer/bin目录下，将 hq-migration-5.8.zip 复制到当前待迁移的主机上，例如 Hyperic 4.x 主机；
-
设置 JAVA_HOME.
-
解开 ZIP 文件. 解开的 ZIP的根目录作为 MigrationHome.
-
导出所有配置和指标数据，运行如下命令：
|
1
|
PathToMigrationHome/hq-migrate.sh hq-export -Dhqserver.install.path=PathToServerHome |
其中 PathToServerHome 是 Hyperic server 安装目录的全路径，或到 MigrationHome 的相对路径；如果只想导出配置数据u，可使用参数 -DconfigOnly=true;
该脚本读取旧版本的 hq-server.conf 文件，连接到数据库，导出数据库，并且创建一个包， hq-migration-export-HqVersion.tgz.
默认情况下，该文件保存在 migration_home/tmp/export-data import staging 目录 或者可使用staging.dir 指定；
-
导入数据库和服务器配置
-
复制文件 hq-migration-export-HqVersion.tgz 到新Hyperic 主机。
-
运行如下命令，
|
1
|
PathToMigrationHome/hq-migrate.sh hq-import -Dhqserver.install.path=PathToServerHome -Dexport.archive.path=PathToExportArchive |
输入正确的 PathToServerHome 和 PathToExportArchive 值；
迁移结束；
升级Hyperic Agent
更新Agent Bundle中，当前的配置文件会被保留。AgentHome/conf/agent.properties 文件不会被覆盖.
过程
-
将文件 agent-5.x.y-nnn.tgz 或 agent-5.x.y-nnn.zip 从ServerHome/hq-engine/hq-server/webapps/ROOT/WEB-INF/hq-agent-bundles 复制到 AgentHome/bundles.
-
解开 agent bundle.
-
编辑AgentHome/conf 目录下的 rollback.properties文件，重新指定 agent bundle.