+ All Categories
Home > Documents > Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX,...

Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX,...

Date post: 11-Apr-2018
Category:
Upload: doanthuan
View: 242 times
Download: 4 times
Share this document with a friend
38
Installation and Administration Guide Product Version: 2.5.0 Publication date: 7/21/2011 © Copyright 2008-2011, LINOMA SOFTWARE LINOMA SOFTWARE is a division of LINOMA GROUP, Inc.
Transcript
Page 1: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

Installation and Administration Guide

Product Version: 2.5.0 Publication date: 7/21/2011

© Copyright 2008-2011, LINOMA SOFTWARE

LINOMA SOFTWARE is a division of LINOMA GROUP, Inc.

Page 2: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 2

Table of Contents

Introduction ................................................................................................................... 4 Administration ............................................................................................................................................ 5 

Pre-Installation Notes ................................................................................................... 6 Port Number Usage ................................................................................................................................... 6 

Installation − Windows ................................................................................................. 7 Requirements ............................................................................................................................................ 7 Installing GoAnywhere Services on Windows ........................................................................................... 7 

Installation – Linux ........................................................................................................ 8 Requirements ............................................................................................................................................ 8 Installing GoAnywhere Services on Linux ................................................................................................. 8 

Installation − UNIX, AIX, HP-UX, Solaris ...................................................................... 9 Requirements ............................................................................................................................................ 9 Installing GoAnywhere Services ................................................................................................................ 9 

Installation – IBM i (iSeries) ........................................................................................ 11 Requirements .......................................................................................................................................... 11 

Required licensed programs ................................................................................................................ 11 Required PTFs ..................................................................................................................................... 12 

IBM i components installed ..................................................................................................................... 12 Installing GoAnywhere Services on IBM i ............................................................................................... 13 

Initial Configuration .................................................................................................... 16 

Customizing Installation Settings .............................................................................. 19 Changing GoAnywhere Services Port Numbers ..................................................................................... 19 

Changing ports using the browser interface ........................................................................................ 19 Changing ports using the CFGGAS command on IBM i ..................................................................... 19 Changing ports by manually editing the configuration file ................................................................... 19 

Disabling HTTP or HTTPS Connectors ................................................................................................... 20 SSL (HTTPS) Configuration .................................................................................................................... 21 Firewall Recommendations ..................................................................................................................... 22 

Installation in the DMZ ......................................................................................................................... 22 Installation in the Private Network ....................................................................................................... 23 Installation with GoAnywhere Gateway ............................................................................................... 24 

Product Administration .............................................................................................. 25 Starting and Stopping GoAnywhere Services ......................................................................................... 25 

Windows instructions ........................................................................................................................... 25 Linux and UNIX instructions ................................................................................................................ 25 IBM i instructions .................................................................................................................................. 25 

Upgrading GoAnywhere Services ........................................................................................................... 26 Configuring HTTP Proxy ...................................................................................................................... 26 Windows upgrade instructions ............................................................................................................. 27 Linux and UNIX upgrade instructions .................................................................................................. 28 IBM i upgrade instructions ................................................................................................................... 29 

Page 3: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 3

Backups and Replication ............................................................................................ 30 Backing up GoAnywhere Services User Data ......................................................................................... 30 Automatically Backing Up the GoAnywhere Services Database (to Disk) .............................................. 31 Manually Backing Up the GoAnywhere Services Database (to Disk) ..................................................... 32 Replicating GoAnywhere Services User Data (for High Availability) ...................................................... 33 

Replication ........................................................................................................................................... 33 Failover ................................................................................................................................................ 33 

GoAnywhere IBM i Commands .................................................................................. 35 

Uninstalling GoAnywhere Services Product ............................................................ 36 Windows uninstall instructions ............................................................................................................. 36 Linux and UNIX uninstall instructions .................................................................................................. 36 IBM i uninstall instructions ................................................................................................................... 36 

License agreement and limited warranty .................................................................. 37 

Contacting Linoma Software ...................................................................................... 38 

Page 4: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Introduction GoAnywhere Servicestm is a secure file server that allows trading partners and employees to connect to your organization and easily exchange files within a fully managed and audited environment. Popular file transfer and encryption standards are supported without the need for proprietary client software. GoAnywhere Services is an on-premises solution that allows for localized control, user management and security of your data. GoAnywhere Services includes the following comprehensive features:

Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, Solaris and HP-UX FTP server component with support for SSL (Explicit SSL) SFTP server component for secure FTP transfers over SSH FTPS server component for secure FTP transfers over SSL (Implicit SSL) HTTPS web client for simple browser-based file transfers AS2 server component for receiving EDI and other documents over secured connections Highly scalable with support for multiple concurrent file transfer sessions Browser-based interface for all administrative and monitoring functions Unlimited administrative users with configurable individual roles Wizards and templates for creating trading partner accounts quickly Trading partner permission controls for specific services (FTP, SFTP, FTPS, HTTPS, AS2),

