Upgrading Files Advanced to a newer version

The upgrade procedure from a previous version of Files Advanced is a simplified process and requires almost no configuration.

Note: If you are upgrading from a version of Acronis Access earlier than 7.0, please contact Acronis support at http://www.acronis.com/mobilitysupport/

Note: Before upgrading, please review the Minimum Hardware Requirements.

Note: Depending on your deployment, some of the paths used in this article might not be the same as yours. Upgrades from previous versions of Files Advanced and custom installations can affect the folder structures of your deployment.

Backup the vital components

The Apache Tomcat folder

On upgrade the Apache Tomcat may be upgraded and all of the current Tomcat configuration files and log files will be removed. We recommend you make a copy of the Apache Tomcat folder, which by default is found here: C:\Program Files (x86)\Acronis\Files Advanced\Common\.

We recommend that you backup the web.xml file before updating. Your web.xml file will be overwritten on upgrade. On versions 7.1.2 and newer, you can find a backup at C:\Program Files (x86)\Acronis\Files Advanced\Access Server\Web Application\WEB-INF\<timestamp>.previous.web.xml. If you have made any specific changes that you wish to retain (excluding Single Sign On, those changes are preserved) , you will have to manually copy and paste your changes from the old file.

Purge unnecessary audit logs

If you have not setup automatic log purging, your server may have a lot of logs which may slow-down the backup process. We recommend exporting and purging the older logs before proceeding with the database backup.

The PostgreSQL database

The following method creates an *.sql file containing a text representation of the source database.

1. Open a Command Prompt window and navigate to the 9.2\bin folder located in the PostgreSQL installation directory.
   e.g. cd "C:\PostgreSQL\9.2\bin"
2. Once your current Command Prompt directory is the bin folder, enter the following line:
   
   pg_dump -U postgres -f mybackup.sql acronisaccess_production
   where mybackup.sql is the desired file name for the produced backup file. It can include a full path to the location where you want the backup file to be created, for instance: D:\Backups\mybackup.sql

   Note: acronisaccess_production must be entered exactly as shown as it is the name of the Files Advanced database

3. A "Password: " line appears. Enter the postgres password that you set during the Files Advanced installation process.

   Note: Typing the password will not result in any visual changes in the Command Prompt window.

4. Your backup file will appear in the bin folder by default unless the output file specification contains a full path to a different directory.

Note: If you want to backup the entire PostgreSQL database set you can use the following command:

pg_dumpall -U postgres > alldbs.sql

Where alldbs.sql will be the generated backup file. It can include a full path specification, for instance D:\Backups\alldbs.sql

For full syntax on this command see: http://www.postgresql.org/docs/9.2/static/app-pg-dumpall.html

Info: For more information on PostgreSQL backup procedures and command syntax please read this: http://www.postgresql.org/docs/9.2/static/backup.html

The Gateway Server(s) database(s)

1. Go to the server on which you have your Files Advanced Gateway Server installed.
2. Navigate to the folder containing the database.

   Note: The default location is: C:\Program Files (x86)\Acronis\Files Advanced\Gateway Server\database

3. Copy the mobilEcho.sqlite3 file and paste it in a safe location.

The Files Advanced configuration file

1. Navigate to the Files Advanced installation folder containing the configuration file.

   Note: The default location is: C:\Program Files (x86)\Acronis\Files Advanced\Access Server

2. Copy the acronisaccess.cfg file and paste it in a safe location.

Vacuum the database before upgrading

1. Open the Files Advanced PostgreSQL Administrator tool (it could also be called PgAdmin). You can find it in Windows Start menu, under the Files Advanced folder. Double-click on localhost to connect to your server.
2. Right-click on the acronisaccess_production database and choose Maintenance.
3. Select the VACUUM radio button and the ANALYZE checkbox.

   

   Warning! If your database is very large, the vacuum can take some time. This process should be run during periods of low load on the server.

4. Press OK.
5. When the Vacuum process finishes, click Done.
6. Close the PostgreSQL Administrator tool.

Upgrade

1. Disable any anti-virus software you have or it may interrupt the installation procedure resulting in a failed installation.
2. Double-click on the installer executable.
   
3. Press Next to begin.

   Read and accept the license agreement.

4. Press Upgrade.
5. Review the components which will be installed and press Install.
6. Review the installed components and close the installer.
7. You will be prompted to open the Configuration Utility, press OK.
8. Verify that none of the settings in the Configuration Utility have changed. After you have verified all of your settings are as expected, press OK to close the Configuration Utility and start the Files Advanced services.