Ga4 5 0 Installation Guide

Installation and Administration Guide
Product Version: Publication date: 4.5.0 7/9/2013
Copyright 2007-2013, LINOMA SOFTWARE LINOMA SOFTWARE is a division of LINOMA GROUP, Inc.
GoAnywhere Director - Installation and Administration Guide
Table of Contents
Introduction ................................................................................................................... 4
GoAnywhere Features ......................................................................................................................... 5
How GoAnywhere Works .............................................................................................. 6

Administration ...................................................................................................................................... 6 Execution ............................................................................................................................................. 7
Installation Windows.................................................................................................. 8
Requirements ...................................................................................................................................... 8 Installing GoAnywhere on Windows ..................................................................................................... 8
Installation Linux ........................................................................................................ 9

Requirements ...................................................................................................................................... 9 Installing GoAnywhere on Linux ........................................................................................................... 9
Installation UNIX, AIX, HP-UX, Solaris .................................................................... 10

Requirements .................................................................................................................................... 10 Installing GoAnywhere ....................................................................................................................... 10
Installation IBM i (iSeries) ........................................................................................ 12

Requirements .................................................................................................................................... 12 Required licensed programs ........................................................................................................... 12 Required PTFs ............................................................................................................................... 13 IBM i components installed................................................................................................................. 13 Installing GoAnywhere on IBM i.......................................................................................................... 14
Initial Configuration .................................................................................................... 17 Customizing Installation Settings .............................................................................. 20

Changing GoAnywhere Port Numbers ................................................................................................ 20 Changing ports using the browser interface .................................................................................... 20 Changing ports using the CFGGA command on IBM i ..................................................................... 20 Changing ports by manually editing the configuration file ................................................................ 20 Disabling HTTP or HTTPS Connectors............................................................................................... 21 SSL (HTTPS) Configuration ............................................................................................................... 22 Memory Allocation ............................................................................................................................. 23
Product Administration .............................................................................................. 24

Starting and Stopping GoAnywhere.................................................................................................... 24 Windows instructions ...................................................................................................................... 24 Linux, UNIX, HP-UX and Solaris instructions................................................................................... 24 IBM i (iSeries) instructions .............................................................................................................. 24 Upgrading GoAnywhere ..................................................................................................................... 25 Configuring HTTP Proxy ................................................................................................................. 25 Upgrade instructions ....................................................................................................................... 25
Version 4.5.0
Linoma Software
Page 2
Active-Passive: Backups and Replication ................................................................ 26

Backing up GoAnywhere User Data ................................................................................................... 26 Automatically Backing Up the GoAnywhere Database (to Disk) .......................................................... 27 Manually Backing Up the GoAnywhere Database (to Disk) ................................................................. 28 IBM i Backup and Recovery ............................................................................................................... 29 Replicating GoAnywhere User Data (for High Availability) .................................................................. 30 Replication ..................................................................................................................................... 30 Failover .......................................................................................................................................... 30
Active-Active: Clustering and Automatic Failover ................................................... 32

Setting up the First System in the Cluster ........................................................................................... 33 Setting up Additional Participant Systems in the Cluster ................................................................... 35 Troubleshooting Errors....................................................................................................................... 35 Clustering Failover ............................................................................................................................. 36 Backups ............................................................................................................................................. 36
GoAnywhere IBM i Commands .................................................................................. 37

Command Summary .......................................................................................................................... 37 Accessing Main Menu ........................................................................................................................ 38 SFTP, OpenPGP, ZIP and Email Command Shortcuts ....................................................................... 38
Uninstalling GoAnywhere Product ............................................................................ 39

Windows uninstall instructions............................................................................................................ 39 Linux, UNIX, HP-UX and Solaris uninstall instructions ........................................................................ 39 IBM i uninstall instructions .................................................................................................................. 39
License agreement and limited warranty .................................................................. 40 Contacting Linoma Software ...................................................................................... 41
Version 4.5.0
Linoma Software
Page 3
Introduction
GoAnywhere Director is a managed file transfer solution that will automate and secure the exchange of data with your customers, trading partners and enterprise servers. It can connect to almost any system (internal or external) using standard file transfer protocols. GoAnywhere Director provides a single point of control with multi-step workflow abilities, management controls and audit trails.
GoAnywhere Director's intuitive interface and comprehensive features will help you to eliminate the need for custom programs/scripts, single-function tools and manual processes which were traditionally required for moving and translating data. This innovative solution will reduce costs, improve the quality of your data transmissions and help your organization to comply with data security policies and regulations.
Version 4.5.0
Linoma Software
Page 4
GoAnywhere Features
Listed below is a summary of the features in GoAnywhere Director: Automates and simplifies FTP (File Transfer Protocol) processes Connects to secure FTP servers (SFTP, FTPS, SCP) for protected communications Guarantees delivery with connection retries and file auto-resume (for interrupted transfers) Exchanges files with web servers using HTTP, HTTPS and Web Services Sends AS2 messages with support for multiple file attachments Monitors folders with options to scan for new, changed or deleted files Accesses files and directories on network shares with support for UNC, SMB and CIFS Encrypts, signs and decrypts files using the Open PGP encryption standard Provides FIPS 140-2 compliance mode to meet U.S. Government (NIST) encryption standards Highly scalable with support for clustering and active-active failover Compresses and decompresses files using the ZIP, GZIP and TAR standards Connects to popular database servers including DB2, DB2/400, SQL Server, Oracle, Informix, MySQL, PostgreSQL and Sybase Translates data to/from database tables, Excel, XML, Delimited text and Fixed Width file formats Replicates data between database servers Connects to enterprise messaging systems including Websphere MQ, SonicMQ, ActiveMQ and SwiftMQ Sends and retrieves files via E-mail and secure E-mail Calls customer programs and scripts as part of business process workflows Allows for remote administration and monitoring through an intuitive browser interface Provides an integrated scheduler for running transfers at future dates/times Includes commands and APIs for launching transfers from remote systems and applications Produces detailed audit trails with comprehensive reporting Optionally sends logs to an enterprise SYSLOG server Sends email alerts and text messages for failed and completed transfers Includes integrated Key Management tools for Open PGP keys, SSH keys and SSL/TLS certificates
Please note that GoAnywhere Director will be referred to as simply GoAnywhere throughout the remainder of this documentation.
Version 4.5.0
Linoma Software
Page 5
How GoAnywhere Works

Administration
Authorized users can utilize GoAnywheres web-based Administrator to perform configuration and monitoring within the product. The following primary functions are available within the Administrator: Configure global settings for GoAnywhere Set up and manage users, user groups and their authorities (Roles) within GoAnywhere Set up and maintain the connections to the servers which you want to exchange data with (i.e. database servers, FTP/SFTP/FTPS servers, HTTP servers, mail servers, etc.) Set up Keys and Certificates for any encryption requirements Define Projects of the work to be performed (i.e. data transfers, data conversions, file encryption, compression, etc.) Execute Projects interactively or in batch Schedule Projects to run at future dates and times Monitor actively running Projects View the logs (audit trails) of completed Projects Listed below is a screen example of the main GoAnywhere Administrator page (the Dashboard):
Version 4.5.0
Linoma Software
Page 6
Execution
The GoAnywhere product can be installed onto Windows, Linux, IBM i (iSeries), IBM System p (AIX), Unix, HP-UX, Mac OS X and Solaris operating systems. To serve the enterprise needs, GoAnywheres multi-threaded architecture allows it to be scaled to process large volumes of concurrent transfers and other work flows. Within GoAnywhere's browser-based Administrator, authorized users can execute business processes and transfers (Projects) immediately with a click of the mouse. Projects can also be scheduled to run at future dates and times using GoAnywhere's built-in Scheduler. Projects can additionally be called from local and remote command lines, scripts, programs and external schedulers using the provided commands and program APIs. These commands and APIs are available for Windows, Linux, IBM i, Unix, AIX, HP-UX and Solaris platforms.
Version 4.5.0
Linoma Software
Page 7
Installation Windows
GoAnywhere can be installed onto a Windows server for enterprise usage. GoAnywhere can also be installed onto Windows desktops or laptops, which is useful for individual development and testing purposes. Both 32-bit and 64-bit versions of Windows are supported. A Windows installation wizard is provided for GoAnywhere which installs the product files into the directory of your choice. GoAnywhere will be implemented as a Windows Service which will automatically start (by default) when Windows starts.
Requirements
- Operating Systems supported: Windows Server 2003 Windows Server 2008 R2 Windows Server 2012 Windows XP Windows Vista Windows 7 200 MB for product (does not include user data) 512 MB minimum
- Disk Space: - Memory:
Installing GoAnywhere on Windows