actions (e.g. upload, download, etc.) and directories Event Triggers - Send email alerts or perform actions on files when user-defined events occur

(e.g. upload, download, invalid login, etc.) Integrated key management tools for SSH Keys and SSL Certificates Detailed audit logs for all activity (e.g. logins, file transfers, errors and other events) No programming or special skills required to set up Integrates with GoAnywhere Directortm for a cohesive managed file transfer solution

2.5.0 Linoma Software Page 4

Page 5: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Administration Authorized users can utilize GoAnywhere Service’s web-based Administrator to perform configuration and monitoring within the product.

The following components are available within the Administrator:

Define global settings for GoAnywhere Services Configure the properties for the FTP, SFTP, FTPS, HTTPS and AS2 services Define administrative users, user groups and their permissions Define trading partner accounts (web users) Authorize services (e.g. FTP, SFTP, FTPS, HTTPS, AS2) to individual web users and groups Restrict web users to certain directories Grant permissions (upload, download, delete, rename, etc.) to individual web users and groups Create and manage event triggers and their actions Create and manage SSL certificates and SSH keys View the active sessions for logged-in users with the ability terminate (kick) sessions View audit logs using a variety of criteria (e.g. web user id, date, time, status, file name, remote

IP address, event, etc.). Optionally export those logs.

2.5.0 Linoma Software Page 5

Page 6: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 6

Pre-Installation Notes Port Number Usage GoAnywhere Services will utilize port numbers on the server for its various modules. Listed below are the default port numbers that will be used.

Port Number Description 9000 Administrator functions over HTTP 9001 Administrator functions over HTTPS 9005 Shutdown port for GoAnywhere Services 443 HTTPS/AS2 service for trading partners 21 FTP service for trading partners 990 FTPS service for trading partners 22 SFTP service for trading partners

These port numbers can be overridden either during the installation or at any time after the installation.

Page 7: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Installation − Windows GoAnywhere Services can be installed onto a Windows server for enterprise usage. GoAnywhere Services 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 Services which installs the product files into the directory of your choice. GoAnywhere Services will be implemented as a Windows “Service” which will automatically start (by default) when Windows starts. Requirements - Operating Systems supported: Windows 2003

Windows 2008 R2 Windows XP Windows Vista Windows 7

- Disk space: 125 MB

- Minimum memory: 256 MB

Installing GoAnywhere Services on Windows Perform the following steps to install the GoAnywhere Services product onto a Windows machine.

1. Login to the target Windows system as an administrator.

2. Download the GoAnywhere Services 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 Services 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 Services and select Start. c. Within seconds after starting the GoAnywhere Services, its status should be updated to

“Started”. If not, please contact Linoma Software technical support.

5. The installation and startup of GoAnywhere Services is complete. Now you should proceed to the “Initial Configuration” instructions on page 16.

Note: The GoAnywhere Services is configured in Windows as an “automatic” startup Service. This means that the GoAnywhere Services will automatically start whenever Windows starts.

2.5.0 Linoma Software Page 7

Page 8: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Installation – Linux GoAnywhere Services can be installed onto a Linux server for enterprise usage. GoAnywhere Services 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 graphical installation wizard is provided for GoAnywhere Services which installs the product files into the directory of your choice. Requirements - Disk space: 125 MB

- Minimum Memory: 256 MB

Installing GoAnywhere Services on Linux Perform the following steps to install the GoAnywhere Services onto a Linux system.

1. Login to the target Linux system as root.

2. Download the GoAnywhere Services 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 Services by following these instructions:

a. Open a Terminal window.

b. Change the working directory to the directory where GoAnywhere Services was installed (for example, cd /usr/local/Linoma_Software/GoAnywhere_Services)

c. Start the GoAnywhere Services by executing the following shell script: ./gaservices.sh start

5. The installation and startup of GoAnywhere Services is complete. Now you should proceed to the “Initial Configuration” instructions on page 16.

Tip: You can setup GoAnywhere Services so it starts automatically when the Linux system is booted. Please refer to your operating system manual for more details on setting up auto-start services. You can execute gaservices.sh from your startup scripts.

2.5.0 Linoma Software Page 8

Page 9: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 9

Installation − UNIX, AIX, HP-UX, Solaris GoAnywhere Services 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 Services which installs the product files into the directory of your choice. Requirements - Disk space usage: 125 MB

- Memory usage: 256 MB

- JRE (Java Runtime Environment) 1.5.0 or higher [ Note: 1.6.x is recommended ]

Installing GoAnywhere Services Perform the following steps to install GoAnywhere Services onto a UNIX, Solaris (SPARC and Intel), AIX or HP-UX server.

