Goanywhere MFT Upgrade Guide Version 6.1.7 Copyright Terms and Conditions

GoAnywhere MFT Upgrade Guide Version 6.1.7 Copyright Terms and Conditions

The content in this document is protected by the Copyright Laws of the United States of America and other countries worldwide. The unauthorized use and/or duplication of this material without express and written permission from HelpSystems is strictly prohibited. Excerpts and links may be used, provided that full and clear credit is given to HelpSystems with appropriate and specific direction to the original content. HelpSystems and its trademarks are properties of the HelpSystems group of companies. All other marks are property of their respective owners. 201906251029 Table of Contents

Before You Begin 5 Backup External Database 5 6.0.0 Requires Java 8 Minimum 5 5.7.0 FIPS Certificate Requirements 5 Browser Compatibility 6 Upgrade Process 6 Post Upgrade Notes 6 Starting GoAnywhere MFT in Clustered Environments 6 Enable Schedules, Monitors, and Triggers 7 Changes to Resource Passwords 7 Changes to Key Locations 7 System Requirements 8 Windows Requirements 8 Linux/Unix Requirements 8 UNIX, AIX, HP-UX, Solaris Requirements 9 IBM i (iSeries) Requirements 9 Mac OS X 10 Download the Upgrade File 11 Upgrading the Java Virtual Machine (JRE) 12 Upgrading the External JRE 12 Upgrading the Embedded JRE (Windows) 13 Upgrading the Embedded JRE (Linux) 15 IBM i Java Upgrade Requirements 16 Windows Upgrade Instructions 18 Linux/UNIX Upgrade Instructions 20 IBM i Upgrade Instructions 21 Upgrading a Cluster Environment 23 Downgrading GoAnywhere MFT 24

GoAnywhere MFT User Guide www.goanywhere.com page: 3 Table of Contents

Downgrading GoAnywhere MFT on IBM i 25

page: 4 www.goanywhere.com GoAnywhere MFT User Guide Before You Begin This guide outlines the steps required for upgrading GoAnywhere MFT to the latest version.

n Check if there are any updates available for GoAnywhere MFT by logging in to its browser interface as a user with the Product Administrator role. From the main menu bar, point to Help and then click Check for Updates. The system checks for updates and provides you with further upgrade options. The Check for Update process provides guidance to upgrade GoAnywhere MFT to the latest version.

n Since GoAnywhere MFT must be restarted to apply the updates, it is important that you perform the upgrade process when no projects or file transfers are active in GoAnywhere MFT. Also, no other external processes must be running against the database that GoAnywhere is running on (such as a database backup).

n It is recommended that you clean up the temporary workspace by deleting the older files and subfolders from under the folder named [installfolder]/userdata/workspace. Backup External Database If you are using an external database, such as MySQL/MariaDB, SQL Server, Oracle, DB2 on IBM i, PostgreSQL, or Derby in network mode, you will want to ensure the database is backed up before you begin the upgrade.

NOTE: GoAnywhere MFT automatically backs up the embedded Derby database during the upgrade.

6.0.0 Requires Java 8 Minimum Your Java Virtual Machine must be upgraded to Java 8, and any prior versions of the bundled JRE must be removed before you can upgrade to GoAnywhere MFT 6.0.0. See the Upgrading the JAVA Virtual Machine topic for more information. GoAnywhere supports OpenJDK versions of Java provided by Oracle, IBM, and Azul. 5.7.0 FIPS Certificate Requirements If you are running GoAnywhere MFT in FIPS mode, be aware of the following considerations:

l If your Services are configured to use SSL, then you'll need to ensure that the certificates assigned to those Services use the RSA algorithm with a key size of 2048 or greater.

l When using the SFTP Service, Host Keys must be defined as RSA with a key size of 2048 or larger. Also note that FIPS mode does not support Enabled Cipher Algorithm 3des-cbc.

GoAnywhere MFT User Guide www.goanywhere.com page: 5 Before You Begin / Browser Compatibility