Perform the following steps to install the GoAnywhere product onto a Windows machine. 1. Login to the target Windows system as an administrator. 2. Download the GoAnywhere Windows installer .EXE file from the URL provided by Linoma Software. Note: If you have a 64-bit operating system, make sure to download the 64-bit version. 3. Execute the downloaded .EXE file and follow the prompts on the screens. 4. If you did not choose to start the GoAnywhere application server within the installer, then you can manually start this server by following these instructions: a. Go to Control Panel -> Administrative tools -> Services. b. In the Services window, right-click on the GoAnywhere service and select Start. c. Within seconds after starting the GoAnywhere service, its status should be updated to Started. If not, please contact Linoma Software technical support. 5. The installation and startup of GoAnywhere is complete. Now you should proceed to the Initial Configuration instructions on page 17.
Note: The GoAnywhere server is configured in Windows as an automatic startup Service. This means that the GoAnywhere server will automatically start whenever Windows starts.
Version 4.5.0
Linoma Software
Page 8
Installation Linux
GoAnywhere can be installed onto a Linux server for enterprise usage. GoAnywhere can also be installed onto Linux desktops or laptops, which is useful for individual development and testing purposes. Both 32-bit and 64-bit versions of Linux are supported. A Linux installation wizard is provided for GoAnywhere which installs the product files into the directory of your choice.
Requirements
- Disk Space: 200 MB for product (does not include user data) - Memory: 512 MB minimum
Installing GoAnywhere on Linux

Perform the following steps to install the GoAnywhere product onto a Linux system. 1. Login to the target Linux system as root. 2. Download the GoAnywhere Linux installer file from the URL provided by Linoma Software. 3. If you have a graphical desktop for Linux, execute the downloaded installer file and follow the prompts on the screens. Otherwise, execute the downloaded installer file with a c option (e.g. installer_filename.sh -c) and follow the prompts. 4. Start the GoAnywhere application server by following these instructions: a. Open a Terminal window. b. Change the working directory to the directory where GoAnywhere was installed (for example, cd /usr/local/Linoma_Software/GoAnywhere) c. Start the GoAnywhere application server by executing the following shell script: ./goanywhere.sh start 5. The installation and startup of GoAnywhere is complete. Now you should proceed to the Initial Configuration instructions on page 17.
Tip: You can setup GoAnywhere as a service so it starts automatically when the Linux system is booted. Please refer to your operating system manual for more details on setting up services. You should be able to execute goanywhere.sh from your startup scripts.
Version 4.5.0
Linoma Software
Page 9
Installation UNIX, AIX, HP-UX, Solaris

GoAnywhere can be installed onto a server for enterprise usage. This page includes installation instructions for UNIX, Solaris (SPARC and Intel), AIX and HP-UX servers. An installation wizard is provided for GoAnywhere which installs the product files into the directory of your choice.
Requirements
- Disk Space: - Memory: 125 MB for product (does not include user data) 512 MB minimum
- JRE (Java Runtime Environment) 1.6.0 or higher.
Installing GoAnywhere
Perform the following steps to install the GoAnywhere product onto a UNIX, Solaris (SPARC and Intel), AIX or HP-UX server. 1. Login to the server as root. 2. Download the GoAnywhere UNIX installer file from the URL provided by Linoma Software. 3. Open a Terminal window 4. Change the directory to where the installer file was downloaded (e.g. cd /root/Desktop) 5. If needed, set the Executable bit on the file (e.g. chmod 755 ga3_0_0_unix.sh) 6. Run the installer (e.g. ./ga3_0_0_unix.sh) 7. The installer will attempt to find a compatible JRE (Java Runtime Environment) for the installation process. Follow the steps below if the installer cannot find a compatible JRE: a. Define an environment variable named "INSTALL4J_JAVA_HOME" to point to the home directory of the JRE (e.g. export INSTALL4J_JAVA_HOME=/usr/lib/jvm/java-1.6.0-sun/jre). b. Clear the Installer cache by removing the file named ".install4j" from your home directory (e.g. rm /root/.install4j). c. Run the installer again (e.g. ./ga3_0_0_unix.sh). 8. Follow the on-screen instructions to complete the installation. 9. JCE policy files must be copied to the JREs (Java Runtime Environment) security folder in order to support encryption functions in GoAnywhere: 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 installation folder) to the jre/lib/security folder (located under the JRE's installation directory). For all other platforms (e.g. Solaris), copy the JCE policy files of US_export_policy.jar and local_policy.jar from the jce_policy_files/sun folder (located under the GoAnywhere installation folder) to the jre/lib/security folder (located under the JRE's installation directory).
(continued on next page)
Version 4.5.0
Linoma Software
Page 10
10. Start the GoAnywhere application server by following these instructions: a. Open a Terminal window. b. Change the working directory to the directory where GoAnywhere is installed (for example, cd /usr/local/Linoma_Software/GoAnywhere) c. Start the GoAnywhere application server by executing the following shell script: ./goanywhere.sh start. d. If you receive an error indicating that no JRE could be found, set an environment variable named "JAVA_HOME" to point to the JREs home directory (e.g. export JAVA_HOME=/usr/lib/jvm/java-1.6.0-sun/jre) and try starting GoAnywhere again. 11. The installation and startup of GoAnywhere is complete. Now you should proceed to the Initial Configuration instructions on page 17.
Tip: You can setup GoAnywhere as a service so it starts automatically when the system is booted. Please refer to your operating system manual for more details on setting up services. You should be able to execute goanywhere.sh from your startup scripts.
Version 4.5.0
Linoma Software
Page 11
Installation IBM i (iSeries)

GoAnywhere can be installed on IBM i systems which meet the following requirements.
Requirements
Operating System: Disk space: Memory: i5/OS V5R4 or higher 125 MB for product (does not include user data) 512 MB minimum
Required licensed programs

The following IBM i licensed programs are prerequisites to the installation of GoAnywhere, which are dependent on i5/OS release. Licensed Program 5722JV1 5722SS1 5722SS1 5761JV1 5761SS1 5761SS1 5761JV1 5770SS1 5770SS1 Product Option 11 30 33 11 30 33 11 30 33
i5/OS Release V5R4
Description Java SE 6 32 bit QShell Portable App Solutions Environment Java SE 6 32 bit QShell Portable App Solutions Environment Java SE 6 32 bit QShell Portable App Solutions Environment
V6R1
V7R1
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. (continued on next page)
Version 4.5.0
Linoma Software
Page 12
Required PTFs
The following IBM i Program Temporary Fixes (PTFs) and Group PTFs are prerequisites to installing GoAnywhere. V5R4 V6R1 V7R1 Group PTF Group PTF Group PTF SF99291 (minimum level of 17) SF99562 (minimum level of 23) SF99572 (minimum level of 12)
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.
IBM i components installed

The following components will be installed onto the IBM i by the GoAnywhere installation process: A library will be created, which will contain the GoAnywhere commands and program objects. The default library name is GOANYWHERE, which can be changed during installation. An IFS folder will be created, which will contain the GoAnywhere software components. The default IFS folder name is /linoma/goanywhere, which can be changed during installation. The policy files named US_export_policy.jar and local_policy.jar will be installed into the security directory of the Java Development Kit (JDK). These policy files are used to support encryption functions in GoAnywhere. The directory is "QOpenSys/QIBM/ProdData/JavaVM/jdk60/32bit/jre/lib/security"
Version 4.5.0
Linoma Software
Page 13
Installing GoAnywhere on IBM i