1. Login to the server as root.

2. Download the GoAnywhere Services 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 gaservices1_0_0_unix.sh)

6. Run the installer (e.g. ./gaservices1_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.5.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. ./gaservices1_0_0_unix.sh).

8. Follow the on-screen instructions to complete the installation.

9. JCE policy files must be copied to the JRE’s (Java Runtime Environment) security folder in order to support encryption functions in GoAnywhere Services: 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 Services 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 Services installation folder) to the jre/lib/security folder (located under the JRE's installation directory).

(continued on next page)

Page 10: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

10. Start the GoAnywhere Services by following these instructions:

a. Open a Terminal window.

b. Change the working directory to the directory where GoAnywhere Services is installed (for example, cd /usr/local/Linoma_Software/GoAnywhere_Services)

c. Start the GoAnywhere Services by executing the following shell script: ./gaservices.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 JRE’s home directory (e.g. export JAVA_HOME=/usr/lib/jvm/java-1.5.0-sun/jre) and try starting GoAnywhere Services again.

11. The installation and startup of GoAnywhere Services is complete. Now you should proceed to the “Initial Configuration” instructions on page 16.

Tip: You can setup GoAnywhere Services so it starts automatically when the system is booted. Please refer to your operating system manual for more details on setting up auto-start services. You can execute gaservices.sh from your startup scripts.

2.5.0 Linoma Software Page 10

Page 11: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 11

Installation – IBM i (iSeries) GoAnywhere Services can be installed on IBM i systems which meet the following requirements. Requirements – Operating System: i5/OS V5R3 or higher – Disk space: 75 MB – Memory: 256 MB Required licensed programs The following IBM i licensed programs are prerequisites to the installation of GoAnywhere Services, which are dependent on i5/OS release.

i5/OS Release

Licensed Program

ProductOption

Description

V5R3 5722JV1 7 Java Developer Kit 5.0 5722AC3 *BASE Crypto Access Provider 5722SS1 30 QShell 5722SS1 33 Portable App Solutions Environment

V5R4 5722JV1 8 J2SE 5.0 32 bit 5722SS1 30 QShell 5722SS1 33 Portable App Solutions Environment

V6R1 5761JV1 8 J2SE 5.0 32 bit 5761SS1 30 QShell 5761SS1 33 Portable App Solutions Environment

V7R1 5761JV1 8 J2SE 5.0 32 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. (continued on next page)

Page 12: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 12

Required PTFs The following IBM i Program Temporary Fixes (PTFs) and Group PTFs are prerequisites to installing GoAnywhere.

V5R3 Individual PTF TL04153 for LICPGM 5722999 Group PTF SF99530 (minimum level of 4153) Individual PTF SI17619 for LICPGM 5722SS1 (If you want to

encrypt or zip 4Gb+ sized files) V5R4 Group PTF SF99291 (minimum level of 17) V6R1 Group PTF SF99562 (minimum level of 5) V7R1 Group PTF None

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 Services installation process:

A IBM i library will be created, which will contain the GoAnywhere Services commands and program objects. The default library name is GASERVICES, which can be changed during installation.

An IFS folder will be created, which will contain the GoAnywhere Services software components. The default IFS folder name is /linoma/gaservices, which can be changed during installation.

Optional: 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. - For V5R3, this directory is "/QIBM/ProdData/Java400/jdk15/lib/security". - For V5R4 and higher, the directory is "QOpenSys/QIBM/ProdData/JavaVM/jdk50/32bit/jre/lib/security" or "QOpenSys/QIBM/ProdData/JavaVM/jdk60/32bit/jre/lib/security"

Page 13: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 13

Installing GoAnywhere Services on IBM i Perform the following steps to install the GoAnywhere Services 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/GASERVICES)

3. The GoAnywhere Services 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 native FTP server on the IBM i, you can issue the i5/OS command of STRTCPSVR SERVER(*FTP)

4. Download the GoAnywhere Services 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 GASERVICES.SAVF.

6. FTP the extracted GASERVICES.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 (switches the FTP session to binary mode) ftp> LCD \<tempdir> (<tempdir> is the PC directory containing the file

named GASERVICES.SAVF) ftp> CD qgpl (changes the remote directory to the QGPL library) ftp> PUT gaservices.savf gaservices (sends the PC file GASERVICES.SAVF to the

IBM i Save file named GASERVICES) ftp> QUIT (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/GASERVICES)

8. Delete the temporary Save file by executing the following i5/OS command (optional): DLTF FILE(QGPL/GASERVICES)

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) (continued on next page)

Page 14: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

10. Prompt (F4) the command QTEMP/INSTALLGAS for installing GoAnywhere Services. The following screen appears.