Browser Compatibility The GoAnywhere MFT Administrator and Web Client interface's require modern internet browsers that support HTML 5. Popular browsers are supported including Internet Explorer*, Chrome, Firefox and Safari. Please note that some HTML 5 advanced features, such as drag and drop, will not work in older versions of browsers. * GoAnywhere MFT supports Microsoft Internet Explorer 9, 10 and 11. Upgrade Process An upgrade script (program) is available which will perform all the necessary steps to upgrade GoAnywhere MFT. Download the latest upgrade script by visiting the GoAnywhere Customer Portal at my.goanywhere.com.

1. Verify you are upgraded to Java 8. 2. Verify you meet the minimum system requirements. 3. Obtain the correct upgrade file. 4. Follow the steps for the installed platform:

l Windows

l Linux/UNIX

l IBM i Post Upgrade Notes Starting GoAnywhere MFT in Clustered Environments All systems in the cluster must point to the same set of shared folders for storing documents, certificates and other user files. Participants in the cluster will not start if the Coordinator is configured to use relative paths. New shared folder locations were added during the upgrade from GoAnywhere Director or Services to GoAnywhere MFT 5.0.1. These folder locations must be configured to use a shared folder, even if you are not licensed for the feature that accesses these folders. The shared folder locations can be found in the GoAnywhere MFT Install Guide's "Setting up the First System in the Cluster"section.

page: 6 www.goanywhere.com GoAnywhere MFT User Guide Before You Begin / Post Upgrade Notes

Enable Schedules, Monitors, and Triggers In GoAnywhere MFT version 5.2.0 and later, Schedules, Monitors, and Trigger engines are now enabled from the Admin Server page in GoAnywhere. If you disabled the Scheduler, Monitors, or Triggers prior to upgrading from 5.1.x to a later version, you must enable them by navigating to System > Admin Server, and then click the Start button next to each engine.

Changes to Resource Passwords In GoAnywhere MFT version 5.4.0 and later, A new feature in GoAnywhere MFT 5.4.0 improves the ability for Admin Users with the Resource Manager Role to recover Resource passwords. For more information on this enhancement, open the Help within the GoAnywhere application and navigate to Resources > Recover Resource Passwords.

Changes to Key Locations In GoAnywhere MFT 5.6.0, an all new Key Management System was implemented to manage SSL certificates, SSH keys, and OpenPGP keys. Your existing keys will now be found in the legacy File Based Keys manager, which is located under the Encryption > File Based Keys menu. For more information, open the Help within the GoAnywhere application and navigate to the Encryption topic.

GoAnywhere MFT User Guide www.goanywhere.com page: 7 System Requirements You must meet the minimum system requirements before upgrading GoAnywhere MFT on your server. Windows Requirements

Operating Systems supported Windows Server 2008 R2®

Windows Server 2012®

Windows Server 2012 R2®

Windows Server 2016®

Windows Server 2019®

Windows Vista®

Windows 7®

Windows 8®

Disk space 300 MB for product (does not include user data) Memory 512 MB minimum Linux/Unix Requirements

Disk space 300 MB for product (does not include user data) Memory 512 MB minimum

GoAnywhere MFT User Guide www.goanywhere.com page: 8 System Requirements / UNIX, AIX, HP-UX, Solaris Requirements

UNIX, AIX, HP-UX, Solaris Requirements

Disk space 250 MB for product (does not include user data) Memory 512 MB minimum JRE (Java Runtime Environment) The following JREs can be used:

l OracleJava SE 8

l Azul Zulu Java SE 8

l IBM Java SE 8 IBM i (iSeries) Requirements Operating System IBM i V7R1 or higher Disk Space 250 MB for product (does not include user data) Memory 512 MB minimum

Required Licensed Programs The following IBM i licensed programs are prerequisites to the installation of GoAnywhere MFT, which are dependent on the IBM i release and your choice if supported Java version.

IBM i Release Licensed Program Product Description Option V7R1 5761JV1 (Only one option 16 Java SE 8 32 bit is required) 17 Java SE 8 64 bit 5770SS1 30 QShell 5770SS1 33 Portable App Solutions V7R2, V7R3 5770JV1 (Only one option 16 Java SE 8 32 bit is required) 17 Java SE 8 64 bit 5770SS1 30 QShell 5770SS1 33 Portable App Solutions Environment

page: 9 www.goanywhere.com GoAnywhere MFT User Guide System Requirements / Mac OS X