Perform the following steps to install the GoAnywhere product onto the IBM i. 1. Sign on to the IBM i with the QSECOFR user profile OR with a profile which has *ALLOBJ authority. 2. Create a temporary Save file on your IBM i by executing the following i5/OS command: CRTSAVF FILE(QGPL/GOANYWHERE) 3. The GoAnywhere software needs to be uploaded to your IBM i using FTP. Before proceeding, make sure the FTP server is running on the IBM i. To start the FTP server on the IBM i, you can issue the i5/OS command of STRTCPSVR SERVER(*FTP) 4. Download the GoAnywhere installer (for IBM i) from the URL provided by Linoma Software. 5. Extract the files from the installer ZIP file into a new temporary folder on your workstation. One of the extracted files will be named GOANYWHERE.SAVF. 6. FTP the extracted GOANYWHERE.SAVF file from your PC to the Save file on the IBM i (that was created in step 2). Listed below are instructions for a Windows user: Open a DOS window. Enter the DOS command FTP <hostname>, where <hostname> is the host name or IP address of your IBM i. Login with your i5/OS user id and password, then enter the following highlighted FTP commands: ftp> BINARY ftp> LCD \<tempdir> ftp> CD qgpl ftp> PUT goanywhere.savf goanywhere ftp> QUIT (switches the FTP session to binary mode) (<tempdir> is the PC directory containing the file named goanywhere.savf) (changes the remote directory to the QGPL library) (sends the PC file goanywhere.savf to the IBM i Save file named GOANYWHERE) (ends your FTP session)
7. Restore the installation objects into QTEMP by executing the following i5/OS command: RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/GOANYWHERE) 8. Delete the temporary Save file by executing the following i5/OS command (optional): DLTF FILE(QGPL/GOANYWHERE) 9. If QTEMP library is not in your library list, then add it by executing the following i5/OS command: ADDLIBLE LIB(QTEMP) POSITION(*FIRST) 10. Prompt (F4) the command QTEMP/INSTALLGA for installing GoAnywhere. The following screen appears. Install GoAnywhere (INSTALLGA) Type choices, press Enter. Install library . . . . . . . . . . Install IFS directory . . . . . . . Install policy files HTTP port . . . . . . HTTPS port . . . . . Shutdown port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . GOANYWHERE Name '/linoma/goanywhere' *YES 8000 8001 8005 *YES, *NO 1-65534 1-65534 1-65534
Version 4.5.0
Linoma Software
Page 14
GoAnywhere Director - Installation and Administration Guide Parameter descriptions: Description The library to contain the GoAnywhere product objects. The specified library name must not already exist. The directory to contain the GoAnywhere product files. The Install IFS directory specified directory name must not already exist. Install policy files Indicate if policy files should be installed into the security directory of the Java Development Kit (JDK). These files are used to support the encryption processes in GoAnywhere. It is strongly recommended to use the default setting of *YES. The port number that the GoAnywhere application server listens HTTP port for administrative requests. Default is 8000. * The port number that the GoAnywhere application server listens HTTPS port for administrative requests over a SSL protected connection. Default is 8001. * The port number which the GoAnywhere application server will Shutdown port listen to for a shutdown request. Default is 8005. * * Note: To check if the port number is already in use, run the i5/OS command of NETSTAT and select option 3. Then press F14 to see the numeric port numbers. 11. After reviewing and/or modifying the parameters on the INSTALLGA command, press enter to start the installation process. 12. Prompt (F4) the command GOANYWHERE/STRGA for starting the GoAnywhere subsystem. The following screen will be displayed. Start GoAnywhere (STRGA) Type choices, press Enter. Server user profile . . . . . . . . *CURRENT Name, *CURRENT Field name Install library
For the Server User Profile parameter, keep the default of *CURRENT if you want to run the GoAnywhere application server under your user profile. Otherwise, specify a different user profile to run the GoAnywhere application server under. Note: The user profile specified on the STRGA command must be enabled on the IBM i. This profile must have *USE authority to the STRSBS command and *RWX authority to the IFS folders where GoAnywhere is installed. For security purposes, you may want to create a new user profile and consistently use that profile on the STRGA command. Then you would only have to grant authority for the GoAnywhere installation IFS folders to that user profile. 13. Press enter on the STRGA command to start the GoAnywhere application server subsystem. (continued on next page)
Version 4.5.0
Linoma Software
Page 15
GoAnywhere Director - Installation and Administration Guide 14. Execute the WRKACTJOB (Work with Active Jobs) command to confirm that the GoAnywhere application server subsystem is running. You should find a subsystem which has the same name as the library name that was specified on the INSTALLGA command in step 10 (named GOANYWHERE by default). This subsystem should contain one job, which is the GoAnywhere application server. 15. The installation and startup of GoAnywhere is complete. Now you should proceed to the Initial Configuration instructions on page 17.
Tip: The GoAnywhere application server can automatically start when the IBM i is powered up (IPL). To perform this automatic startup, place GoAnywheres STRGA command in the IBM i startup CL program (after the start of TCPIP). CL example: 0001.00 0002.00 0003.00 QSYS/STRTCP DLYJOB DLY(120) GOANYWHERE/STRGA /* Start TCP */ /* Wait for TCP to fully start */ /* Start GoAnywhere server */
Version 4.5.0
Linoma Software
Page 16
Initial Configuration
Follow the instructions below to request a license key, test the installation and perform initial configuration of GoAnywhere. 1. To access the GoAnywhere Administrator using a standard HTTP connection, open your browser and type the URL of http://[hostname]:[portnumber] where [hostname] is the host name or IP address of the server which GoAnywhere is installed and [portnumber] is the port number of the GoAnywhere Administrator. The default HTTP port for the Administrator is 8000. Example: http://myserver:8000 Otherwise, to access the GoAnywhere Administrator over a secure HTTPS connection, open your browser and type the URL of https://[hostname]:[portnumber]. The default HTTPS port for the Administrator is 8001. Example: https://myserver:8001 2. You should then be presented with a login screen for the GoAnywhere Administrator.
3. Login with a user name and password. The default user name is administrator and the default password is goanywhere. 4. The GoAnywhere Administrator dashboard should then be displayed.
5. A product license key (either a trial key or permanent key) is required to use GoAnywhere. If you have not received this license key from Linoma Software, then request the key by following the instructions below: a. Select the Administration drop-down menu. b. Select the License sub menu. c. Choose the Request a License option. d. Follow the instructions on that screen to request a license from Linoma Software.
Version 4.5.0
Linoma Software
Page 17
GoAnywhere Director - Installation and Administration Guide 6. After receiving the product license key, you can install the key by following the instructions below: a. Select the Administration drop-down menu. b. Select the License sub menu. c. Choose the Install License option. d. Click on the Browse button and select the license key file on your workstation. e. After choosing the file, click on Install button to install the license. f. If successful, the license information should be displayed on the screen. 7. After installing the license key, you can test the GoAnywhere installation and license by following the instructions below: a. Select the Work with Projects drop-down menu. b. Run the project named Test by clicking on the button next to it. c. You should see the message text of Project '/Test' ran successfully. d. If you do not receive that message within 60 seconds, then contact Linoma Software support. 8. Review and adjust the global settings in GoAnywhere by following the instructions below: a. Select the Administration drop-down menu. b. Choose the "Global Settings" options. c. Review the settings on the tabs and make any changes as needed. Read the on-line help text for each setting to understand its purpose. d. Please note that some changes to certain Global Settings will not take effect until GoAnywhere is restarted. 9. By default, GoAnywhere will authenticate user passwords against its own internal database. Optionally you can configure GoAnywhere to authenticate user passwords against a Windows Active Directory, a generic LDAP server or an IBM i system within your organization. Follow the steps below if you want to authenticate passwords against one of these servers: a. Select the Security drop-down menu. b. Choose the Login Configuration menu option. c. Choose the login method. d. If you choose Windows Active Directory as the login method: Specify the URL of the Active Directory to authenticate passwords against. The URL should be in the format ldap://[hostname]:[port]. For example, ldap://mydomainhostname:389 or ldap://192.168.1.10:389. The default port for the Active Directory Server is 389. The default port for an SSL enabled connection is 636.
f.
Specify the Domain name of the Active Directory. For example, MYDOMAIN. If you choose Generic LDAP as the login method: Specify the URL of the LDAP server to authenticate passwords against. The URL should be in the format ldap://[hostname]:[port]. For example, ldap://mydomainhostname:389 or ldap://192.168.1.10:389. The default port for a LDAP Server is 389. The default port for an SSL enabled connection is 636.
Specify the DN Pattern. The variable ${user} must be included in the DN pattern and will be replaced with the username during login. For example, cn=${user},ou=users,dc=example,dc=com. e. If you choose IBM i as the login method: Specify the IP address or host name of the IBM i to authenticate passwords against. g. Click on the Save button to save the settings. h. The GoAnywhere server will need to be restarted for the settings to take effect.
Version 4.5.0
Linoma Software
Page 18
GoAnywhere Director - Installation and Administration Guide 10. The passwords for the included administrator and root user ids will always be authenticated against GoAnywheres internal database. For security purposes, you should change the passwords for these users by following the instructions below. a. Select the Security drop-down menu. b. Choose the Users menu option. c. Click on the reset password button next to the administrator user name. d. Key in the new password on the screen and click on the Reset button. e. Click on the reset password button next to the root user name. f. Key in the new password on the screen and click on the Reset button. g. Record the new passwords in a safe place. 11. Be sure to read the backup instructions on page 26 to learn how to backup the GoAnywhere configurations and settings, which should be performed on a regular basis.
On-line help text is available within the GoAnywhere administrator by clicking on the button in any screen. Video tutorials are also available at http://www.GoAnywhere.com/tutorials
Version 4.5.0
Linoma Software
Page 19
Customizing Installation Settings

Changing GoAnywhere Port Numbers
By default, GoAnywheres application server will utilize port numbers 8000, 8001 and 8005 on your system for the following functions: 8000 is the default HTTP port which users can connect (from their browsers) for performing administration in GoAnywhere. 8000 is also the default port to listen for Project execution requests from remote systems. 8001 serves the same function as port 8000, but uses a HTTPS (SSL-protected) connection. 8005 is the default port for requesting a shutdown of GoAnywhere from a remote system. You can change these port numbers within the GoAnywhere browser-based administrator interface, or by using the CFGGA command for IBM i or by making direct changes to a GoAnywhere configuration file.
Changing ports using the browser interface

1. Open a browser window and log into the GoAnywhere administrator. 2. Select the Administration drop-down menu. 3. Select the Admin Server Configuration sub menu. 4. Select the Listener node in the tree. 5. Specify the new port number and click on the Save button. 6. The GoAnywhere server must be restarted for the changes to take effect. Please note that you cannot change the shutdown port through the browser interface.
Changing ports using the CFGGA command on IBM i

