How to upgrade APS Acronis with moving to a new Endpoint node?

Original Publishing Date:
2020-01-22

Symptoms

It is required to upgrade APS Acronis Backup Cloud from version 2.2-1925 to 2.2-1994. However, Acronis APS package version 2.2-1994 demands a specific Endpoint configuration (Centos 7, PHP 5.6 and APS framework version 7.3-101) the current Endpoint does not match the configuration.

Resolution

The procedure should be performed in 3 stages:

Migrate the APS instance to a New endpoint.

configure the new endpoint node according to Knowledgebase article

create an archive of directory /var/www/html/backupservice/ from the old endpoint node:

[root@old_endpoint ~]# cd /var/www/html/
[root@old_endpoint html]# tar -czvf backupservice.tar.gz backupservice/

copy the archive to the new server and extract it:

[root@old_endpoint ~]# scp backupservice.tar.gz root@<new_endpoint_IP>:/root
[root@new_endpoint ~]# tar -xvzf backupservice.tar.gz
[root@new_endpoint ~]# cp -r backupservice/* /var/www/html/backupservice/
[root@new_endpoint ~]# chown -R apache:apache /var/www/html/backupservice/

create /etc/httpd/conf.d/acronis.conf with the following content:

[root@new_endpoint ~]# cat /etc/httpd/conf.d/acronis.conf
LoadModule ssl_module modules/mod_ssl.so

Listen 10443

<Directory "/var/www/html/backupservice">
    Options FollowSymLinks ExecCGI
    AllowOverride All
    Order allow,deny
    Allow from all
</Directory>

<VirtualHost _default_:10443>

  Alias "/backupservice" "/var/www/html/backupservice"
  ErrorLog logs/acronis_ssl_error_log
  TransferLog logs/acronis_ssl_access_log
  LogLevel warn
  SSLEngine on
  SSLProtocol all -SSLv2
  SSLCipherSuite ALL:!ADH:!EXPORT:!SSLv2:RC4+RSA:+HIGH:+MEDIUM:+LOW
  SSLCertificateFile /etc/pki/tls/certs/clientcert.crt
  SSLCertificateKeyFile /etc/pki/tls/private/clientcert.key
  SSLVerifyClient optional_no_ca
  SSLOptions +StdEnvVars +ExportCertData

  SetEnvIf User-Agent ".*MSIE.*" \
           nokeepalive ssl-unclean-shutdown \
           downgrade-1.0 force-response-1.0

  CustomLog logs/ssl_request_log \
            "%t %h %{SSL_PROTOCOL}x %{SSL_CIPHER}x \"%r\" %b"

</VirtualHost>

create files /etc/pki/tls/certs/clientcert.crt and /etc/pki/tls/private/clientcert.key, the certificate and key can be taken fron the old endpoint;

start Apache:

[root@new_endpoint ~]# systemctl start httpd

Change the Endpoint URI of Application Instance.

If the environment version is 20.4 and below , please contact CloudBlue Commerce Support to change Endpoint URI in the Database, refer to the article How to change Endpoint URI of Application Instance;

If the environment version is 20.5 and above , changing the endpoint URI have been made simple.
Go to Services > Applications > Acronis application > Click on the Instance > General > Edit Connection Settings > Enter your new Application API End-point URI.

Upgrade the instance from 2.2-1925 to 2.2-1972 version:
- place the APS package .zip file to the new server;
- Extract files from .zip archive, unzip rpms/*:
```
[root@new_endpoint ~]# unzip AcronisBackupCloud-2.2-1972.app.zip rpms/*
```
- specify host that should be used to connect to CloudBlue Commerce Public API (PCP > System > Settings > Public API > Access Point: http://10.10.10.1:8440/)
```
[root@new_endpoint ~]# export POA_HOST=10.10.10.1
```
- install the .rpm file shipped with the package:
```
[root@new_endpoint ~]# rpm -Uvh acronis-backup-cloud-2.2-1972.premium.x86_64.rpm --nopre --force
```
- in the PCP, go to Services > Applications. Click the package, click General > Upgrade instances > Upgrade all instances;

Upgrade the instance from 2.2-1972 to 2.2-1994 version:

perform the steps like in point #2, the last one will be:

[root@new_endpoint ~]# rpm -Uvh acronis-backup-cloud-2.2-1994.premium.x86_64.rpm

in case the task Upgrading resources of application 'Acronis Backup Cloud' fails:

Internal error: APSC: Upgrade to ver. 2.2-1994 : resource 0fd61eb7-5bd6-4e79-90fc-1903578ccc0d of type 'globals' (http://acronis.com/aps/cloud-backup-v1/globals/9.3) for APS application 'Acronis Backup Cloud-2.2-1994' : No suitable 'upgrade' found in 'Acronis Backup Cloud-2.2-1994' for version '2.2-1925'.

go to PCP > Services > Applications > Acronis Backup Cloud > Versions, remove the version 2.2-1925 and resubmit the task.

Please note that Acronis advices to run precheck scripts prior to APS upgradea according to: APS Package update pre-check tools