RMFT Product Suite Installation Guide Software Version 2.5 September 5, 2011 RepliWeb, Inc., 6441 Lyons Road, Coconut Creek, FL 33073 Tel: (954) 946-2274, Fax: (954) 337-6424 E-mail: info@repliweb.com, Support: http://support.repliweb.
RMFT Product Suite Installation Guide September 5, 2011 Copyright © 2000-2011 by RepliWeb, Inc. This product includes cryptographic software written by Eric Young (eay@cryptsoft.com) The information in this document has been compiled with care, but RepliWeb makes no warranties as to accurateness or completeness, as the software described herein may be changed or enhanced from time to time.
RMFT Product Suite Installation Guide Table of Contents Introduction ...........................................................................................................6 Installation at a Glance .........................................................................................7 1. Installation Requirements ................................................................................8 Minimum System Requirements ..............................................................................
RMFT Product Suite Installation Guide Optional Parameters ................................................................................................... 47 Creating and Distributing Profiles ............................................................................... 47 Upgrading RMFT Desktop Client ................................................................................ 48 A. RMFT Port Requirements ...............................................................................
RMFT Product Suite Installation Guide Preface Purpose This guide describes how to install the RMFT Product Suite. You can install the entire RMFT Product Suite or specific components according to your needs. Audience RMFT administrators. Scope This guide does not provide operating instructions for the installed components. For operating instructions, please refer to the relevant user guides.
RMFT Product Suite Installation Guide Introduction RepliWeb Managed File Transfer (RMFT) is a turnkey solution for managed, enterprise-scale file exchange. RMFT greatly improves the manageability, reliability, efficiency and security of file workflows and file transfers. RMFT's userfriendly Web interface enables end-users to exchange files with ease, while fully automated server-to-server file transfer and automated file processing provide complete "hands-off" operation.
RMFT Product Suite Installation Guide Installation at a Glance Installation at a Glance RMFT can be installed on a single server, on two servers (one in the intranet and one in the DMZ) or on an MS-Cluster. The type of installation that you choose will largely depend on how RMFT will be used within your organization. For instance, if RMFT is only going to be used for internal file transfer, then installation on a single server should be sufficient.
RMFT Product Suite Installation Guide 1. Installation Requirements 1. Installation Requirements The following section describes the installation requirements for RMFT Product Suite v2.5 and each of its components. Minimum System Requirements Database Requirements IIS Requirements Minimum System Requirements Before installing RMFT Product Suite v2.5 or any of its components make sure that the following minimum requirements have been met. For information on installing individual components, see 3.
RMFT Product Suite Installation Guide 1. Installation Requirements RMFT CLI and RMFT Java CLI Windows 2000 and above Pentium 3/4 256MB of RAM 10MB of available hard disk space SuperFAST Daemon and FASTCopy Daemon Windows 2000 and above Pentium 4 512MB of RAM 20MB of available hard disk space RepliWeb, Inc.
RMFT Product Suite Installation Guide 1. Installation Requirements Database Requirements RMFT stores system entities (user profiles, distribution lists, etc.), and package processing data in its database for immediate availability. Thus, to be able to operate properly, RMFT Server must be connected to one of the supported database types. The database can either be installed on the same machine as RMFT Server or on a remote machine.
RMFT Product Suite Installation Guide 1. Installation Requirements 50 logged on users, the connection count can range between 50 to 100 averaging at 75. Note: These calculations are based on logged on users. Other processes managed by RMFT such as Host-to-Host transfers, inspection policies and inbox processing (if configured) also open database connections.
RMFT Product Suite Installation Guide 1. Installation Requirements Oracle Prerequisites If you want RMFT to communicate with an Oracle database, make sure that the following prerequisites have been met. Note: Oracle Client 64-bit is not supported. Character Set Encoding Compatibility To be compatible with RMFT 2.5, the Oracle NLS_CHARACTERSET encoding needs to be AL32UTF8 and the NLS_NCHAR_CHARACTERSET encoding needs to be AL16UTF16.
RMFT Product Suite Installation Guide 1. Installation Requirements User System Permissions: CREATE ANY VIEW - Default SELECT ANY DICTIONARY - Default UNLIMITED TABLESPACE - Default Changing the Default Permissions of the Oracle Client Installation Directory For proper operation, RMFT requires the Internet Guest Account and the Launch IIS Process Account users to have Read & Execute, List Folder Contents and Read permissions. The default Oracle client installation does not grant these permissions.
RMFT Product Suite Installation Guide 1. Installation Requirements The Select Users or Groups dialog box opens. 4. Click Advanced. The advanced Select Users or Groups dialog box opens. 5. Click Find Now. RepliWeb, Inc.
RMFT Product Suite Installation Guide 1. Installation Requirements A list of all Users, Groups and Built-in security principals is displayed. 6. Select the names beginning with IUSR_ and IWAM_ as shown below. Note: On Windows 2008 Server, the IWAM user does not exist. 7. Click OK. RepliWeb, Inc.
RMFT Product Suite Installation Guide 1. Installation Requirements The names are added to the Enter the object names to select list. 8. Click OK. The user names are added to the Group or user names list in the Security tab. 9. Select Internet Guest Account and then select the Read & Execute, List Folder Contents and Read check boxes in the Allow column. Click Apply. 10.
RMFT Product Suite Installation Guide 1. Installation Requirements The Advanced Security Settings for oracle dialog box opens. 12. Hold the Shift button down and select the Internet Guest Account and Launch IIS Process Account entries. 13. Select the Replace permission entries on all child objects with entries shown here that apply to child objects check box. Click OK. The following warning is displayed. 14. Click Yes. 15. Open the Windows Services console and restart the IIS Admin service.
RMFT Product Suite Installation Guide 1. Installation Requirements IIS Requirements To enable RMFT Web Client users to upload and download packages/files to/from RMFT Server, Microsoft IIS 6.0 or above must be installed on the RMFT Server machine before you install RMFT Server. Additionally, if you require users to establish a secure connection to RMFT Server, you must install an appropriate certificate on the Default Web Site of the IIS.
RMFT Product Suite Installation Guide 1. Installation Requirements The files in the following table are located under the RMFT root directory (C:\RMFT by default). File to Exclude from Scan Potential Problems \Config\bhub.cf RMFT will not connect to RMFT Database. Inability to connect to RMFT manager. System Jobs will not function properly. RMFT malfunction. RepliWeb, Inc.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite 2. Installing the Full RMFT Product Suite The RMFT Product Suite can also be installed in user mode. This effectively insulates the operating system from RMFT processes. To install RMFT Product Suite v2.5: 1. Copy the RMFT self-extracting installation file (RMFT_.exe) to a directory on your computer. 2. Double-click RMFT_.exe. Note: On Windows Server 2008, right-click the RMFT_.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite The End-User License Agreement screen is displayed. 4. Select I accept the terms in the License Agreement and then click Next. The Custom Setup screen is displayed. 5. To change the default installation directory, click Browse and select a different directory. RepliWeb, Inc.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite Note: In addition to the application files, all data transferred using RMFT will also reside on the same drive, but in a different location (specified at a later stage of the installation). Therefore, make sure that the selected drive has sufficient disk space to store the application files and the transferred data.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite The RepliWeb RMFT Product Suite installation begins. When the installation completes, the RMFT Site Configurator opens. The RMFT Site Configurator requires you to configure database connectivity, e-mail settings, RMFT Web Site security options, and other site-specific settings. If you quit the RMFT Site Configurator at any time, you will be prompted to run it when you open the RMFT Management Console. RepliWeb, Inc.
RMFT Product Suite Installation Guide 8. 2. Installing the Full RMFT Product Suite Click Next. The Choose a Database Type screen is displayed. 9. Choose either: Install Microsoft SQL Express to install Microsoft SQL Express on the RMFT Server machine. Note: The Install Microsoft SQL Express option will not be available if one of the supported database types is already installed on the RMFT Server machine. -ORConnect to an existing database to connect to a database within your organization.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite The DSN Properties screen is displayed. Note: The fields displayed in the DSN Properties screen are determined by the database type that you selected. A description of the fields is provided in step 10 below. If you selected MS-SQL, the following screen is displayed. If you selected Oracle, the following screen is displayed. 12. To enable database connectivity, complete the fields in the DSN Properties screen as follows: a.
RMFT Product Suite Installation Guide b. 2. Installing the Full RMFT Product Suite This step applies to SQL Server/SQL Server Express only. In the Server name/IP address field, specify the name of IP address of the machine on which the database server is installed.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite The Fully Qualified Domain Name screen is displayed. The RMFT administrator can configure RMFT Server to notify users when new packages are distributed to their RMFT Server inbox. The notification e-mails can contain hyperlinks that allow users to access the new package directly (after logging in) or download the packages files without logging in.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite 15. Read the embedded text and then either keep the default RMFT root directory or change the RMFT root directory. Note The root directory must reside on the same drive as the RMFT installation. If you specify a different drive, a warning will be displayed. 16. Click Next. The RMFT Login Credentials screen is displayed. 17. In the User, Password and Domain fields, enter the credentials under which you want RMFT Server to run.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite The Authorized RMFT Administrators screen is displayed. You can enable other administrators to manage the RMFT application by adding their accounts to the list of authorized RMFT Server administrators. The default administrator account (using the credentials that you entered in the previous screen) can be deleted after you add other accounts. a.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite The E-Mail Settings screen is displayed. Your e-mail settings are required in order to send e-mails to users notifying them of new or unopened packages. You can also request to receive a notification in the unlikely event that a system failure occurs. 20. Configure e-mail settings as follows: a. In the SMTP server name/address field, specify the server name or address of your SMTP server. b.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite Scheduler services (which are critical for normal operation) will be stopped. 21. Click Next. If you provided your organization’s SMTP details, the Unauthenticated Download screen will be displayed. If you did not provide your SMTP details, continue from The RMFT Web Site Setup screen is displayed. 22.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite Accept client certificates - to enable users to authenticate their identity to RMFT Server, even if not required. This option requires an appropriate certificate to be installed on the IIS Server. Require client certificates - to require users to authenticate their identity when connecting to RMFT Server (only available if the Require secure channel (SSL) check box is selected).
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite If you configured the E-mail Settings screen in step 20, the Unauthenticated Download screen will be displayed. Otherwise, the Finish RMFT Site Configuration screen will be displayed. By default, users need to authenticate their identity (by entering a username and password) before downloading packages. This ensures that the package will only be downloaded by the intended recipients.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite The Finish RMFT Site Configuration screen is displayed. 25. To open RMFT Manager when you click the Finish button, select the Open RMFT Manager check box. 26. Click the Finish button. The Configuring RMFT Site progress screen is displayed. If you selected Install SQL Server Express in Step 9, SQL Server Express will be installed at this stage. The installation does not require any user interaction.
RMFT Product Suite Installation Guide 2. Installing the Full RMFT Product Suite To view the RMFT components in the Windows Start menu (excluding CLI components): ♦ In the Windows Start menu, select All Programs > RepliWeb > Managed File Transfer. For operating instructions, refer to the related documentation (v). RepliWeb, Inc.
RMFT Product Suite Installation Guide 3. Installing Specific RMFT Components 3. Installing Specific RMFT Components You can install any of the RMFT Product Suite components according to your needs. For instance, if you only need to send packages to an existing RMFT Server, then you should install one or more of the RMFT Sending Agents as appropriate. Likewise, if you only need to receive packages sent using FASTCopy or SuperFAST protocols, then you should install the appropriate RMFT Receiving Agent(s).
RMFT Product Suite Installation Guide 3. Installing Specific RMFT Components To install specific components: 1. Perform steps 1-5 of 2. Installing the Full RMFT Product Suite (20). 2. To install specific components, click each of the components that you do not want to install (or - if modifying the installation - that you want to uninstall) and select Entire feature will be unavailable. The remaining components will be installed. For a description of each of the components, see RMFT Components (36).
RMFT Product Suite Installation Guide 3. Installing Specific RMFT Components The Ready to Install screen is displayed. 4. Click Install. The selected components are installed. RepliWeb, Inc.
RMFT Product Suite Installation Guide 3. Installing Specific RMFT Components After the selected components are installed, the final screen is displayed. 5. Click Finish. Start Menu shortcuts for the installed RMFT component(s) (excluding CLI components) will be displayed under Programs > RepliWeb > Managed File Transfer For operating instructions, refer to the related documentation (v). RepliWeb, Inc.
RMFT Product Suite Installation Guide 4. Modifying, Repairing or Upgrading the Installation 4. Modifying, Repairing or Upgrading the Installation You can modify your installation by removing components that you no longer require or by installing new components. You can also repair an installation (if, for example, one of the installation files is accidentally deleted or becomes corrupted) or upgrade the installation without needing to uninstall the current version.
RMFT Product Suite Installation Guide 4. Modifying, Repairing or Upgrading the Installation The Modify, Repair or Remove installation screen is displayed. 3. Click Modify. The Custom Setup screen is displayed. A description of each component is displayed in the area to the right of the available components. 4. To change the default installation directory, click Browse and select a different directory. 5. To install all of the components, click Next. 6.
RMFT Product Suite Installation Guide 4. Modifying, Repairing or Upgrading the Installation select max(BH_id) from bh_package_reports This will return the number of the last message received from the DMZ. Make a note of the number as it will be needed later on. On the internal RMFT Server machine: 1. Edit the file C:\RMFT\Config\internal_external.cf 2.
RMFT Product Suite Installation Guide 4. Modifying, Repairing or Upgrading the Installation Before beginning the upgrade: 1. Back up your RMFT settings and packages as follows: a. Replace the existing RMFT backup utility with the one that was provided with the RMFT installation kit (refer to the readme for full instructions). Note: In a setup consisting of an internal RMFT Server and a DMZ RMFT Server, the backup procedure should be performed on the internal RMFT Server only.
RMFT Product Suite Installation Guide 5. Silently Installing RMFT Components 5. Silently Installing RMFT Components RMFT components can be installed silently (i.e. without requiring user interaction). This option is useful, for example, if you need to install RMFT Receiving Agents on several machines in your organization. NOTE: On Windows Server 2008, to silently RMFT components under an account that is NOT the built-in administrator account, you need to first disable the UAC as follows: 1.
RMFT Product Suite Installation Guide 5. Silently Installing RMFT Components Upgrading the RMFT Administration Console To upgrade the RMFT Administration Console, issue the following command: >msiexec /fvasmue bhub.msi /q ARPNOMODIFY=1 /l*v c:\setup.log Installing RMFT FASTCopy and/or SuperFAST Receiving Agents RMFT Receiving Agents must be installed on any machine from or to which files are pulled/pushed using RMFT's FASTCopy and/or SuperFAST protocols.
RMFT Product Suite Installation Guide 5. Silently Installing RMFT Components Upgrading RMFT Receiving Agents To upgrade the RMFT Receiving Agents installation, issue the following command: >msiexec /fvasmue RmftReceivingAgents.msi /q ARPNOMODIFY=1 /l*v c:\setup.log Installing RMFT Desktop Client Note: RMFT Server must be installed prior to beginning the RMFT Desktop Client silent installation procedure. 1. Right-click the RMFT installation .
RMFT Product Suite Installation Guide 5. Silently Installing RMFT Components Optional Parameters Parameter Description TARGETDIR="C:\Target Dir" Changes the default installation directory to the specified path. INSTALLMODEACTION="SetAllUsers" Installs RMFT Desktop Client for all users. OFFICE2007_ADDIN=0 Disables the Office 2007 Add-In.
RMFT Product Suite Installation Guide 5. Silently Installing RMFT Components Upgrading RMFT Desktop Client To upgrade the RMFT Desktop Client installation, issue the following command: >msiexec /fvasmue RmftDesktopClient.msi /q ARPNOMODIFY=1 /l*v c:\setup.log RepliWeb, Inc.
RMFT Product Suite Installation Guide A. RMFT Port Requirements A. RMFT Port Requirements The required ports and firewall configuration are determined by three factors: 1. Your specific RMFT deployment (see below). 2. Which transfer protocols are used to pull/push files from/to hosts. 3. How end-users upload packages to RMFT Server (HTTP/S, FASTCopy, or SuperFAST).
RMFT Product Suite Installation Guide A. RMFT Port Requirements See also Host Port Requirements (53). Protocol: HTTP/S (LiteCopy) Used by: RMFT Web Client, RMFT Java CLI and RMFT CLI. 80/443 Open this port for inbound communication if external users are using HTTP/S to upload files to RMFT Server. See also Host Port Requirements (53). S/MIME 25 Open this port for outbound communication if any of the external user accounts are configured to receive packages by e-mail.
RMFT Product Suite Installation Guide A. RMFT Port Requirements SuperFAST to upload files to RMFT Server. See also Host Port Requirements (53). Protocol: HTTP/S (LiteCopy) Used by: RMFT Web Client, RMFT Java CLI and RMFT CLI. Firewall between RMFT Server and the internal network: Open this port for outbound communication if internal users are using HTTP/S to upload files to RMFT Server.
RMFT Product Suite Installation Guide A. RMFT Port Requirements Internal RMFT Server Component/Protocol Port Description GQS 3102 Firewall between RMFT Server and the DMZ: This port must be open for outbound communication. The internal RMFT Server connects to the DMZ Front End RMFT Server for the purpose of adding, deleting or editing external entities (users, hosts, etc.).
RMFT Product Suite Installation Guide A. RMFT Port Requirements SuperFAST to upload files to RMFT Server. See also Host Port Requirements (53). Protocol: HTTP/S (LiteCopy) Used by: RMFT Web Client, RMFT Java CLI and RMFT CLI. 80/443 Firewall between RMFT Server and the Internet: Open this port for inbound communication if external users are using HTTP/S to upload files to RMFT Server. See also Host Port Requirements (53).
RMFT Product Suite Installation Guide B. Installing RMFT in an Existing RMFT Environment B. Installing RMFT in an Existing RMFT Environment If disk failure occurs or if the RMFT Server machine has reached End-of-Life and needs replacing, you can install RMFT on top of the existing RMFT environment.
RMFT Product Suite Installation Guide B. Installing RMFT in an Existing RMFT Environment For instructions on backing up RMFT Server, please refer to the RMFT Administrator’s Guide. 2. Open a command prompt and change the working directory to the directory containing the RMFT setup file. IMPORTANT: The RMFT setup file must be the same version as the existing installation. 3. Issue the following command: RMFT_.
RMFT Product Suite Installation Guide C. Moving the RMFT Installation or Database to another Machine C. Moving the RMFT Installation or Database to another Machine In certain situations - for example, to improve performance - you may need to migrate the RMFT installation or the RMFT database to a new machine. This appendix outlines the steps needed to perform such migrations, both in a standalone environment (i.e. a single RMFT Server) and in a DMZ environment (i.e.
RMFT Product Suite Installation Guide C. Moving the RMFT Installation or Database to another Machine 3. Install RMFT on the new machine in the internal network. If you did not delete the database, you will need to specify a different database name during the Site Configuration stage of the installation. 4. Run the DMZ Setup Wizard and configure the RMFT Server to be the internal RMFT Server. 5. Restore the packages and settings to the new RMFT installation using RMFT's Backup and Restore feature. 6.
RMFT Product Suite Installation Guide C. Moving the RMFT Installation or Database to another Machine 9. Open ~\RMFT\Config\dmz_sync_report_ids.txt on the internal RMFT Server machine and replace the third number with the output of the SQL command. 10. Save the ~\RMFT\Config\dmz_sync_report_ids.txt file and start the RMFT Admin Agent service. Migrating the RMFT Database The same procedure should be followed when migrating the RMFT database in a standalone environment or in an Internal-DMZ environment.