To check if the licensed programs (listed above) are installed on your IBM i, execute the command GO LICPGM and select option 10 to display the installed licensed programs. Press F11 twice from that screen to display the Product Options. If these licensed programs are not loaded on your IBM i, they may be available on the IBM software CDs that came with your IBM i. Otherwise, you will have to request those licensed programs from IBM, which are normally provided at no charge. Required PTFs The following IBM i Program Temporary Fixes (PTFs) and Group PTFs are prerequisites to installing GoAnywhere MFT.

V7R1 Group PTF SF99572 (minimum level of 23) V7R2 Group PTF SF99716 (minimum level of 8) V7R3 Group PTF SF99725

Use the command DSPPTF to verify that the required individual PTFs are applied. Use the command WRKPTFGRP to verify that the required group PTFs are applied. Mac OS X

Operating Systems supported Mac OS X Disk space 250 MB for product (does not include user data) Memory 512 MB minimum

GoAnywhere MFT User Guide www.goanywhere.com page: 10 Download the Upgrade File Visit the GoAnywhere Customer Portal to download software updates, check the status of a support case, and manage your GoAnywhere MFT license. You must create an account in order to use the portal. The portal can be accessed by using your internet browser and navigating to my.goanywhere.com Depending how old your current GoAnywhere MFT version is, you may need to repeat the upgrade process until you are upgraded to the current version of 6.1.7. The versions must be upgraded in the order listed below to maintain database integrity. For example, if you have GoAnywhere 6.0.1 currently installed, you would first download and upgrade to version 6.0.4 before upgrading to the latest released version.

NOTE: Your current installed version can be found by pointing to the Help menu and then clicking About.

Installed Version Upgrade Version 5.0.0 Upgrade to GoAnywhere MFT 5.0.1 using the ga_upgrade5_0_ 1.jar that is available on the Customer Portal. 5.0.1 - 6.0.3 Upgrade to GoAnywhere MFT 6.0.4 using the ga_upgrade6_0_ 4.jar that is available on the Customer Portal. 6.0.4 - 6.1.6 Upgrade to GoAnywhere MFT 6.1.7 using the ga_upgrade6_1_ 7.jar that is available on the Customer Portal.

GoAnywhere MFT User Guide www.goanywhere.com page: 11 Upgrading the Java Virtual Machine (JRE) GoAnywhere MFT 6.0.0 requires Java 8. GoAnywhere supports OpenJDK versions of Java provided by Oracle, IBM, and Azul. Depending on the operating system, GoAnywhere MFT may use a JRE that is bundled with the application or it may use an existing JRE which is already installed. Follow the steps below to determine which JRE is being used and then take the appropriate upgrade steps. Determine Java (JRE) version and Location

1. From the menu bar, point to Help, then click About. 2. In the About window, click the System Info tab. 3. On the System Info tab, verify the Java Version and the Java Home values.

l If the Java Home is configured to [INSTALL_DIR]/jre or [INSTALL_DIR]/jre6, you are using the embedded JRE. Use the Upgrade instructions below to upgrade your embedded JRE.

l If the Java Home is configured to any other directory, you are using an external JRE. Upgrade your external JRE to Java 8 or later.

Cleaning Up Existing Embedded JRE Folders Even if GoAnywhere MFT is using an external JRE, it is possible that an embedded JRE still exists within the application. If so, the upgrader may attempt to use the embedded JRE rather than the one used to start GoAnywhere. In order to prevent the upgrader from using the old embedded JRE, you must remove the [INSTALL_DIR]/jre folder, or rename the [INSTALL_DIR]/jre to something like [INSTALL_DIR]/jre.old. Upgrading the External JRE Follow your Java vendor's instructions to upgrade your External JRE. Once the JRE is upgraded to 8 or later, ensure the unlimited strength JCE policy files are installed and the Java execution environment is correct. Later versions of Java 8 include these files by default. Installing these files is only required if GoAnywhere MFT fails to start with an error indicating that the policy files are not installed. Use the following procedures if you are instructed to install the JCE policy files:

GoAnywhere MFT User Guide www.goanywhere.com page: 12 Upgrading the Java Virtual Machine (JRE) / Upgrading the Embedded JRE (Windows)