1. Log in to the IBM i using a terminal session. 2. End the GoAnywhere subsystem by running the command ENDGA 3. Run the command CFGGA 4. Under the "Port Information" section, edit the port numbers as needed by choosing option 2. 5. You may also want to change the "URL" under the "Run Project Defaults" section to match the port number to the new "Server Port". 6. Save the settings and restart GoAnywhere by running the command STRGA.
Changing ports by manually editing the configuration file

1. Stop the GoAnywhere server (if it is running). 2. Edit the configuration file [Install_Dir]/tomcat/conf/server.xml, where [Install_Dir] is the installation directory of GoAnywhere. 3. Change the port number for the HTTP or HTTPS connectors. Example: <Connector port="8000" /> 4. Change the port number for the shutdown listener. Example: <Server port="8005" shutdown="SHUTDOWN"> 5. Save the configuration file. 6. Start the GoAnywhere server.
Version 4.5.0
Linoma Software
Page 20
Disabling HTTP or HTTPS Connectors

GoAnywhere is initially configured to support both HTTP and HTTPS (SSL) connectors for the GoAnywhere web-based Administrator. If you want to disable one of these connectors, then follow the instructions below. a. Stop the GoAnywhere server (if it is running). b. Open the configuration file [Install_Dir]/tomcat/conf/server.xml, where [Install_Dir] is the installation directory for GoAnywhere. c. Locate the following XML code: <Server port="8005" shutdown="SHUTDOWN"> <Service name="Catalina"> <Connector name=default port="8000" /> <Connector name=secured port="8001" enableLookups="false" disableUploadTimeout="true" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" algorithm="SunX509" keystoreFile="[Install_Dir]\userdata\keys\x509\default.jks" keystorePass="goanywhere" keyAlias="goanywhere-https-server" /> . . . </Service> </Server> d. If you do not want to use the HTTP (only use HTTPS) connector, then delete or comment out the line of code illustrated in blue. e. If you do not want to use the HTTPS (only use HTTP) connector, then delete or comment out the lines of code illustrated in green. f. If installing to IBM JVM (e.g. IBM i), then set the algorithm=IbmX509 g. Save the configuration file. h. Start the GoAnywhere server. Note: To comment out XML code, enclose the code with the following indicators  to end the comment Example: 
Version 4.5.0
Linoma Software
Page 21
SSL (HTTPS) Configuration

A certificate is shipped with GoAnywhere, which is used (by default) when a user connects to the GoAnywhere administrator through their browser over HTTPS. While this default certificate works for establishing a secure channel, users will see warnings about a host name mismatch when they connect. This is because the host name in the shipped certificate will be different than the host name of the machine which you installed GoAnywhere to. To avoid these host mismatch warnings, it is recommended to create your own certificate (for your machines host name) and update the GoAnywhere configuration file with the new certificate information. Follow the instructions below to create a new certificate and update the GoAnywhere configuration file: 1. From within the GoAnywhere browser-based Administrator, create a new certificate in the Default Private Keys Store. Read the section Creating a New SSL Certificate in the on-line help text to learn how to create a certificate. Note that the Common Name in the new certificate must match the domain name, host name, or IP address of the server on which GoAnywhere is installed. 2. Open the configuration file [Install_Dir]/tomcat/conf/server.xml, where [Install_Dir] is the installation directory for GoAnywhere. Then modify the value in the keyAlias attribute to be the alias of the new certificate you created in step 1. 3. For IBM i Only: To allow the RUNPROJECT , CPYPROJECT, and the CPYRES commands to function in a secured connection environment, you must first import the newly created certificate into Digital Certificate Manager (DCM). Before you can use any DCM features, you need to start it on your system. To load the IBM Systems Director Navigator for i5/OS web console, open a web browser and enter http://your_system_name:2001. Follow the instructions below to establish a valid SSL Certificate on the IBM DCM. a. Create a new Client application in the DCM. For example, LINOMA_GOANYWHERE. b. Export the new certificate you created in Step 1, to your workstation. c. Import the exported file from step b. to the DCM.
d. Assign the imported certificate to the SSL Application ID you created in Step a. e. Run the Configure GoAnywhere (CFGGA) command from the command line to identify in your GoAnywhere client, the SSL Application ID that you entered into the DCM. Use the Online help available in the DCM for any questions you might have about this process.
Version 4.5.0
Linoma Software
Page 22
Memory Allocation
GoAnywhere runs in a JVM (Java Virtual Machine) instance, which is allocated 1024 MB of memory by default when the product is installed. This memory is utilized for all features in GoAnywhere including administration functions and file transfer activity. Typically 1024 MB of memory is sufficient for most installations. However, if you anticipate high loads (e.g. several thousand file transfers per day), then it is recommended to allocate more memory for the GoAnywhere JVM. Depending on your operating system, follow the instructions below to change this memory allocation.
For Windows:
1. Navigate to the directory of [Install_Dir]/tomcat/bin, where [Install_Dir] is the installation directory for GoAnywhere 2. Find the file named [Service_Name]w.exe, in which [Service_Name] is the name of the windows service specified during installation. GoAnywherew.exe is the default name. Right click on the file and choose to Run as administrator This is a service properties program that provides additional information in regards to the JVM being started by the service.
3. Click on the Java tab and edit the Maximum memory pool setting. Specify 2048 for 2GB of memory, 3072 for 3GB of memory, etc 4. Click on the Apply button to save the memory settings. 5. To restart GoAnywhere for the changes to take effect, click on the General tab and choose to Stop and then Start the service.
For Linux, IBM i, Unix and Solaris:

1) Navigate to the directory of [Install_Dir]/tomcat/bin, where [Install_Dir] is the installation directory for GoAnywhere 2) Edit the file named start_tomcat.sh 3) Modify the following line in the file JAVA_OPTS='-Xmx1024m -XX:MaxPermSize=256m -Djava.awt.headless=true' 4) The setting Xmx512m is the max memory setting, which is set to 1024 MB by default. Change this setting to Xmx2048m for 2GB of memory, -Xmx3072 for 3GB of memory, etc Do not change the MaxPermSize value. For example: JAVA_OPTS='-Xmx2048m -XX:MaxPermSize=256m -Djava.awt.headless=true' 5) Save the file 6) Restart GoAnywhere for the change to take effect.
Version 4.5.0
Linoma Software
Page 23
Product Administration
Starting and Stopping GoAnywhere
Windows instructions
Start the GoAnywhere application server by following these instructions: 1. Go to the Windows machine and logon with an administrator account. 2. Go to Control Panel -> Administrative tools -> Services. 3. In the Services window, right-click on the GoAnywhere service and select Start. Within seconds after starting the GoAnywhere service, its status should be updated to Started. Stop the GoAnywhere application server by following these instructions: 1. Go to the Windows machine and logon with an administrator account. 2. Go to Control Panel -> Administrative tools -> Services. 3. In the Services window, right-click on the GoAnywhere service and select Stop.
Linux, UNIX, HP-UX and Solaris instructions

Start the GoAnywhere application server by following these instructions: 1. Open a Terminal window. 2. Change the working directory to the directory where GoAnywhere is installed (for example, cd /usr/local/Linoma_Software/GoAnywhere) 3. Start the GoAnywhere application server by executing the following shell script: ./goanywhere.sh start Stop the GoAnywhere application server by following these instructions: 1. Open a Terminal window. 2. Change the working directory to the directory where GoAnywhere is installed (for example, cd /usr/local/Linoma_Software/GoAnywhere) 3. Stop the GoAnywhere application server by executing the following shell script: ./goanywhere.sh stop
IBM i (iSeries) instructions

Start the GoAnywhere application server by executing the i5/OS command of STRGA Stop the GoAnywhere application server by executing the i5/OS command of ENDGA The STRGA and ENDGA commands are located in the GoAnywhere installation library, which is named GOANYWHERE by default.
Version 4.5.0
Linoma Software
Page 24
Upgrading GoAnywhere
Updates (new versions) for GoAnywhere can be downloaded from Linoma Softwares server. Read the instructions below to learn how to configure the Proxy settings (if your organization uses a proxy server) and then read the instructions (following) on how to apply the updates.
Configuring HTTP Proxy