Install GoAnywhere Services (INSTALLGAS) Type choices, press Enter. Install library . . . . . . . . . . GASERVICES Install IFS directory . . . . . . . '/linoma/gaservices' Install policy files . . . . . . . *YES *YES, *NO Administration port . . . . . . . . 9000 1-65534 Secure administration port . . . . 9001 1-65534 HTTPS service port . . . . . . . . 443 1-65534 FTP service port . . . . . . . . . 21 1-65534 FTPS service port . . . . . . . . . 990 1-65534 SFTP service port . . . . . . . . . 22 1-65534 Shutdown port . . . . . . . . . . . 9005 1-65534

Parameter descriptions: Field name Description Install library The library to contain the GoAnywhere Services product

objects. The specified library name must not already exist. Install IFS directory The directory to contain the GoAnywhere Services product

files. The 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 Services. It is strongly recommended to use the default setting of *YES.

Administration port The port number that the GoAnywhere Services Administrator runs under (using HTTP). Default is 9000. *

Secure administration port The port number that the GoAnywhere Services Administrator runs under (using HTTPS). Default is 9001. *

HTTPS service port The port number to run the HTTPS/AS2 service under (for trading partner file transfers). Default is 443. *

FTP service port The port number to run the FTP service under (for trading partner file transfers). Default is 21. *

FTPS service port The port number to run the FTPS service under (for trading partner file transfers). Default is 990. *

SFTP service port The port number to run the SFTP service under (for trading partner file transfers). Default is 22. *

Shutdown port The port number which the GoAnywhere Services will listen to for shutdown requests. Default is 9005. *

* 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 INSTALLGAS command, press enter to start

the installation process. (continued on next page)

2.5.0 Linoma Software Page 14

Page 15: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

12. Prompt (F4) the command GASERVICES/STRGAS for starting the GoAnywhere Services subsystem. The following screen will be displayed.

Start GoAnywhere Services (STRGAS) Type choices, press Enter. Server user profile . . . . . . . . *CURRENT Name, *CURRENT

For the “Server User Profile” parameter, keep the default of *CURRENT if you want to run the GoAnywhere Services application under your user profile. Otherwise, specify a different user profile to run the GoAnywhere Services application server under.

Note: The user profile specified on the STRGAS 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 Services is installed. For security purposes, you may want to create a new user profile and consistently use that profile on the STRGAS command. Then you would only have to grant authority for the GoAnywhere installation IFS folders to that user profile.

13. Press enter on the STRGAS command to start the GoAnywhere Services subsystem.

14. Execute the WRKACTJOB (Work with Active Jobs) command to confirm that the GoAnwhere Services subsystem is running. You should find a subsystem which has the same name as the library name that was specified on the INSTALLGAS command in step 10 (named GASERVICES by default). This subsystem should contain one job, which is the GoAnywhere Services application.

15. The installation and startup of GoAnywhere Services is complete. Now you should proceed to the

“Initial Configuration” instructions on page 16. Tip: The GoAnywhere Services can automatically start when the System i is powered up

(IPL). To perform this automatic startup, place the STRGAS command in the System i startup CL program (after the start of TCPIP). CL example: 0001.00 QSYS/STRTCP /* Start TCP */ 0002.00 DLYJOB DLY(120) /* Wait for TCP to fully start */ 0003.00 GASERVICES/STRGAS /* Start GoAnywhere Services */

2.5.0 Linoma Software Page 15

Page 16: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Initial Configuration

Follow the instructions below to request a license key, test the installation and perform initial configuration of GoAnywhere Services.

1. To access the GoAnywhere Services 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 GoAnywhere Services and [portnumber] is the port number of the GoAnywhere Services Administrator. The default HTTP port for the Administrator is 9000. Example: http://myserver:9000

Otherwise, to access the GoAnywhere Services 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 9001. Example: https://myserver:9001

2. You should then be presented with a login screen for the GoAnywhere Services Administrator.

3. Login with your user name and password. The default user name is administrator and the default

password is goanywhere.

4. The GoAnywhere Services Administrator dashboard should then be displayed.

5. A product license key (either a trial key or permanent key) is required to use GoAnywhere Services. 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.

2.5.0 Linoma Software Page 16

Page 17: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services 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. Review and adjust the global settings in GoAnywhere Services 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. Be sure to specify the settings for your SMTP server on the “SMTP Settings” tab. This will

allow GoAnywhere Services to send email alerts when certain events occur. e. Note that some changes to the Global Settings will take effect only when GoAnywhere Services

is restarted.

8. By default, GoAnywhere Services will authenticate user passwords against its own internal database. Optionally you can configure GoAnywhere Services 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 Methods” menu option. c. Click on the link “Add Login Method”. d. Key in a name (to assign the login method) and then choose the login type. e. If you choose Windows Active Directory as the login type:

• 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.

• Specify the Domain name of the Active Directory. For example, MYDOMAIN. f. If you choose Generic LDAP as the login type:

• 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.

g. If you choose IBM i as the login type: • 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. From the Login Methods screen, choose the default login method and click the “Save” button.

2.5.0 Linoma Software Page 17

Page 18: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

9. The passwords for the included administrator and root user ids will always be authenticated against GoAnywhere Services 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.

10. Manage the settings for the services (FTP, FTPS, SFTP, HTTPS, AS2) which you want to make available to your trading partners by following the instructions below:

a. Select the “Administration” drop-down menu. b. Choose the “Manage Services” menu option. c. Follow the instructions in the on-line help to learn how to adjust settings for the various

services. d. After adjusting any settings, you can click on the icon to start (or restart) the service.

11. Be sure to read the backup instructions on page 30 to learn how to backup GoAnywhere Services configurations and settings, which should be performed on a regular basis.

12. Also be sure to read the Firewall recommended settings on page 22.

2.5.0 Linoma Software Page 18

Page 19: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Customizing Installation Settings Changing GoAnywhere Services Port Numbers By default, GoAnywhere Services administrator will utilize port numbers 9000, 9001 and 9005 on your system for the following functions:

• 9000 is the default HTTP port which users can connect (from their browsers) for performing administration in GoAnywhere Services.

• 9001 serves the same function as port 9000, but uses a HTTPS (SSL-protected) connection.

• 9005 is the default port for requesting a shutdown of GoAnywhere Services from a remote system.

You can change these port numbers within the GoAnywhere Services browser-based administrator interface, or by using the CFGGAS command for IBM i or by making direct changes to a GoAnywhere Services configuration file.

Changing ports using the browser interface

1. Open a browser window and log into the GoAnywhere Services administrator.

Please note that you cannot change the shutdown port through the browser interface.

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 Services server must be restarted for the changes to take effect.

Changing ports using the CFGGAS command on IBM i

1. Log in to the IBM i using a terminal session. 2. End the GoAnywhere Services subsystem by running the command ENDGAS 3. Run the command CFGGAS 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 Services by running the command STRGAS.

Changing ports by manually editing the configuration file 1. Stop the GoAnywhere Services 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 Services. 3. Change the port number for the HTTP or HTTPS connectors. Example:

<Connector port="9000" /> 4. Change the port number for the shutdown listener. Example:

<Server port="9005" shutdown="SHUTDOWN"> 5. Save the configuration file. 6. Start the GoAnywhere Services server.

2.5.0 Linoma Software Page 19

Page 20: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Disabling HTTP or HTTPS Connectors GoAnywhere Services is initially configured to support both HTTP and HTTPS (SSL) connectors for its web-based Administrator. If you want to disable one of these connectors, then follow the instructions below.

a. Stop the GoAnywhere Services 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 Services. c. Locate the following XML code:

<Server port="9005" shutdown="SHUTDOWN"> <Service name="Catalina"> <Connector name=”default” port="9000" />

<Connector name="secured" port="9001" protocol="HTTP/1.1" SSLEnabled="true" enableLookups="false" disableUploadTimeout="true" scheme="https" secure="true" clientAuth="false" sslProtocol="TLS" algorithm="SunX509" keystoreFile="[Install_Dir]\userdata\keys\x509\privateKeys.jks" keystorePass="goanywhere" keyAlias="test" />

</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 Services server.

Note: To comment out XML code, enclose the code with the following indicators <!-- to begin the comment --> to end the comment

Example: <!-- <Connector port="9000" /> -->

2.5.0 Linoma Software Page 20

Page 21: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 21

SSL (HTTPS) Configuration A certificate is shipped with GoAnywhere Services, which is used (by default) when a user connects to the GoAnywhere Services 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 Services to. To avoid these host mismatch warnings, it is recommended to create your own certificate (for your machine’s host name) and update the GoAnywhere Services configuration file with the new certificate information.

Follow the instructions below to create a new certificate and update the GoAnywhere Services configuration file:

1. From within the GoAnywhere Services 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 Services is installed.

2. Open the configuration file [Install_Dir]/tomcat/conf/server.xml, where [Install_Dir] is the installation directory for GoAnywhere Services. Then modify the value in the keyAlias attribute to be the alias of the new certificate you created in step 1.

Page 22: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Firewall Recommendations If you want to make GoAnywhere Services available to external clients over the internet, it is important that you only open certain port numbers to the machine in which GoAnywhere Services is installed. This can be controlled through your firewall settings. The firewall settings will depend on whether if the GoAnywhere Services software is installed in your DMZ (Demilitarized Zone) or the Private (internal) network, and whether if it is used in conjunction with Linoma Software’s GoAnywhere GatewayTM product. The following diagrams show the firewall settings to use if the default port numbers were used during the installation of GoAnywhere Services. (Please note that the IP addresses shown are for demonstration purposes only.) Installation in the DMZ This diagram illustrates GoAnywhere Services as installed in the DMZ.