JCE Policy Files Before GoAnywhere MFT can be started or upgraded using the new JRE, it requires installation of the unlimited strength JCE policy files. To use the unlimited strength policy files, copy the US_ export_policy.jar file and the local_policy.jar file from the jce_policy_files/oracle/1_8 folder (located in the GoAnywhere MFT installation folder) to the jre/lib/security folder (located in the JRE's installation directory). For IBM platforms (e.g. AIX), copy the JCE policy files of US_export_policy.jar and local_policy.jar from the jce_policy_files/ibm folder (located under the GoAnywhere MFT installation folder) to the jre/lib/security folder (located under the JRE's installation directory). Changing JAVA_HOME For Linux The JAVA_HOME environment variable needs to be set to the appropriate location for Java 8. To set the Java version used to run GoAnywhere MFT on Linux, run the following command before executing the GoAnywhere MFT upgrade script. export JAVA_HOME='/path/to/jre'

'/path/to/jre' is the absolute path to the JRE, for example: '/usr/lib/jvm/jdk8/jre' Changing JAVA_Home For Windows The JAVA_HOME environment variable needs to be set to the appropriate location for Java 8. To set the Java version used to run GoAnywhere MFT on Windows, run the following command before executing the GoAnywhere MFT upgrade script.

1. Open the Control Panel and navigate to System And Security > System. 2. Click the Advanced system settings link. 3. On the Advanced tab, select Environment Variables, and then edit JAVA_HOME to point to where the JDK software is located, for example, C:\Program Files\Java\jdk8. Upgrading the Embedded JRE (Windows) Use the following instructions to upgrade the embeded Java version to 8 on Windows installations:

page: 13 www.goanywhere.com GoAnywhere MFT User Guide Upgrading the Java Virtual Machine (JRE) / Upgrading the Embedded JRE (Windows)

2. Download the appropriate JRE bundle. a. http://www.linomafiles.com/releases/goanywhere/jrebundles/windows-x86-1.8.0_ 131.zip b. http://www.linomafiles.com/releases/goanywhere/jrebundles/windows-x64-1.8.0_ 192.zip 3. Shut down GoAnywhere. 4. Navigate to the installation directory. By default, this is C:\Program Files\HelpSystems\GoAnywhere 5. Rename the old 'jre' folder to 'jre.old' 6. In some cases, this folder might be called 'jre6'. If so, rename this file to 'jre6.old'. If both 'jre' and 'jre6' folders exist, rename both folders. 7. Create a new 'jre' folder in the installation directory and copy the downloaded JRE bundle into that directory 8. Extract the contents of the JRE bundle into the current directory.

The result should look like this:

9. Start GoAnywhere. 10. Navigate to the Help > About page and verify Java has been upgrade to Java 8 or later.

GoAnywhere MFT User Guide www.goanywhere.com page: 14 Upgrading the Java Virtual Machine (JRE) / Upgrading the Embedded JRE (Linux)

11. You can now upgrade GoAnywhere to MFT 6.0.0.

Microsoft SQL Upgrade Consideration If you are using integrated authentication for Microsoft SQL with the backend database or as a database resource, you must copy the sqljdbc_auth.dll file from the old jre/bin folder to the new jre/bin directory. Failure to copy the file will prevent GoAnywhere from launching and the following error will be written to the stderr.log file: Caused by: java.lang.UnsatisfiedLinkError: no sqljdbc_auth in java.library.path Upgrading the Embedded JRE (Linux) Use the following instructions to upgrade the embedded Java to version 8 on Linux installations:

1. Determine the architecture of your GoAnywhere install. Log in to GoAnywhere and navigate to the Help> About page. Click on the System Properties tab and search for the property 'os.arch'. a. i386 indicates 32 bit architecture b. amd64 indicates 64 bit architecture 2. Download the appropriate JRE bundle. a. http://www.linomafiles.com/releases/goanywhere/jrebundles/linux-x86-1.8.0_131_ zulu.tar.gz b. http://www.linomafiles.com/releases/goanywhere/jrebundles/linux-x64-1.8.0_192_ zulu.tar.gz 3. Log in as the user account that owns the GoAnywhere installation directory and its contents. This is typically the same user account used to start and stop GoAnywhere. 4. Shut down GoAnywhere. 5. Navigate to the installation directory. For example, /usr/local/HelpSystems/GoAnywhere. 6. Rename the old 'jre' folder to 'jre.old' 7. In some cases, this folder might be called 'jre6'. If so, rename this file to 'jre6.old'. If both 'jre' and 'jre6' folders exist, rename both folders. 8. Create a new 'jre' folder in the installation directory and copy the downloaded JRE bundle into that directory. 9. Extract the contents of the JRE bundle into the current directory.