If your organization uses a Proxy Server, then you need to configure those proxy settings in GoAnywhere before you can retrieve web updates: 1. Click Administration > Global Settings from the main drop-down menu. 2. Click the HTTP Proxy tab near the right end of the tab set. 3. Specify the type of proxy to use. DIRECT, HTTP, or SOCKS. DIRECT represents a direct connection, or the absence of a proxy. HTTP represents proxy for high-level protocols such as HTTP or FTP. SOCK represents a SOCKS (V4 or V5) proxy. 4. Specify the host name of the proxy server. 5. Specify the port number used by the proxy server. 6. Specify the username to use in order to connect to the proxy server. This is only necessary if the proxy server requires authentication. 7. Specify the password to use in order to connect to the proxy server. This is only necessary if the proxy server requires authentication. 8. Click the Save button. 9. Continue with the upgrade instructions.
Upgrade instructions
Upgrading GoAnywhere requires that you first download the updates through the internet. Then you will need to stop the GoAnywhere service/subsystem, apply the updates and restart GoAnywhere. Software updates can be downloaded directly through the GoAnywhere Administrator interface by following the instructions below: 1. Login to GoAnywheres browser-based Administrator. 2. Select the Administration drop-down menu and then choose the Check for Updates option.
3. If updates are found, a screen will show the new version number, the release notes and instructions on how to download and install the new version. Follow those instructions to perform the upgrade.
Upgrades can optionally be downloaded from the web site of www.GoAnywhere.com .
Version 4.5.0
Linoma Software
Page 25
Active-Passive: Backups and Replication

Follow the instructions in this section if you are using GoAnywhere in an Active-Passive configuration, in which only one installation of GoAnywhere will be active at a time. Otherwise follow the instructions in the Active-Active section (starting on page 32) if you are going to run GoAnywhere in a clustered environment.
Backing up GoAnywhere User Data

GoAnywhere configuration data and Projects are stored in a folder called userdata, which is located under the GoAnywhere installation directory. The default paths to the userdata folder for each platform are listed below: IBM i: /linoma/goanywhere/userdata Windows: C:\Program Files\Linoma Software\GoAnywhere\userdata Linux and UNIX: /usr/local/Linoma_Software/GoAnywhere/userdata IMPORTANT: You should backup the GoAnywhere userdata folder (and its contents) in your regular backup processes. It is recommended to backup this userdata folder at least daily. NOTE: If using the embedded Derby database (which is the default) in GoAnywhere: If you plan to perform backups while the GoAnywhere application is running, then you should exclude the subfolder userdata/database/goanywhere from your backup processes since there will be a lock on the files in this subfolder (which is the embedded Derby database). However, this Derby database is saved nightly (by default) to a subfolder named userdata/database/backups, which you should backup.
Version 4.5.0
Linoma Software
Page 26
Automatically Backing Up the GoAnywhere Database (to Disk)

These instructions only apply if using the default embedded Derby database in GoAnywhere. If not using the embedded Derby database in GoAnywhere, you should backup the GoAnywhere tables (in your designated database) using your regular database backup procedures.
By default, GoAnywhere will perform an automatic backup (to disk) of its embedded Derby database every day at midnight. The database backup files are created in the folder of [Install_Dir]/userdata/database/backups, where [Install_Dir] is the installation directory for GoAnywhere. By default, database backup files are retained for the last 7 days. Follow the instructions below to modify the database backup settings: 1. Select the drop-down menu of Administration and then select Database Configuration. 2. Select the Backup tab. The current backup settings will be shown.
Enable Database Backup Specify whether or not the GoAnywhere embedded database should be backed up automatically on a scheduled basis. It is highly recommended that the database backup remains enabled in case any data needs to be recovered. Backup Directory Specify the directory to store the database backups, which is relative to the installation directory. Keep Backups for Specify the number of days (130) to keep the database backup files. Backup files that are older than the specified number of days will be automatically deleted following each backup process. Schedule Type Specify if the schedule is Hourly or Daily. Run Every Specify the frequency that the automatic database backup should run.
3. Make any needed changes and then click on the Save button.
Version 4.5.0
Linoma Software
Page 27
Manually Backing Up the GoAnywhere Database (to Disk)

These instructions only apply if using the default embedded Derby database in GoAnywhere. To backup the GoAnywhere database manually: 1. Select the drop-down menu of Administration and then select Database Configuration. 2. Click the Backup tab. The current backup settings will be shown. 3. Click the Backup Now button at the bottom of the screen. 4. When the system completes the backup process, a message will be displayed with the location to which the database was backed up.
Version 4.5.0
Linoma Software
Page 28
IBM i Backup and Recovery

IBM i Saving Using the supplied i5/OS command named SAVPRD, you can save the GoAnywhere product from the IBM i machine. This will save all GoAnywhere objects and user data (including configurations and Project definitions) into a single IBM i Save file. This will allow you to easily restore GoAnywhere onto another IBM i machine. Perform the following steps to save the GoAnywhere product using the SAVPRD command: 1. End the GoAnywhere subsystem by executing the command <library>/ENDGA, where GOANYWHERE is the default installation <library>. 2. Perform a WRKACTJOB and verify that the GoAnywhere subsystem is ended. 3. Prompt (F4) the command of <library>/SAVPRD and specify the following values: The name of the library containing the GoAnywhere product. The name of the library containing the GoAnywhere tables, if using the DB2 database option. The name of the Save file to store the GoAnywhere product into. The specified Save file will be automatically created. Example: GOANYWHERE/SAVPRD LIB(GOANYWHERE) SAVEFILE(QGPL/GOANYWHERE) 4. Press enter to execute the SAVPRD command. 5. After the SAVPRD command executes, you can restart the GoAnywhere subsystem by executing the command <library>/STRGA. IBM i Restoring Follow these steps to restore the GoAnywhere product from the Save file: 1. If you are using a specific user profile to start GoAnywhere, then you will need to create that user profile on the target system. Using the CRTUSRPRF command, create a user profile with the same name and authorities that were used in the original installation of GoAnywhere. Example: CRTUSRPRF USRPRF(GOANYWHERE) 2. If you are using the DB2 database option to store the GoAnywhere tables, create a user profile with the same name, password and authorities that was the owner of the collection. Example: CRTUSRPRF USRPRF(GADATA) PASSWORD(xxxxxxxxxx) 3. Restore the temporary Save files into the QTEMP library. Example: RSTOBJ OBJ(*ALL) SAVLIB(QTEMP) DEV(*SAVF) SAVF(QGPL/GOANYWHERE) 4. Restore the GoAnywhere library from the Save file named SLIBGA. Example: RSTLIB SAVLIB(GOANYWHERE) DEV(*SAVF) SAVF(QTEMP/SLIBGA) 5. Restore the GoAnywhere IFS folder from the Save file named SIFSGA. Example: RST DEV('/QSYS.LIB/QTEMP.LIB/SIFSGA.FILE') OBJ(('/linoma/*')) 6. If the IBM i IP address is different than the IP address of the original installation, then you should run the CFGGA command (contained in the GoAnywhere library) and specify the new IP address. ** If you are restoring GoAnywhere to a different serial number, you will need a new license for that system, which you can request from Linoma Software.
Version 4.5.0
Linoma Software
Page 29
Replicating GoAnywhere User Data (for High Availability)

GoAnywhere user data can be replicated to another system for high availability and failover purposes. GoAnywhere does not have a built-in replication function, so you will need to use a separate tool to replicate the necessary data to the high availability (HA) machine. If using the embedded Derby database in GoAnywhere, please note that it cannot be replicated while it is running (due to locks), so the HA machine can only be sent a backup of the database. The timing of this database backup is controlled under the Administration->Database Configuration menu.
Replication
Follow the steps below to set up replication: 1. Install GoAnywhere onto the HA machine using one of the regular installation methods (depending on your OS) outlined earlier in this manual. 2. Get a license key from Linoma Software for the HA machine and install it. 3. Test the GoAnywhere installation on the HA machine by executing some test projects. 4. Shut down the GoAnywhere subsystem/service on the HA machine, since GoAnywhere should not be running on both the production and HA machines at the same time. 5. Set up your HA tool to replicate the folder named userdata, which is located under the GoAnywhere installation directory on the production machine. The userdata folder contains all user data and configurations for GoAnywhere. Make sure to include all the subfolders under the userdata folder, except if you are using the embedded Derby database, DO NOT replicate the subfolder named /userdata/database/goanywhere/ since there will be a lock on that subfolder while GoAnywhere is running. This subfolder contains the embedded database, which is saved nightly (by default) to the subfolder named userdata/database/backups. 6. If not using the embedded Derby database in GoAnywhere, then set up your HA tool to replicate the GoAnywhere tables in your designated database. NOTE: Other files (such as log files) in the GoAnywhere directory may be in a locked state while Projects are being executed and will potentially not be replicated. WARNING: If you want to replicate the entire GoAnywhere installation directory, then do not replicate the file named goanywhere.lic since that file contains the GoAnywhere license key that is specific for that particular machine. If the license key is replicated to the HA machine, it will generate a license error in GoAnywhere on the HA machine and will not allow it to execute Projects.
Failover
The steps needed to run GoAnywhere on the HA machine depends on if your production machine is still up-and-running. If your production machine is down and you want to switch to the HA machine: 1. If using the embedded (Derby) database in GoAnywhere: On the HA machine, unzip the latest backup of the GoAnywhere database (found in subfolder named userdata/database/backups) into the subfolder named /userdata/database/goanywhere. Please note that the database will only be as up-to-date as the last time the database was backed up on the production machine. 2. Start the GoAnywhere subsystem/service on the HA machine.
(continued on next page) Version 4.5.0 Linoma Software Page 30
If your production machine is running and you want to switch to the HA machine: 1. If using the embedded Derby database in GoAnywhere: On the production machine, perform a manual backup of the GoAnywhere database by following the instructions on page 28. 2. Shut down the GoAnywhere subsystem/service on the production machine. 3. If using the embedded Derby database in GoAnywhere: a) Copy the manual backup of the database (contained in a ZIP file) from the production machine to the HA machine. b) Unzip this backup of the database into the /userdata/database/goanywhere folder on the HA machine. 4. Start the GoAnywhere subsystem/service on the HA machine.
Version 4.5.0
Linoma Software
Page 31
Active-Active: Clustering and Automatic Failover

