Migration of ActiveImage Protector settings

Details

ActiveImage Protector does not provide the feature of migrating the settings.
When the migration source and target is the same PC or when migration source and target version of AIP is the same, migration normally completes. However, in some cases it may not successfully complete. In this case, you have to configure the settings again. Please note that we cannot guarantee the behavior of AIP.

Notes on this article

- The following settings can be migrated. The others (HyperStandby, vStandby) are not supported.
1) Schedule settings (agent-based backup/agentless backup/File Backup)
2)Preference
- When using ActiveImage Protector combined with the an add-on product, for example, ImageCenter, etc., the settings cannot be migrated and most probably you will have to configure the settings again.
- When schedule with post-backup process settings do not normally operate, please access the following article.
Changing the hostname prevents the post-backup process from running
https://actiphyhelp.zendesk.com/hc/en-us/articles/13451315178649

When manually deleting backup image files in a storage folder, Post-backup Process or ImageCenter's respective features do not operate
https://actiphyhelp.zendesk.com/hc/en-us/articles/32816637608729

- When migrating the settings for ActiveImage Protector 2018 to ActiveImage Protector 2022, ActiveImage Protector 2022 does not properly operate.
- When both migration source and target versions are AIP2018 or AIP2022, AIP may not work properly unless they are between identical major versions.
Ex）Migrating from Version 7.0.3.8919 to Version 7.5.0.9448
AIP2018 Release Note
https://webhelp.actiphy.com/AIP/2022/en_US/docs/releasenote.html

AIP2022 Release Note
https://webhelp.actiphy.com/AIP/2022/en_US/docs/releasenote.html#main-top

You are recommended to upgrade to AIP2022 and use the operating procedures provided in the article.
Upgrading from ActiveImage Protector 2018 Update 7 or later
https://actiphyhelp.zendesk.com/hc/en-us/articles/13451314822553

- When migration source and target AIP editions are different, migration of settings is supported. However, settings migration between Windows Edition and Linux Edition is not supported.
Ex）Migration of Server Edition settings to Virtual Edition is supported.
Migration of Server Edition settings to Linux Edition is not supported.
- AIP.db file was implemented with ActiveImage Protector 2022 or later. Since this file is locked by AIP Service, the service must be stopped before migrating the settings.
- File Backup was implemented with ActiveImage Protector 2022 or later Windows Edition.

Before starting migration of the settings, please note the above.

Migration of settings in Windows Edition

Export the settings
1) Start Windows Service and stop ActiveImage Protector Service.
2) Copy the following folders and files to any location.
- AIP install path
C:\Program Files\Actiphy\ActiveImage Protector\ or C:\Program Files (x86)\NetJapan\ActiveImage Protector\
profiles (Profiles of agent-based backup)
schedules (Schedule settings for agent-based/agentless backup and other features)
filebackup (Profiles of file backup)
vmbackup (Profiles of agentless backup)
AIP.db (Hypervisor registration information, etc.)
AIP.ini (Settings)
consolidation (Post-backup Consolidation settings)
replication (Post-backup Replication settings)
verify (Post-backup Verify settings)
folderhistory.ini (history with Destination)

- Path of the Windows logon user
C:\Users\＜logon user＞\AppData\Local\ActiveImageProtector\guicfg.ini （HyperBack authentication information, storage information in CloudStorage）
* Since AppData is a hidden folder, please configure the settings for Windows Explorer to show hidden folders in advance.
3) Start Windows service and ActiveImage Protector Service.

Import settings
1) Start Windows Service and stop ActiveImage Protector Service.
2) Overwrite copy the migrated folders and files to the same path in the target environment.
3) Start Windows Service and ActiveImage Protector Service.

* Basically, when the migration source and target disks are the same, AIP will properly operate. However, you are recommended to edit the schedule settings and make sure there is no problem in the selection of backup source.

Migration of settings in Linux Edition

Migration of settings
1) Launch the terminal window and stop ActiveImage Protector Service.

systemctl stop aipservice.service

2) Copy the following folders and files to any location.
AIP install path
/opt/Actiphy/ or /opt/NetJapan/
profiles (Profiles of agent-based backup)
schedules (Schedule settings for agent-based backup and other features)
AIP.db （Hypervisor registration information, etc.）
AIP.ini （Settings）
consolidation （Post-backup Consolidation settings）
replication （Post-backup Replication settings）
verify （ost-backup Verify settings）
folderhistory.ini （history in Destination）
guicfg.ini （history in CloudStorage）

3) Launch terminal window and start ActiveImage Protector Service.

systemctl start aipservice.service

Import Settings

1) Launch terminal window and stop ActiveImage Protector Service.

systemctl stop aipservice.service

2) Overwrite copy the migrated folders and files to the same path in the target environment.
3) Launch terminal window and start ActiveImage Protector Service.

systemctl start aipservice.service

*When the backup source is a non-LVM system, and the migration source and target disks are the same, it will properly operate. However, in case of LVM systems, since the VG names often differ, you are strongly recommend to edit the schedule settings in the migration target and make sure that backup source LVM system is properly selected.

Target Products

- ActiveImage Protector 2018
- ActiveImage Protector 2022

(47605579702937)