l $ gunzip linux-x86-8.tar.gz

l $ tar -xvf linux-x86-8.tar

The result should look like this:

page: 15 www.goanywhere.com GoAnywhere MFT User Guide Upgrading the Java Virtual Machine (JRE) / IBM i Java Upgrade Requirements

10. Start GoAnywhere. 11. Navigate to the Help > About page and verify Java has been upgrade to Java 8 or later. 12. You can now upgrade to GoAnywhere MFT 6.0.0. IBM i Java Upgrade Requirements Required PTFs The following Group PTFs are prerequisites to run GoAnywhere MFT 6.0.0 on Java 1.8. Use the command WRKPTFGRP to verify that the required group PTFs are applied.

IBM i Licensed Program Product Option Description Release V7R1 5761JV1 (Only one 16 Java SE 8 32 bit option is required) 17 Java SE 8 64 bit 5770SS1 30 QShell 5770SS1 33 Portable App Solutions V7R2, V7R3 5770JV1 (Only one 16 Java SE 8 32 bit option is required) 17 Java SE 8 64 bit 5770SS1 30 QShell 5770SS1 33 Portable App Solutions Environment

Changing Java Home

1. Stop the GoAnywhere MFT subsystem by executing the IBM i command of ENDGA. The ENDGA command is located in the installation library, which is named GOANYWHERE by default. Wait until the GoAnywhere MFT subsystem is completely shutdown before

GoAnywhere MFT User Guide www.goanywhere.com page: 16 Upgrading the Java Virtual Machine (JRE) / IBM i Java Upgrade Requirements

proceeding. 2. Run GOANYWHERE/CFGGA and select option 2 on Java Home and Java Version. 3. Change the Java Home value from /QOpenSys/QIBM/ProdData/JavaVM/jdk70/32bit to /QOpenSys/QIBM/ProdData/JavaVM/jdk80/32bit and then press ENTER to save. 4. Change the Java Version value from 1.7 to 1.8 and then press ENTER to save. 5. Run GOANYWHERE/CPYPOLICY to copy the JCE unlimited strength policy files into the JVM used by GoAnywhere MFT. 6. Start the GoAnywhere MFT subsystem by executing the IBM i command of STRGA. The STRGA command is located in the installation library, which is named GOANYWHERE by default. 7. Navigate to the Help > About page and verify Java has been upgrade to Java 8 or later. 8. You can now upgrade to GoAnywhere MFT 6.0.0.

page: 17 www.goanywhere.com GoAnywhere MFT User Guide Windows Upgrade Instructions

1. Rename the downloaded upgrade file to ga_upgrade.jar 2. Copy the downloaded upgrade file to [installfolder]\upgrader, where C:\Program Files\HelpSystems\GoAnywhere is the default installation directory of GoAnywhere MFT. 3. Sign into the GoAnywhere MFT browser-based Administrator and verify there are no active jobs or transfers before proceeding. 4. Login to the Windows system as an administrator. a. If the GoAnywhere MFT database is configured to run on Microsoft SQL Server with integrated security, you must login as the same user that runs the GoAnywhere Windows Service. The user can be identified by right-clicking on the GoAnywhere MFT service, select Properties, and then click the Log On tab. 5. Stop the GoAnywhere MFT service. a. From the Control Panel, open Administrative Tools and then click Services. b. In the Services window, right-click the GoAnywhere service and select Stop. 6. Check the [installfolder]/tomcat/logs folder for stdout_[date].log and stderr_[date].log files. Remove all but the most recent files based on the date appended to each log file. 7. If the GoAnywhere MFT database is configured to run on a database other than the embedded Derby database, make a backup of that external database before continuing. 8. Open a Command Prompt window and change the directory to [installfolder]\upgrader.

