Transcription
CHAPTER 1IntroductionIn This ChapterWhat is WS FTP Server Web Transfer Module? .1System Requirements.2What is WS FTP Server Web Transfer Module?WS FTP Server Web Transfer Module is a web application that runs with MicrosoftInternet Information Server (IIS) and lets your WS FTP Server users access their accountsvia a browser (using HTTP).No installation is required for the end user. The end user will open a web address in abrowser and log on to their account using the Web Transfer Client.You can enable Web Transfer access to any of your WS FTP Server users. All existing usersettings, rules, and notifications apply to the WS FTP Server Web Transfer Moduleaccount.For the end user, the Web Transfer Client offers easy, secure access via a browser, basicupload and download operations, and no client installation or maintenance.1
WFS6.1.1 WS FTP Server Web Transfer Module Getting Started GuideFor the administrator, WS FTP Server Web Transfer Module provides secure file transfervia HTTPS, offers quick setup and rollout, and works the same across different operatingsystems and browsers.System RequirementsRequirements for WS FTP Server Web Transfer ModuleBefore installing WS FTP Server Web Transfer Module, you need the following: WS FTP Server or WS FTP Server with SSH, 6.1.1 or later Microsoft .NET 3.0 Framework Microsoft Internet Information Services (IIS) 5.0 or 6.0The pre-installation checklist in the section, "Installing WS FTP Server Web Transfer Module,"describes how to configure the requirements.Requirements for the end userThe end user can use any computer with an operating system that can support the following: Broadband connection to the Internet (recommended) Microsoft Internet Explorer 5.1 or later, Mozilla Firefox 2.0 or later on Windows, Mac, andUnix, Safari (Apple) browser, Netscape Navigator (or other Web browser that is CSS2 andHTML 4.01 compliant) Enabled Javascript support and Cookie support in the Web browser2
CHAPTER 2Installing WS FTP Server WebTransfer ModuleIn This ChapterInstalling WS FTP Server Web Transfer Module .3Uninstalling WS FTP Server Web Transfer Module.5"Silent Install for .5Installing WS FTP Server Web Transfer ModuleWS FTP Server Web Transfer Module should be installed on the same computer as WS FTPServer. This section provides a pre-installation checklist and install procedure for installingWS FTP Server Web Transfer Module.Pre-installation checklist for installing WS FTP Server Web TransferModuleWS FTP Server Web Transfer Module installs an IIS web application to communicate with theWS FTP Server database and FTP file system. Before you run the WS FTP Server Web TransferModule installation, you need to install the prerequisite software and configure the WS FTPServer computer.1Install WS FTP Server or WS FTP Server with SSH, v6.1.1 or laterThe version 6.1.1 update enables the WS FTP Server to work with the WS FTP ServerWeb Transfer Module. To download this update, go to the WS FTP Server SoftwareUpdates page http://www.ipswitch.com/support/ws ftp-server/patch-upgrades.asp onour web site.2For the installation requirements and procedure, see WS FTP Server Getting Started Guidehttp://www.ipswitch.com/ftpserver611gsg.Make sure Microsoft .NET Framework 3.0 is installed.3You can download and install .NET Framework 3.0 from the Microsoft Download spx?FamilyID 10cc340b-f857-4a14-83f525634c3bf043&displaylang en.Make sure Microsoft Internet Information Services (IIS) 5.0 or 6.0 is installed.3
WFS6.1.1 WS FTP Server Web Transfer Module Getting Started GuideYou need the Windows OS disk to install IIS. Go to Control Panel Add or RemovePrograms, then select Add/Remove Windows Components. Select InternetInformation Services (or Application Services on Windows 2003), then follow the onscreen instructions.4 The Web Transfer Module needs access to the file system on your FTP host or hosts so itcan upload and download files. During the Web Transfer Module installation, you willneed to specify a Windows user account with permissions to the top folder of eachWS FTP Server host (for each host for which you will enable WS FTP Server WebTransfer Module). We recommend you create a Windows user account for use by theWeb Transfer Module.Note that this Windows user account is used differently depending on the WS FTP Serverhost settings and the user database configured for that host: If the host uses a Microsoft Windows or Microsoft Active Directory user database,configured to use Windows file permissions, the user account permissions takeprecedence, and this Windows account is not used. If the host has a host-level impersonation account, which is required if the host Topfolder uses a UNC path, the host-level impersonation account takes precedence, andthis Windows account is not used.If the host uses the WS FTP Server or ODBC user database, and the host-level impersonationis not specified, this Windows account is used.To install WS FTP Server Web Transfer Module:1 If you received an installation CD, insert it into a drive. If the Welcome screen does notappear, select Start Run, and enter the drive path followed by launch.exe.Example: D:\launch.exe- OR If you downloaded the software from our Web site, double-click the executable (.exe) fileto begin the installation.2 On the Pre-installation Checklist screen, read the checklist items. Make sure you have setup the required configuration. Select "I have completed the Pre-installation checklist,"then click Next.3 On the installation Welcome screen, click Next to continue. The License Agreementdialog appears.4 Read the license agreement. If you agree with its terms, select "I accept the terms of thelicense agreement," and click Next.Next, the Impersonation Account for Web Transfer Module screen opens.5 Enter a Windows account that has full access to the top folder of the WS FTP Serverhost.4
WFS6.1.1 WS FTP Server Web Transfer Module Getting Started GuideThe Web Transfer Module needs a Windows account to use for access to the FTP filesystem.On the WS FTP Server computer, you should have created a Windows account that hasfull access to the top directory of the WS FTP Server host, as described in the preinstallation steps. Use that account username and password here.Domain or Server. Enter the Windows domain name of the WS FTP Server computer, orthe Windows computer name.User name. Enter the user name for the Windows account.Password. Enter the password for the account.This account username and password will also appear in the WS FTP Server Manager,under Home Modules Web Access Settings. If necessary, you can modify thisaccount after completing the installation.6 Choose the appropriate IIS web site for your application. Choose the default web site,unless you have created a dedicated web site for this server, then click Next.The installation program also configures the Web Transfer web application to accept SSLconnections on port 443. A self-signed certificate is installed. This allows your users to useHTTPS for secure transfers.7Next, the Destination Folder dialog opens.Click Next to install to the specified folder.If you want to install to a different folder, click Change, then browse to the destinationfolder, or create a new folder, then click OK. You will be returned to the DestinationFolder dialog. Click Next.8 Click Install. The Install Wizard completes the installation. The Setup Wizard Completeddialog opens.9 Read the notes related to post-installation steps, then click Finish.10 You need to enable web access for users that will use the Web Transfer Client, andprovide them the web address to log on, as described in the section, "ConfiguringWS FTP Server Web Transfer Module."Uninstalling WS FTP Server Web Transfer Module12In the Control Panel, select Add/Remove Programs.Select Ipswitch WS FTP Server Web Transfer Client, then click Change/Remove andfollow the onscreen prompts to uninstall."Silent Install forTo automate installation of WS FTP Server Web Transfer Module, you can use silent install.This silent install uses the Microsoft Installer and command line options to execute theinstallation, rather than the record and play mechanism used by the WS FTP Server. Thesyntax for the command line is:5
WFS6.1.1 WS FTP Server Web Transfer Module Getting Started Guidemsiexec -i [path executable].msi -q DBSERVERTYPE "PG"DBUSER "IPS xxxx" DBPASS "xxxx" DBSERVERNAME "Server X"DBSERVERPORT "5432" IS NET API LOGON USERNAME "DOMAIN\USER"IS NET API LOGON PASSWORD "xxxx" IISWEBSITENAME "Default Web Site"The "-i" option indicates install. To uninstall, use the option "-x." The record (r) and silent (s)options are not used for the WS FTP Server Web Transfer Module silent install.The install properties are as follows (follow each option with an equals sign and enclose eachof the values in quotes):PropertyDescriptionDBSERVERTYPEThe type of server being installed. PG PostGreSQL.MS Microsoft SQL Server.DBUSERThe name of the user recognized by the database. Note: Ifa PostgreSQL database was created by the WS FTP Serverinstallation, the username for the database account is theWS FTP Server administrator name appended to "IPS ".For example, if you entered "admin" during the WS FTPServer installation, the PostgreSQL user name will be:IPS adminDBPASSThe password for the user recognized by the database.DBSERVERNAMEThe server name (should be entered as SERVER orINSTANCE\SERVER).DBSERVERPORTThe port number for the server (should be NO PORT if theinstance is specified). The default port for PostgreSQL is5432; the default port for Microsoft SQL Server is 1433.IS NET API LOGON USERNAME This is the domain and username for the impersonationaccount (The Windows account used to perform file serveroperations and access the file server directory. UseDOMAIN\USER).IS NET API LOGON PASSWORD This is the password for the impersonation account.IISWEBSITENAMEThis is the name of the web site to be supported (such asDefault Web Site).INSTALLDIRUse this property to specify a different install path (thedefault path is \Program Files\Ipswitch\WebClients). Usethis command last.After the installation is completed, you can navigate to the INSTALLDIR to make sure the filesare installed there.6
CHAPTER 3Configuring WS FTP Server WebTransfer ModuleIn This ChapterConfiguring WS FTP Server Web Transfer Module.7Configuring WS FTP Server Web Transfer ModuleWS FTP Server Web Transfer Module does not require installation on a user's computer. YourWS FTP Server users can access the files in their accounts using any browser, and the address(URL) that you provide them. To complete the configuration of WS FTP Server Web TransferModule, you need to:1From your existing set of WS FTP Server users, add users to the Web Access list.1Log in to the WS FTP Server Manager, and select Home Modules. The Modulespage opens.2Select Web Access.The Web Access page shows all eligible users, which is all users on all of your WS FTPServer hosts.32Add any users to whom you want to provide web access.Roll out Web Access to your users by providing them the address (URL) that users willuse to log on to the Web Transfer Client.The address is: http:// local machine /thinclient/login.aspxwhere local machine is the domain name of the computer on which you installed theWeb Transfer Client.For example, if the local computer domain name is host1.wsftp.com, then the addressyour users need to log on to the Web Transfer Client is:http://host1.wsftp.com/thinclient/login.aspxYou should test this address before sending it out to users.You can also launch the Web Transfer Client from the WS FTP Server program group(Programs Ipswitch WS FTP Server WS FTP Server Web Transfer Client.)7
WFS6.1.1 WS FTP Server Web Transfer Module Getting Started GuideIf you add a user to the default host (specified in Server Server Settings SystemDetails), the user will log onto the Web Transfer Client using their WS FTP server user nameand password. If you add a user to a host that is not the default host, the user must log ontothe Web Transfer Client using the host name, host separator, and username and password;for example: [email protected] Transfer via HTTPSFor secure transfer, the Web Transfer Client is installed with SSL capability, which runs onport 443. The installation creates an SSL certificate which is used when the user connectsvia HTTPS. You can enable secure transfer by changing the address used to log on to theWeb Transfer Client to use HTTPS, for spx8
WFS6.1.1 WS_FTP Server Web Transfer Module Getting Started Guide The Web Transfer Module needs a Windows account to use for access to the FTP file system. On the WS_FTP Server computer, you should have created a Windows account that has full access to the top directory of the WS_FTP Server