Clustering allows two or more GoAnywhere installations (systems) to work together for running batch file transfers and scheduled jobs. This provides greater scalability by allowing workloads to be distributed horizontally across multiple GoAnywhere systems. This active-active clustered environment also provides the best high availability option for handling potential system failures. If one GoAnywhere system fails, the remaining GoAnywhere systems in the cluster will automatically continue to process any new batch jobs. The following features are available in GoAnywhere when running in a cluster: Two or more GoAnywhere systems within a cluster can connect to the same external database at the same time. This allows these systems to share security settings, user accounts, configurations, job audit entries and other product tables. The database can be configured or switched from any system in the cluster, in which the database settings will be replicated to all systems in the cluster. Batch jobs will be executed by any available systems in the cluster. If a particular system becomes too busy, other systems in the cluster will pick up any jobs from the job queue for execution. The Active Jobs screen will display all jobs which are executing across all systems in the cluster. Within this screen, jobs can be held/released/cancelled on any system in the cluster. File monitor jobs (for scanning folders) will be distributed evenly across all systems in the cluster to optimize performance. The System Name (specified in [InstallationDirectory]/config/gadirector.xml) for each participant in the cluster will appear on the GoAnywhere login screen, on the top-right corner of the dashboard and any cluster-related screens. This name will also be recorded in the audit logs to indicate which system was executing the job. The system name is also accessible in Projects using the 'system.systemName' variable.
Version 4.5.0
Linoma Software
Page 32
When setting up a cluster, you will need to install GoAnywhere onto two or more servers. It is recommended that the Operating Systems and JRE versions on these servers to be the same for simplifying configuration.
Setting up the First System in the Cluster

Follow the instructions below to configure the first system in the Cluster. 1. Start GoAnywhere and login to its browser-based administrator. 2. A special license key is required to utilize Clustering in GoAnywhere, which is a chargeable feature. If you have not acquired this license key yet, then navigate to the Administration > License > Request License page and send the information on the screen to sales@goanywhere.com. After you have received a license key, you can install this key by navigating to Administration > License > Install License. 3. All systems in the cluster are required to use the same external database (MySQL, SQL Server, Oracle, DB2 on IBM i or Derby in network mode). The Switch Database wizard located in the Administration > Database Configuration section will guide you through the process to utilize an external database. Data in the existing database can be automatically migrated to the new external database. 4. All systems in the cluster must point to the same set of shared folders for storing project definitions, workspaces, certificates, keys and other user data. It is recommended that these folder paths are pointing to a shared network location. For example, on Windows you can use UNC paths, on Linux you can use a file system mount and on IBM i you can use QFileSvr.400 or NFS. Follow the steps below: a. Navigate to the Administration > Global Settings page. On the Data tab, specify the shared network folders for Projects, Workspaces, Documents and Monitors. b. Navigate to the Logs > Log Manager page and configure the Logs Directory to point to a shared network folder. c. If you are using digital certificates to authenticate your trading partners HTTPS or FTPS servers, then all systems in the cluster should point to the same location for the SSL Key Stores. To specify the Key Store locations: i. Select Tools from the main menu and choose the SSL Certificate Manager menu item, and then select Preferences. Specify the shared network locations for the key stores on the Default Trusted Certificates and Default Private Keys. ii. Select Resources from the main menu and then drill down into the FTPS folder. Edit each FTPS resource and make sure the Key Store File parameters (if specified) on both the Server Certificate Key Store and Client Certificate Key Store tabs are pointing to shared network locations. iii. Drill down into the HTTPS folder under Resources. Edit each HTTPS resource and make sure the Key Store File parameters (if specified) on both the Server Certificate Key Store and Client Certificate Key Store tabs are pointing to shared network locations. (continued on next page)
Version 4.5.0
Linoma Software
Page 33
GoAnywhere Director - Installation and Administration Guide d. If you are using SSH keys to authenticate your trading partners SFTP or SCP servers, then all systems in the cluster should point to the same location for the SSH private key files. To specify the locations for these files: i. Select Resources from the main menu and then drill down into the SFTP folder. Edit each SFTP resource and make sure the Private Key File parameter on the SSH Keys tab is pointing to a shared network location. ii. Drill down into the SCP folder under Resources. Edit each SCP resource and make sure the Private Key File parameter on the SSH Keys tab is pointing to a shared network location. e. If you are using OpenPGP to encrypt or decrypt files, then the locations of the OpenPGP key rings should point to a shared network location that all systems in the cluster have access to. To change the OpenPGP Key Ring locations: i. Select Tools from the main menu and choose the OpenPGP Key Manager menu item. Then choose the Preferences option. Specify shared network locations for the Public and Secret Key rings. ii. Select Resources form the main menu and then drill down into the Open PGP Key Rings folder. Edit each key ring resource and make sure the Public Key Ring and Secret Key Ring parameters both point to a shared network location. 5. After the configuration is completed in the steps above, you should verify there are no active users or jobs on this installation. Then shut down the GoAnywhere service or subsystem. 6. Go to the file system of the server that GoAnywhere is installed on and open the file named [InstallationDirectory]/config/gadirector.xml, where [InstallationDirectory] is the location that GoAnywhere is installed to. The following properties need to be configured in this file: a. systemName - A unique name to identify this system in the cluster. The maximum system name
length is 20 characters.
b. clusterBindAddress - The IP address which GoAnywhere will listen on to communicate with other
GoAnywhere systems in a cluster. This IP address must be valid on this server which GoAnywhere is installed to.
c.
clusterBindPort - The port number which GoAnywhere will listen on to communicate with other GoAnywhere systems in a cluster. For example, 8006. the cluster. When the log level is set to verbose the log will also record all of the system-to-system messages used to manage the cluster. While initially testing clustering within your environment, it is recommended to keep the log level at verbose to get more detailed messages.
d. clusterLogLevel - The log level of info will record all standard log messages from each system in
e. clusterEnabled - This must be set to true. Example of gadirector.xml file below. Notice the user-specified settings in blue: <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd"> <properties> <entry key="systemName">System-A</entry> <entry key="clusterBindAddress">192.168.1.220</entry> <entry key="clusterBindPort">8006</entry> <entry key="clusterLogLevel">verbose</entry> <entry key="clusterEnabled">true</entry> </properties>
Version 4.5.0
Linoma Software
Page 34
GoAnywhere Director - Installation and Administration Guide 7. After configuring gadirector.xml, you can restart GoAnywhere. 8. Its important to review the GoAnywhere global log for any errors. Sign into the administrator and navigate to Logs > Server Log Viewer. The log file will be named goanywhere_systemName.log, where systemName was specified in step 6 above. 9. This system will assume the Coordinator role since it is the first GoAnywhere system started in the cluster.
Setting up Additional Participant Systems in the Cluster