NOTE: You must run the Command Prompt window as administrator to run the Upgrade.bat file.

9. Run the upgrade.bat file to start the upgrade process. When complete, a message indicates the upgrade was successful. 10. Start the GoAnywhere MFT service. a. From the Control Panel, open Administrative Tools and then click Services. b. In the Services window, right-click the GoAnywhere service and select Start. Within seconds after starting the GoAnywhere MFT service, its status should be updated to “Running”.

GoAnywhere MFT User Guide www.goanywhere.com page: 18 Windows Upgrade Instructions /

11. Before logging into the upgraded version of GoAnywhere MFT, each user should press CTRL + F5 from their browser to clear the cache.

page: 19 www.goanywhere.com GoAnywhere MFT User Guide Linux/UNIX Upgrade Instructions

1. Rename the downloaded upgrade file to ga_upgrade.jar 2. Copy the downloaded upgrade file to [installfolder]/upgrader, where /usr/local/HelpSystems/GoAnywhere is the default installation directory of GoAnywhere MFT. 3. Sign into the GoAnywhere MFT browser-based Administrator and verify there are no active jobs or transfers before proceeding. 4. Login to the system as the same user profile used to start GoAnywhere MFT and open a terminal window. 5. Stop the GoAnywhere MFT service: a. Change the working directory to the directory where GoAnywhere MFT is installed. For example: cd /usr/local/HelpSystems/GoAnywhere b. Stop the GoAnywhere MFT application server by executing the following bash shell script: ./goanywhere.sh stop 6. Check the size on the [installfolder]/tomcat/logs/catalina.out file. If it is larger than 5 megabytes, rename the file and move it to a different folder outside the [installfolder] location. 7. If the GoAnywhere MFT database is configured to run on a database other than the embedded Derby database, make a backup of that external database before continuing. 8. Change the directory to [installfolder]/upgrader. 9. Run the upgrade.sh file to start the upgrade process. a. Change the directory to [installfolder]/upgrader. b. Start the upgrade by executing the following bash shell script: sudo ./upgrade.sh When complete, a message indicates the upgrade was successful. 10. Start the GoAnywhere MFT service: a. Change the working directory to the directory where GoAnywhere MFT is installed. For example: cd /usr/local/HelpSystems/GoAnywhere b. Start the GoAnywhere MFT application server by executing the following bash shell script: ./goanywhere.sh start 11. Before logging into the upgraded version of GoAnywhere MFT, each user should press CTRL + F5 from their browser to clear the cache.

GoAnywhere MFT User Guide www.goanywhere.com page: 20 IBM i Upgrade Instructions Before you Begin

l If using an external database (DB2), the database user profile must have the *ALLOBJ authority to make changes to the database during the upgrade.

l In some cases, the upgrade may remove columns from tables in the external database. The *USE authority must be given to ADDRPYLE and RMVRPYLE commands to complete this change.

l If you are using an external GoAnywhere Database Library, it is highly recommended that you disable any High Availability (HA) software prior to starting the upgrade. HA software similar to Mimix, Itera, Maxava, etc. has been known to lock tables during an upgrade causing the upgrade to fail when a table is affected by consecutive operations. To determine if you are using an external Database Library, login to GoAnywhere MFT and navigate to System > Database Configuration and review the Database driver and URL information. Contact your system or HA software administrator to ensure this process has been disabled.

Upgrade IBM i

1. Rename the downloaded upgrade file to ga_upgrade.jar. 2. Copy the downloaded upgrade file to [installfolder]/upgrader on the IFS, where /HelpSystems/goanywhere/ is the default installation directory of GoAnywhere MFT. If GoAnywhere MFT is installed in a different directory, substitute with that directory. 3. Sign into the GoAnywhere MFT browser-based Administrator and verify there are no active jobs or transfers before proceeding. 4. Sign on to an IBM i session with the QSECOFR user profile or with a profile that has *ALLOBJ authority.