Notes: In order to administer GoAnywhere Services from any workstations in the private network, ports 9000 and 9001 will need to be opened (through the backend firewall) from the private network to GoAnywhere Services in the DMZ. If external trading partners need access to the file transfer protocols (e.g. SFTP, FTP, HTTPS, AS2, FTPS) in GoAnywhere Services, those port numbers (e.g. 21, 22, 443, 990) need to be opened through the frontend firewall to GoAnywhere Services in the DMZ. Additionally, if employees (on the private network) need to access those file transfer protocols in GoAnywhere Services, the port numbers will need to be opened through the backend firewall from the private network to GoAnywhere Services in the DMZ. If trigger events in GoAnywhere Services need to call Projects in the GoAnywhere Director product, then ports 8000 and 8001 need to be opened (through the backend firewall) from GoAnywhere Services to GoAnywhere Director in the private network.

2.5.0 Linoma Software Page 22

Page 23: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Installation in the Private Network This diagram illustrates GoAnywhere Services as installed in the Private network.

Notes: If external trading partners need access to the file transfer protocols (e.g. SFTP, FTP, HTTPS, AS2, FTPS) in GoAnywhere Services, those port numbers (e.g. 21, 22, 443, 990) need to be opened through the firewall to GoAnywhere Services in the private network.

2.5.0 Linoma Software Page 23

Page 24: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Installation with GoAnywhere Gateway This diagram illustrates GoAnywhere Services as installed in the Private network, in conjunction with GoAnywhere Gateway (a separate licensed product from Linoma Software) in the DMZ. This configuration allows your organization to keep sensitive files, credentials and logs in the Private network. This configuration also does not require any incoming ports opened into the Private network, which provides a high level of security.

Notes: In order to establish control and data channels from GoAnywhere Services to GoAnywhere Gateway, ports 9100 and 9101 will need to be opened (through the backend firewall) from the Private Network to GoAnywhere Gateway in the DMZ. Port 9102 will also need to be opened from the Private Network to GoAnywhere Gateway for Forward Proxy services. The port numbers (e.g. 21, 22, 443, 990 and 30000-32000) for the desired file transfer protocols (e.g. FTP, SFTP, HTTPS, FTPS, AS2) need to be opened through the frontend firewall to GoAnywhere Gateway in the DMZ. More information about GoAnywhere Gateway can be found at www.GoAnywhereMFT.com .

2.5.0 Linoma Software Page 24

Page 25: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 25

Product Administration Starting and Stopping GoAnywhere Services Windows instructions

Start the GoAnywhere Services 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 Services and select Start. Within seconds after starting the GoAnywhere Services, its status should be updated to “Started”.

Stop the GoAnywhere Services 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 Services and select Stop. Linux and UNIX instructions

Start the GoAnywhere Services by following these instructions:

1. Open a Terminal window.

2. Change the working directory to the directory where GoAnywhere Services is installed (for example, cd /usr/local/Linoma_Software/GoAnywhere_Services)

3. Start the GoAnywhere Services by executing the following shell script: ./gaservices.sh start

Stop the GoAnywhere Services by following these instructions:

1. Open a Terminal window.

2. Change the working directory to the directory where GoAnywhere Services is installed (for example, cd /usr/local/Linoma_Software/GoAnywhere_Services)

3. Stop the GoAnywhere Services by executing the following shell script: ./gaservices.sh stop

IBM i instructions Start the GoAnywhere Services by executing the i5/OS command of STRGAS

Stop the GoAnywhere Services by executing the i5/OS command of ENDGAS The STRGAS and ENDGAS commands are located in the GoAnywhere Services installation library, which is named GASERVICES by default.

Page 26: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 26

onfiguring HTTP Proxy

your organization uses a Proxy Server, then you need to configure those proxy settings in GoAnywhere

s from the main drop-down menu.

. DIRECT represents a direct h as

erver.

rver. This is only necessary if the

o connect to the proxy server. This is only necessary if the

de instructions on the following pages.

Upgrading GoAnywhere Services Updates (new versions) for GoAnywhere Services can be downloaded from Linoma Software’s server. Read the instructions below to learn how to configure the Proxy settings (if your organization uses a proxy server) and then read the platform-specific instructions (on the following pages) on how to apply the updates. C IfServices before you can retrieve web updates:

1. Click Administration > Global Preference

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 SOCKSconnection, or the absence of a proxy. HTTP represents proxy for high-level protocols sucHTTP 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 s

6. Specify the username to use in order to connect to the proxy seproxy server requires authentication.

7. Specify the password to use in order tproxy server requires authentication.

8. Click the Save button.

9. Continue with the upgra

