Goanywhere MFT Upgrade Guide
Total Page:16
File Type:pdf, Size:1020Kb
GoAnywhere MFT Upgrade Guide Version: 5.4.1 Publication Date: 12/09/2016 Copyright © 2016 Linoma Software. All rights reserved. Information in this document is subject to change without notice. The software described in this document is furnished under a license agreement and may be used only in accordance with the terms of that agreement. No part of this publication may be reproduced, stored in a retrieval system, or transmitted in any form or any means electronic or mechanical, including photocopying and recording for any purpose other than the purchaser's personal use without the written permission of Linoma Software. GoAnywhere ® is a registered trademark of Linoma Software, a HelpSystems company. Linoma Software 103 South 14th Street Ashland, NE 68003 United States GoAnywhere MFT Upgrade Guide www.GoAnywhere.com 2 Contents Before You Begin 4 5.3.0 Requires Java 7 Minimum 4 Browser Compatibility 4 Upgrade Process 4 Post Upgrade Notes 5 Starting GoAnywhere MFT in Clustered Environments 5 Enable Schedules, Monitors, and Triggers 5 Changes to Resource Passwords 5 System Requirements 6 Windows Requirements 6 Linux/Unix Requirements 6 IBM i (iSeries) Requirements 6 Download the Upgrade File 8 Upgrading the Java Virtual Machine (JRE) 9 Upgrading the External JRE 9 Upgrading the Embedded JRE (Windows) 10 Upgrading the Embedded JRE (Linux) 12 IBMi Java Upgrade Requirements 13 Windows Upgrade Instructions 14 Linux/UNIX Upgrade Instructions 16 IBM i Upgrade Instructions 17 Upgrading a Cluster Environment 18 Downgrading GoAnywhere MFT 19 About Linoma Software 21 Contacting Linoma Software 21 GoAnywhere MFT Upgrade Guide www.GoAnywhere.com 3 Before You Begin 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. 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. 5.3.0 Requires Java 7 Minimum Your Java Virtual Machine must be upgraded to Java 7 or later, and any prior versions of the bundled JRE must be removed before you can upgrade to GoAnywhere MFT 5.3.0. See the Upgrading the JAVA Virtual Machine topic for more information. 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 1.7.0 or later. 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 GoAnywhere MFT Upgrade Guide www.GoAnywhere.com 4 Post Upgrade Notes 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. 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 GoAnyhwere. 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. GoAnywhere MFT Upgrade Guide www.GoAnywhere.com 5 System Requirements System Requirements You must meet the minimum system requirements before upgrading GoAnywhere MFT on your server. Windows Requirements Operating Systems supported Windows Server 2003® Windows Server 2008 R2® Windows Server 2012® Windows Server 2012 R2® Windows Server 2016® Windows XP® 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 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. GoAnywhere MFT Upgrade Guide www.GoAnywhere.com 6 IBM i (iSeries) Requirements IBM i Release Licensed Program Product Option Description V7R1 5761JV1 14 Java SE 7 32 bit (Only one option is required) 15 Java SE 7 64 bit 16 Java SE 8 32 bit 17 Java SE 8 64 bit 5770SS1 30 QShell 5770SS1 33 Portable App Solutions Environment V7R2, V7R3 5770JV1 14 Java SE 7 32 bit (Only one option is required) 15 Java SE 7 64 bit 16 Java SE 8 32 bit 17 Java SE 8 64 bit 5770SS1 30 QShell 5770SS1 33 Portable App Solutions Environment 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. GoAnywhere MFT Upgrade Guide www.GoAnywhere.com 7 Download the Upgrade File Download the Upgrade File The GoAnywhere Customer Portal is where you can create support requests, check the status of a support case, download software updates and documentation, 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 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-5.4.0 Upgrade to GoAnywhere MFT 5.4.1 using the ga_upgrade5_4_1.jar that is available on the Customer Portal. 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 5.4.1. The versions must be upgraded in the order listed below to maintain database integrity. Your current installed version can be found by pointing to the Help menu and then clicking About. GoAnywhere MFT Upgrade Guide www.GoAnywhere.com 8 Upgrading the Java Virtual Machine (JRE) Upgrading the Java Virtual Machine (JRE) GoAnywhere MFT 5.3.0 requires Java 1.7.0 or later. 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. If GoAnywhere MFT is using JRE version 1.8, it must be at least 1.8.0_45. 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.