5. Stop the GoAnywhere MFT subsystem by executing the IBM i command of ENDGA. The ENDGA command is located in the installation library, which is named GOANYWHERE by default. Wait until the GoAnywhere MFT subsystem is completely shutdown before proceeding. 6. Verify there are no locks on the GoAnywhere MFT installation library or objects. Do not proceed with the upgrade until all locks are released. Run the following command to check for locks (assuming GOANYWHERE is the install library): WRKOBJLCK OBJ(GOANYWHERE) OBJTYPE(*LIB) 7. If you have externalized your GoAnywhere database to IBM i DB2, use the WRKOBJLCK command to check for any locks on the database objects. 8. Check the size on the [installfolder]/tomcat/logs/catalina.out file. If it is larger than 5 megabytes, rename the file and move it to a different folder outside the [installfolder] location.

GoAnywhere MFT User Guide www.goanywhere.com page: 21 IBM i Upgrade Instructions /

9. Run the SAVPRD command in the installation library. This saves the installation library to a save file, saves the matching folder to a save file, then saves both of those to a third save file, the name and location of which will be requested when you prompt the SAVPRD command. Specify a location to save the file in a library outside the installation library. 10. If the GoAnywhere MFT database is configured to run on a database other than the embedded Derby database, make a backup of that external database before continuing. The SAVPRD can be used to backup the external database library when running on DB2/400. Other database types require a manual backup. 11. Apply the upgrade by executing the UPGRADEGA command. The UPGRADEGA command is located in the installation library, which is named GOANYWHERE by default. 12. The user profile starting the subsystem must have *RWX permission to the GoAnywhere MFT installation folder and the entire directory tree. On V7R1 and later, a command is provided to change the authority on an entire directory tree. In this example '/HelpSystems/goanywhere' is the installation directory and PGUSER will be the user profile that will be starting the subsystem. CHGAUT OBJ('/HelpSystems/goanywhere') USER(PGUSER) DTAAUT (*RWX) OBJAUT(*ALL) SUBTREE(*ALL) 13. Start the GoAnywhere MFT subsystem by executing the IBM i command of STRGA. The STRGA command is located in the installation library, which is named GOANYWHERE by default. 14. Before logging into the upgraded version of GoAnywhere MFT, each user should press CTRL + F5 from their browser to clear the cache.

page: 22 www.goanywhere.com GoAnywhere MFT User Guide Upgrading a Cluster Environment The following steps will ensure a successful upgrade when upgrading GoAnywhere MFT in a cluster environment. The whole cluster must be brought down during the upgrade as the first system upgraded will make core changes to the external shared database. When planning for downtime during the upgrade, you will only be down for the time it takes to upgrade the coordinator (first system).

1. Bring down all GoAnywhere MFT instances in the cluster. 2. Run the upgrade process for your specific operating system on a server in the cluster. During this upgrade, all required changes are made to the shared database.

l Windows Upgrade Instructions

l Linux/Unix Upgrade Instructions

l IBM i Upgrade Instructions

NOTE: After the first upgraded server has made the required changes to the shared database, each additional server will detect the updated database and only update its file system with the necessary changes.

3. Start the GoAnywhere MFT subsystem or service on the server after it is upgraded.

l If this is the first server to be upgraded, it will assume the coordinator role.

l If this is not the first server to be upgraded, verify the server has joined the cluster. 4. Repeat steps 2 and 3 for each additional server in the cluster.

GoAnywhere MFT User Guide www.goanywhere.com page: 23 Downgrading GoAnywhere MFT When an upgrade is performed, the upgrade process makes a backup of folders and files that are changed during upgrade. These files are placed in [installfolder]/backups/backup_[fromVersion]_ [toVersion] (where [installfolder] is the location where GoAnywhere MFT is installed). The backup folder names contain the existing and new version numbers of GoAnywhere. For example, the 'backup_543_to_552' folder contains the files that were backed up when GoAnywhere MFT was upgraded from version 5.4.3 to version 5.5.2.

NOTE: If the upgrade fails before the backup directory is successfully created, then no changes will be made and you can restart GoAnywhere MFT.

The upgrade creates an upgrade log, which displays the location of the backup folder. Example of the upgrade log:

Installed Version: 5.5.2 Upgrading to: 5.5.9 Checking the server status... GoAnywhere Server appears to be down. Okay to upgrade. Backing up currently installed files Created the base backups directory: C:\Program Files\HelpSystems\GoAnywhere\backups Created the backup directory: C:\Program Files\HelpSystemsSoftware\GoAnywhere\backups\backup_552_to_559