Page 27: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Windows upgrade instructions 1. Login to GoAnywhere Services browser-based Administrator.

2. Select the “Administration” drop-down menu and then choose the “Check for Updates” option. Follow the instructions on that screen to download any updates.

3. After the updates are downloaded, then login to the Windows system as an administrator.

4. Go to Control Panel -> Administrative tools -> Services.

5. In the Services window, right-click on the GoAnywhere Services and select Stop. Within seconds after stopping the GoAnywhere Services, its status should change to blanks.

6. Open a Command window and change the directory to $INSTALL_DIR\upgrader, where $INSTALL_DIR is the directory where GoAnywhere Services is installed. The default install directory is C:\Program Files\Linoma Software\GoAnywhere Services.

7. Run the batch file named upgrade.bat to start the upgrade process. When the upgrade finishes, a message should indicate that the upgrade was successful.

8. Restart the service by right-clicking on the GoAnywhere Services and select Start. Its status should be updated to “Started”.

2.5.0 Linoma Software Page 27

Page 28: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Linux and UNIX upgrade instructions 1. Login to GoAnywhere Services browser-based Administrator.

2. Select the “Administration” drop-down menu and then choose the “Check for Updates” option. Follow the instructions on that screen to download any updates.

3. After the updates are downloaded, then login to the Linux system as root.

4. Open a Terminal window.

5. Change the working directory to the directory where GoAnywhere Services was installed (for example, cd /usr/local/Linoma_Software/GoAnywhere_Services)

6. Stop the GoAnywhere Services by executing the following shell script: ./gaservices.sh stop

7. Change the working directory to the GoAnywhere Services subdirectory of upgrader. (for example, cd upgrader)

8. Upgrade the GoAnywhere Services product by executing the following shell script: ./upgrade.sh

9. When the upgrade finishes, a message should indicate that the upgrade was successful.

10. Change the working directory back to the GoAnywhere Services installation directory (for example, cd /usr/local/Linoma_Software/GoAnywhere_Services)

11. Restart the GoAnywhere Services by executing the following shell script: ./gaservices.sh start

2.5.0 Linoma Software Page 28

Page 29: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

IBM i upgrade instructions 1. Login to GoAnywhere Services browser-based Administrator.

2. Select the “Administration” drop-down menu and then choose the “Check for Updates” option. Follow the instructions on that screen to download any updates.

3. After the updates are downloaded, then login to the IBM i with the QSECOFR user profile OR with a profile which has *ALLOBJ authority.

4. Execute the following i5/OS commands. These commands are located in the GoAnywhere installation library, which is named GASERVICES by default. a. End the GoAnywhere Services by executing the ENDGAS command. b. Wait until the GoAnywhere Services subsystem is ended. c. Apply the update by executing the UPGRADEGAS command. d. Start the GoAnywhere Services by executing the STRGAS command.

2.5.0 Linoma Software Page 29

Page 30: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 30

Backups and Replication Backing up GoAnywhere Services User Data All user data and configurations for GoAnywhere Services are stored in a folder called userdata, which is located under the GoAnywhere Services installation directory. The default paths to the userdata folder for each platform is listed below: - IBM i: /linoma/gaservices/userdata - Windows: C:\Program Files\Linoma Software\GoAnywhere Services\userdata - Linux and UNIX: /usr/local/Linoma_Software/GoAnywhere_Services/userdata

IMPORTANT: You should backup the GoAnywhere Services 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 Services: If you plan to perform backups while GoAnywhere Services is running, then you should exclude the subfolder userdata/database/gaservices 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.

Page 31: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

Automatically Backing Up the GoAnywhere Services Database (to Disk) These instructions only apply if using the default embedded Derby database in GoAnywhere Services.

2.5.0 Linoma Software Page 31

By default, GoAnywhere Services 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 Services. By default, database backup files are retained for the last 7 days.

If not using the embedded Derby database, you should backup the GoAnywhere Services tables (in your designated database) using your regular database backup procedures.

Follow the instructions below to modify the database backup settings:

1. From the main menu, select Administration > Database Manager. 2. The current backup settings will appear on the screen.

• Enable Database Backup – Specify whether or not the GoAnywhere Services 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 (1–30) 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. Click the Save button.

Page 32: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 32

Manually Backing Up the GoAnywhere Services Database (to Disk) These instructions only apply if using the default embedded Derby database in GoAnywhere Services. To backup the GoAnywhere Services 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.

Page 33: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 33

Replicating GoAnywhere Services User Data (for High Availability) GoAnywhere Services user data can be replicated to another system for high availability and failover purposes. GoAnywhere Services 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 Services, 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 Services 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 Services installation on the HA machine to make sure it works properly.