Follow the steps below to configure each additional Participant system in the cluster: 1. Start GoAnywhere and login to its browser-based administrator. 2. Make sure a license key is installed on this system with the Clustering feature. 3. Navigate to the Administration > Database Configuration > Switch Database screen. Follow the steps to switch this database over to the same database that the first system is using. IMPORTANT: On Step 5 of the Switch Database process, select the third radio button for Do Nothing, the database already has valid tables, indexes and data. 4. Verify there are no active users or jobs on this installation. Then shut down the GoAnywhere service or subsystem. 5. Configure the gadirector.xml file for this system using the instructions from step 6 in the previous section (for the first system). Make sure to specify a unique system name and IP for this installation. Example: <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE properties SYSTEM "http://java.sun.com/dtd/properties.dtd"> <properties> <entry key="systemName">System-B</entry> <entry key="clusterBindAddress">192.168.1.132</entry> <entry key="clusterBindPort">8006</entry> <entry key="clusterLogLevel">verbose</entry> <entry key="clusterEnabled">true</entry> </properties> 6. Restart GoAnywhere on the Participant system. 7. Its important to review the GoAnywhere global log for any errors. Sign into the administrator and navigate to Logs > Server Log Viewer. The log file will be named goanywhere_systemName.log, where systemName was specified in step 5 above.
Troubleshooting Errors
The following items identify problems that may occur when a Participant attempts to join a cluster: 1. If you receive an error about product versions not matching, then the Participant is running a different version of GoAnywhere than the Coordinator system. All systems in the cluster must be running on the same GoAnywhere version. 2. If you receive an error about the timestamp on the Participant not being within five minutes of the Coordinator system, then you must change the system clock on the Participant system to be in sync with the Coordinator. The time is compared in UTC and ignores time zone differences. 3. You may receive an error about one of the documents directories not being shared. This can occur when the Coordinator system can access the directory but a Participant cannot. In this case
Version 4.5.0
Linoma Software
Page 35
GoAnywhere Director - Installation and Administration Guide you will need to log in to the Coordinator system and configure the Data or Logs directories to ensure they are the accessible for all systems in the cluster. 4. You may receive an error about how the Participant system shut down because another system is actively using the database. This can occur when the Participant and Coordinator systems cannot connect to each other over the clustering communications channel. It is important that the Coordinators IP and port (used for the communications channel) is accessible by the other Participant systems. If that address is blocked by a firewall or other network restrictions, then this system will not be considered as part of the cluster and will be forced to shut down.
Clustering Failover
GoAnywhere executes several background processes to schedule jobs, purge records and to perform other housekeeping processes. This processing is the responsibility of the Coordinator system. If the Coordinator system becomes unresponsive, then the next Participant to join the cluster will become the Coordinator. For example, if a cluster was started with three systems (System-A, System-B and System-C) in that order, then System-A will be the Coordinator since it was the first to join the cluster. If System-A fails for any reason, then System-B will become the new Coordinator. If System-A is restarted and successfully rejoins the cluster, then the order of the systems (for becoming a Coordinator) would then be System-B, System-C and then System-A. If System-B were to crash, then System-C would become the new Coordinator. It is possible for the clustering communications channel between the systems to break due to network interruptions or other reasons. GoAnywhere has built-in heartbeats and other safety checks to overcome small network interruptions. However, if the communication becomes unresponsive for 60 seconds, then the Participant systems will believe that the Coordinator system has failed. When that happens, each Participant will start checking the database to see if the Coordinator system is still running. If the Coordinator system is still running after 30 seconds (if the communications channel fails) then the Participant systems will automatically shut down. This is required in order to prevent issues that can occur when multiple GoAnywhere systems are running on the same database and not communicating with each other. In this rare scenario, even though the Participant systems were shut down, the Coordinator system will still be up and running.
Backups
When GoAnywhere is running in a clustered environment, the following items are recommended to be backed up on a regular and automated basis: 1. The external database that GoAnywhere is running on. Speak with your database administrator to make sure this database is part of the backup process. 2. The folder locations for the project definitions, workspaces, documents, monitors and logs directories. Speak with your network administrator to make sure that these locations are part of the backup process. 3. Any additional user data and configurations for GoAnywhere are stored in the [InstallationDirectory]/userdata folder, which also needs to be backed up.
Version 4.5.0
Linoma Software
Page 36
GoAnywhere IBM i Commands

For IBM i installations, GoAnywhere includes i5/OS commands for performing various functions in the product. These commands can be entered on the IBM i command line, placed in CL programs and used in job schedulers on the IBM i.
Command Summary
The GoAnywhere i5/OS commands can be found in the installation library, which is GOANYWHERE by default. Listed below is an alphabetical listing of the commands: Command CFGGA Command Description Configure GoAnywhere Comments Allows users (with *SECADM authority) to change certain properties in the GoAnywhere installation, such as the default user, password and URL to use for the RUNPROJECT command. Copies a Project definition from one installation of GoAnywhere to another installation of GoAnywhere. Copies a Resource definition from one installation of GoAnywhere to another installation of GoAnywhere. Creates the supporting Projects that are used for the SFTPGET, SFTPPUT, PGPENCRYPT, PGPDECRYPT, ZIP, UNZIP and SNDEMLMSG commands. This command should only need to be run once. Displays the current version number of GoAnywhere, the port numbers used and the IBM i serial number and processor group. Ends the GoAnywhere application server Imports a Project definition XML into GoAnywhere Provides both decryption and signature verification. Provides both encryption and signing of files. Runs a GoAnywhere Project Retrieves one or more files over a SFTP connection Sends one or more files over a SFTP connection Sends a message to one or more email addresses. Includes support for file attachments Starts the GoAnywhere application server Upgrades the GoAnywhere software Unzips files that were compressed with ZIP standard Provides compression and password protection
CPYPROJECT CPYRES CRTCMDPRJ
Copy (promote) Project Copy (promote) Resource Create Command Projects
DSPPRDINF
Product information
ENDGA IMPPROJECT PGPDECRYPT PGPENCRYPT RUNPROJECT SFTPGET SFTPPUT SNDEMLMSG STRGA UPGRADEGA UNZIP ZIP
End GoAnywhere Server Import Project Decrypt file with OpenPGP Encrypt file with OpenPGP Run Project Get file over SFTP Put file over SFTP Send Email Message Start GoAnywhere Server Upgrade GoAnywhere UnCompress file with ZIP Compress file with ZIP
Version 4.5.0
Linoma Software
Page 37
Accessing Main Menu

The supplied i5/OS commands are accessible from a main menu in the GoAnywhere library, which can be launched with the command of GO GOANYWHERE/GAMENU (assuming GOANYWHERE is the library that you installed the product to). GAMENU Main Menu GoAnywhere by Linoma Software
Select one of the following: 1. 2. 3. 4. Administration Projects Source examples SFTP, OpenPGP and ZIP commands (GO (GO (GO (GO GAMENU1) GAMENU2) GAMENU3) GAMENU4)
10. Product information
(DSPPRDINF)
Selection or command ===>__________________________________________________________________ _____________________________________________________________________ F3=Exit F4=Prompt F9=Retrieve F12=Cancel F13=Information Assistant F16=AS/400 main menu
The GoAnywhere commands can be found in the various submenus off of the main menu.
SFTP, OpenPGP, ZIP and Email Command Shortcuts

Native commands are provided for IBM i customers that allow quick access to popular functions in GoAnywhere. This includes commands to get and put files through SFTP, encrypt and decrypt files with OpenPGP, ZIP and UNZIP files, as well as send Emails. These commands can be entered on the IBM i command line, placed in CL programs and used in job schedulers on the IBM i. These native commands can be found in the GoAnywhere menu of GAMENU4 (accessible by running the command of GO GOANYWHERE/GAMENU). Each command can be prompted and has on-line help text that is available through the F1 function key. NOTE: Before the SFTP, OpenPGP, ZIP and Email native commands can be utilized, their underlying Projects (to process these commands) must be first created in GoAnywhere. To perform this initial Project creation, select option 1 from GAMENU4 (which will execute the command CRTCMDPRJ). The Projects will be created in the GoAnywhere folder of \CommandLineProjects.
Version 4.5.0
Linoma Software
Page 38
Uninstalling GoAnywhere Product

This section describes how to uninstall the GoAnywhere product. CAUTION: All GoAnywhere configurations, resources and project definitions will be deleted during the uninstall process.
Windows uninstall instructions

Perform the following steps to uninstall the GoAnywhere product from Windows: Step 1 2 3 4 Description Verify that no jobs are currently running in the GoAnywhere Administrator End the GoAnywhere service on the Windows system. Browse to the installation directory of GoAnywhere. The default install directory is C:\Program Files\Linoma Software\GoAnywhere Run the file named uninstall.exe to uninstall the product.
Linux, UNIX, HP-UX and Solaris uninstall instructions

Perform the following steps to uninstall the GoAnywhere product from Linux: Step 1 2 3 4 5 Description Verify that no jobs are currently running in the GoAnywhere Administrator Login to the Linux system and open a Terminal window. Change the working directory to the directory where GoAnywhere was installed (for example, cd /usr/local/Linoma_Software/GoAnywhere) Stop the GoAnywhere application server by executing the following shell script: ./goanywhere.sh stop Uninstall the GoAnywhere product by executing the following shell script: ./uninstall.sh
IBM i uninstall instructions

Perform the following steps to uninstall the GoAnywhere product from the IBM i: Step 1 Description Verify that no jobs are currently running in the GoAnywhere Administrator. End the GoAnywhere server. Verify that there are no locks on the GoAnywhere library. The default library is GOANYWHERE. Delete the GoAnywhere library. The default library is GOANYWHERE. Delete the GoAnywhere folder from the IFS. The default main folder name is \linoma\goanywhere. Example Commands
2 3
GOANYWHERE/ENDGA WRKOBJLCK OBJ(GOANYWHERE) OBJTYPE(*LIB)
4 5
DLTLIB LIB(GOANYWHERE) QSH cd /linoma rm r goanywhere Page 39
Version 4.5.0
Linoma Software
License agreement and limited warranty