If you choose to downgrade GoAnywhere MFT, any changes to projects, resources, or any other GoAnywhere MFT configuration settings made after the upgrade will be lost when the rollback is performed. The rollback returns GoAnywhere MFT to the state it was just before the upgrade was performed. If the new version of GoAnywhere MFT is deemed unfit, a rollback can be performed using the following steps:

1. Stop the GoAnywhere subsystem or service. 2. Make a copy of the [installfolder] for archive purposes. 3. To ensure no library conflicts are introduced during the rollback, delete the contents of [installfolder]/lib. 4. Navigate to the backup folder and copy the contents of each folder to the folder with the same name located in your install directory.

EXAMPLE: If the backup_543_552 folder contains a tomcat directory, copy the contents of the /backup_543_552/tomcat folder to the [InstallDirectory]/tomcat folder. Repeat this step for each file and folder found in the backup directory.

GoAnywhere MFT User Guide www.goanywhere.com page: 24 Downgrading GoAnywhere MFT / Downgrading GoAnywhere MFT on IBM i

l If you are using the embedded Derby database, the database backup will be made to [backup_dir]/userdata/database. To restore the embedded Derby database, remove the derby database by removing the [install_dir]/userdata/database/goanywhere folder, and replacing it with the [backup_dir]/userdata/database/goanywhere folder. 5. If using an external database (MySQL/MariaDB, SQL Server, Oracle, DB2 on IBM i, PostgreSQL, or Derby in network mode) restore that database to the backup made just prior to upgrading GoAnywhere MFT. 6. On IBM i, you must also restore the save files created by the SAVPRD command that was used to install or upgrade GoAnywhere. The first file is named GOANYWHERE. The second file is typically named GADATA. The second file is required if GoAnywhere is using the external DB2 database. Further instructions for IBM i are provided below. 7. Ensure the user profile used to start GoAnywhere has ownership authority to the restored files. On IBM i and Unix/Linux systems, ensure the user profile used to start GoAnywhere has execute permission to all shell scripts (*.sh). 8. Navigate to the [installfolder]/tomcat/work folder and delete all files present in that folder. 9. Start the GoAnywhere MFT subsystem or service. Downgrading GoAnywhere MFT on IBM i

When upgrading GoAnywhere on an IBM i, you were instructed to run the SAVPRD command which saves the installation library. The library specified in the SAVPRD step is where the save file (*SAVF) is located. This save file contains 2-3 save files, containing the GoAnywhere library, The GoAnywhere IFS folder, and (if it exists) the GADATA library.

Example of the SAVPRD screen, prior to the upgrade:

1. Rename the existing GOANYWHERE library and IFS Folder. The folder is located in either the /Linoma or /Helpsystems directory on the IFS. This will preserve the libraries and check for necessary authority. Ensure these libraries are renamed before moving to the next step.

NOTE: If you have an IBM i data library (GADATA), you will need to save the library and delete

page: 25 www.goanywhere.com GoAnywhere MFT User Guide Downgrading GoAnywhere MFT / Downgrading GoAnywhere MFT on IBM i

it because of journaling.

2. To confirm the names of the primary save files, use the command DSPSAVF mylibrary/gamftsavf (use the actual library and file name specified when the SAVPRD command was run). The following image illustrates the results of the command:

3. Restore the temporary save files using the following command:

RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF([mylibrary]/[gamftsavf]). You should see the message “3 Objects Restored…”

4. If using the DB2 Database Library, use this command. Note: If downgrading GA Services, the SAVLIB would be GASDATA. RSTLIB SAVLIB(GADATA) DEV(*SAVF) SAVF(QTEMP/SDATAGA)

5. Restore the IFS Folder.

RST DEV('/qsys.lib/qtemp.lib/sifsga.file') OBJ(('/helpsystems/goanywhere'))

6. Finally, restore the GoAnywhere program library. Note: If downgrading GA Services, the SAVLIB would be GASERVICES. RSTLIB SAVLIB(GOANYWHERE) DEV(*SAVF) SAVF(QTEMP/SLIBGA)

GoAnywhere MFT User Guide www.goanywhere.com page: 26