4. Shut down the GoAnywhere Services subsystem/service on the HA machine, since GoAnywhere Services 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 Services installation directory on the production machine. The userdata folder contains all user data and configurations for GoAnywhere Services. Make sure to include all the subfolders under the userdata folder, except DO NOT replicate the subfolder named /userdata/database/gaservices/ since there will be a lock on that subfolder while GoAnywhere Services is running. This subfolder contains the embedded database, which is saved nightly (by default) to the subfolder named userdata/database/backups.

WARNING: If you want to replicate the entire GoAnywhere Services installation directory, then do not replicate the file named gaservices.lic since that file contains the 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 Services on the HA machine and will not allow it to execute. Failover The steps to follow in order to run GoAnywhere Services 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 Services: On the HA machine, unzip the latest backup of the GoAnywhere Services database (found in subfolder named userdata/database/backups) into the subfolder named /userdata/database/gaservices. 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 Services subsystem/service on the HA machine.

(continued on next page)

Page 34: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 34

If your production machine is running and you want to switch to the HA machine:

1. If using the embedded Derby database in GoAnywhere Services: On the production machine, perform a manual backup of the GoAnywhere Services database by following the instructions on page 32.

2. Shut down the GoAnywhere Services subsystem/service on the production machine.

3. If using the embedded Derby database in GoAnywhere Services:

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/gaservices folder on the HA machine.

4. Start the GoAnywhere Services subsystem/service on the HA machine.

Page 35: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 35

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. The i5/OS commands can be found in the installation library, which is GASERVICES by default. Listed below is an alphabetical listing of the commands:

Command Command Description Comments CFGGAS Configure GoAnywhere

Services Allows users (with *SECADM authority) to change certain properties in the GoAnywhere Services installation.

DSPPRDINF Product information Displays the current version number of GoAnywhere Services, the port numbers used and the IBM i serial number and processor group.

ENDGAS End GoAnywhere Services Ends the GoAnywhere Services STRGAS Start GoAnywhere Services Starts the GoAnywhere Services UPGRADEGAS Upgrade GoAnywhere Upgrades the GoAnywhere Services

Page 36: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 36

indows uninstall instructions

erform the following steps to uninstall the GoAnywhere product from Windows:

Step Description

Uninstalling GoAnywhere Services Product This section describes how to uninstall the GoAnywhere Services product. CAUTION: All GoAnywhere Services configurations, resources and project definitions will be deleted during the uninstall process. W P

1 End the GoAnywhere Services on the Windows system. 2 Browse to the installation directory of GoAnywhere Services. The default install directory is

C:\Program Files\Linoma Software\GoAnywhere Services.

3 Run the file named uninstall.exe to uninstall the product.

inux and UNIX uninstall instructions

erform the following steps to uninstall the GoAnywhere Services product from Linux:

Step Description

L P

1 Verify that no jobs are currently running in the GoAnywhere Services Administrator 2 Login to the Linux system as root and open a Terminal window. 3 Change the working directory to the directory where GoAnywhere Services was installed

(for example, cd /usr/local/Linoma_Software/GoAnywhere_Services) 4 Stop the GoAnywhere Services by executing the following shell script:

./gaservices.sh stop 5 ere Services product by executing the following shell script: Uninstall the GoAnywh

./uninstall.sh

M i uninstall instructions

erform the following steps to uninstall the GoAnywhere Services product from the IBM i:

Step Description Example Commands

IB P

1 End the GoAnywhere Services. AS - GASERVICES/ENDG2 Verify that there are no locks on the

GoAnywhere Services library. Default library name is GASERVICES.

- WRKOBJLCK OBJ(GASERVICES) OBJTYPE(*LIB)

3 where Services - DLTLIB LIB(GASERVICES) Delete the GoAnylibrary. Default library name is GASERVICES.

4 where Services - RMVLNK OBJLNK('/linoma/gaservices/*.*') Delete the GoAnyfolder from the IFS. The default main folder name is \linoma\gaservices.

- RMVDIR DIR('/linoma/gaservices')

Page 37: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 37

License agreement and limited warranty

The GoAnywhere Services 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 GOANWHERE 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. B. You may not alter, modify, decompile, disassemble or reverse engineer GOANYWHERE, or otherwise attempt to reproduce

the source code thereof. C. 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. D. 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.

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.

Page 38: Installation and Administration Guide · Table of Contents . ... Installs to Windows, Linux, AIX, IBM i (iSeries), UNIX, ... GoAnywhere Services Installation and Administration Guide

GoAnywhere Services Installation and Administration Guide

2.5.0 Linoma Software Page 38

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. Linoma’s success has been built on being very responsive to our customer’s 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 [email protected] Support [email protected] Website www.GoAnywhereMFT.com Phone Numbers Toll-free: 1-800-949-4696 Outside USA: (402) 944-4242 Fax: (402) 944-4243 Address Linoma Software 1409 Silver Street Ashland, NE 68003 USA


Recommended