READ CAREFULLY BEFORE USING The GoAnywhere Director software ('GOANYWHERE') is a proprietary product of Linoma Software ('LINOMA SOFTWARE') and is protected by this Agreement, copyright laws and international treaties. This is a legal agreement (the 'Agreement') between you, the user, and LINOMA SOFTWARE. Clicking on the license agreement acceptance button (if you are downloading GOANYWHERE), opening the package (if you have acquired a copy of GOANYWHERE on physical media) or loading or using GOANYWHERE on your system indicates your acceptance of the terms of this Agreement. If you do not wish to agree to the terms of this Agreement, you should promptly notify LINOMA SOFTWARE and immediately remove GOANYWHERE from your system and cease use of GOANYWHERE. A. LINOMA SOFTWARE grants you the right to use GOANYWHERE on your computer system. If you have a trial version of GOANYWHERE, your license is limited to use only during the trial period and only for evaluation purposes. You may not alter, modify, decompile, disassemble or reverse engineer GOANYWHERE, or otherwise attempt to reproduce the source code thereof. You acknowledge that GOANYWHERE is provided pursuant to a license and all title and ownership to GOANYWHERE shall remain with LINOMA SOFTWARE or its licensors. You may use GOANYWHERE only for your own internal business purposes and may not use GOANYWHERE in a service bureau (or similar) environment unless your customers have also purchased a license to GOANYWHERE or a special licensing arrangement has been arranged with LINOMA SOFTWARE.
B.
C.
D.
TERM This license is effective until terminated. You may terminate it at any time by destroying GOANYWHERE together with all copies and merged portions in any form. It will also terminate upon conditions set forth elsewhere in this Agreement, or if you fail to comply with any term or condition of this Agreement. LIMITED WARRANTY YOU HEREBY ACKNOWLEDGE AND AGREE THAT GOANYWHERE IS PROVIDED BY LINOMA SOFTWARE ON AN "AS IS" BASIS, AND YOUR ACCESS TO AND/OR USE OF GOANYWHERE IS AT YOUR SOLE RISK. LINOMA SOFTWARE EXPRESSLY DISCLAIMS ALL WARRANTIES OF ANY KIND, WHETHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THOSE OF MERCHANTABILITY, SATISFACTORY QUALITY, TITLE, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT. LINOMA SOFTWARE MAKES NO WARRANTY THAT GOANYWHERE WILL MEET YOUR REQUIREMENTS OR THAT YOUR USE OF GOANYWHERE WILL BE UNINTERRUPTED, TIMELY OR ERROR-FREE, NOR DOES LINOMA SOFTWARE MAKE ANY WARRANTY AS TO THE RESULTS THAT MAY BE OBTAINED FROM THE USE OF GOANYWHERE OR THAT ANY DEFECTS WILL BE CORRECTED. YOU UNDERSTAND AND AGREE THAT THE USE OF GOANYWHERE IS DONE AT YOUR SOLE RISK AND THAT YOU WILL BE SOLELY RESPONSIBLE FOR ANY DAMAGE TO YOUR SYSTEM OR LOSS OF DATA. NO INFORMATION OR ADVICE, WHETHER ORAL OR WRITTEN, OBTAINED BY YOU FROM LINOMA SOFTWARE OR THROUGH GOANYWHERE SHALL CREATE ANY WARRANTY NOT EXPRESSLY MADE HEREIN. SOME JURISDICTIONS DO NOT ALLOW THE EXCLUSION OF CERTAIN WARRANTIES, SO SOME OF THE ABOVE EXCLUSIONS MAY NOT APPLY TO YOU. IN NO EVENT WILL LINOMA SOFTWARE BE LIABLE TO YOU FOR ANY SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES, INCLUDING BUT NOT LIMITED TO ANY LOST PROFITS, LOST SAVINGS, LOST DATA OR LOST BUSINESS OPPORTUNITIES ARISING OUT OF THE USE OR INABILITY TO USE GOANYWHERE EVEN IF LINOMA SOFTWARE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. Circumstances may arise where, because of a default on LINOMA SOFTWARE's part or other liability, you are entitled to recover damages from LINOMA SOFTWARE. In each such instance, regardless of the basis on which you may be entitled to claim damages from LINOMA SOFTWARE, (including fundamental breach, negligence, misrepresentation, or other contract or tort claim), LINOMA SOFTWARE is liable for no more than the amount you paid for GOANYWHERE. This limited warranty gives you specific legal rights. Some states provide other rights, and some states do not allow excluding or limiting implied warranties or limiting liability for incidental or consequential damages. As a result, the above limitations and or exclusions may not apply to you. Furthermore, some jurisdictions have statutory consumer product provisions which may supersede these provisions of the Agreement. GENERAL If any provision of this Agreement shall be unlawful, void or for any reason unenforceable, then that provision shall be deemed severable from this Agreement and shall not affect the validity and enforceability of the remaining provisions of this Agreement. This Agreement will be governed by the laws of the State of Nebraska including the applicable provisions of the Uniform Electronic Transactions Act, as adopted in the State of Nebraska.
Version 4.5.0
Linoma Software
Page 40
Contacting Linoma Software

The Company
Founded in 1994, Linoma Software provides innovative technologies for protecting sensitive data and automating data movement. Linoma Software has a diverse install base of over 3,000 customers around the world including Fortune 500 companies, non-profit organizations and government entities. Linomas success has been built on being very responsive to our customers requirements. So if you have suggestions on how we can improve our products to better serve your organization, please let us know.
How to Contact Linoma Software

Electronic
Sales Support Website sales@goanywhere.com support@goanywhere.com www.GoAnywhere.com
Phone Numbers
Toll-free: Outside USA: Fax: 1-800-949-4696 (402) 944-4242 (402) 944-4243
Address
Linoma Software 1409 Silver Street Ashland, NE 68003 USA
Version 4.5.0
Linoma Software
Page 41

Ga4 5 0 Installation Guide

Încărcat de

Informații document

Drepturi de autor

Formate disponibile

Partajați acest document

Partajați sau inserați document

Opțiuni de partajare

Vi se pare util acest document?

Este necorespunzător acest conținut?

Drepturi de autor:

Formate disponibile

Ga4 5 0 Installation Guide

Încărcat de

Drepturi de autor:

Formate disponibile

Installation and Administration Guide

Product Version: Publication date: 4.5.0 7/9/2013

GoAnywhere Director - Installation and Administration Guide

How GoAnywhere Works .............................................................................................. 6

Installation Linux ........................................................................................................ 9

Installation UNIX, AIX, HP-UX, Solaris .................................................................... 10

Installation IBM i (iSeries) ........................................................................................ 12

Initial Configuration .................................................................................................... 17 Customizing Installation Settings .............................................................................. 20

Product Administration .............................................................................................. 24

GoAnywhere Director - Installation and Administration Guide

Active-Passive: Backups and Replication ................................................................ 26

Active-Active: Clustering and Automatic Failover ................................................... 32

GoAnywhere IBM i Commands .................................................................................. 37

Uninstalling GoAnywhere Product ............................................................................ 39

GoAnywhere Director - Installation and Administration Guide

GoAnywhere Director - Installation and Administration Guide

GoAnywhere Director - Installation and Administration Guide

How GoAnywhere Works

GoAnywhere Director - Installation and Administration Guide

GoAnywhere Director - Installation and Administration Guide

- Disk Space: - Memory:

Installing GoAnywhere on Windows

GoAnywhere Director - Installation and Administration Guide

Installing GoAnywhere on Linux

GoAnywhere Director - Installation and Administration Guide

Installation UNIX, AIX, HP-UX, Solaris

- JRE (Java Runtime Environment) 1.6.0 or higher.

(continued on next page)

GoAnywhere Director - Installation and Administration Guide

GoAnywhere Director - Installation and Administration Guide

Installation IBM i (iSeries)

Required licensed programs

i5/OS Release V5R4

GoAnywhere Director - Installation and Administration Guide

IBM i components installed

GoAnywhere Director - Installation and Administration Guide

Installing GoAnywhere on IBM i

GoAnywhere Director - Installation and Administration Guide

GoAnywhere Director - Installation and Administration Guide

Customizing Installation Settings

Changing ports using the browser interface

Changing ports using the CFGGA command on IBM i

Changing ports by manually editing the configuration file

GoAnywhere Director - Installation and Administration Guide

Disabling HTTP or HTTPS Connectors

GoAnywhere Director - Installation and Administration Guide

SSL (HTTPS) Configuration

GoAnywhere Director - Installation and Administration Guide

For Linux, IBM i, Unix and Solaris:

GoAnywhere Director - Installation and Administration Guide

Linux, UNIX, HP-UX and Solaris instructions

IBM i (iSeries) instructions

GoAnywhere Director - Installation and Administration Guide

Configuring HTTP Proxy

Upgrades can optionally be downloaded from the web site of www.GoAnywhere.com .

GoAnywhere Director - Installation and Administration Guide

Active-Passive: Backups and Replication

Backing up GoAnywhere User Data

GoAnywhere Director - Installation and Administration Guide

Automatically Backing Up the GoAnywhere Database (to Disk)

GoAnywhere Director - Installation and Administration Guide

Manually Backing Up the GoAnywhere Database (to Disk)

GoAnywhere Director - Installation and Administration Guide

IBM i Backup and Recovery