Installing on Windows

To install MFT Server on a Windows platform perform the following:

 

  1. Download and run the install.exe installation file for MFT Server.  Click Next to continue.

     

     

  2. Read and accept license agreement.  Click Next to continue.

     

     

  3. Select installation directory.  Click Next to continue.

     

     

  4. Enter name of Start Menu Folder.  Click Next to continue.

     

     

  5. Load your license file by clicking the Browse button and then selecting the file in question from your local file system. If you don't have a license file yet, please email sales@jscape.com to request for one.

     

     

  6. Configure datastore where server configuration data will be located.

     

     

    Embedded database — If this option is chosen, server configuration data will be stored locally in the embedded H2 database located in [MFT Server installation directory]/data

     

    Warning: The embedded H2 database that ships with MFT Server is not intended for production environments and is for evaluation purposes only.

     

    Custom database — If this option is chosen, server configuration data will be stored in an external database.

     

    Warning: The database must be created prior to running the installation.

     

    See System Requirements >  Databases for a list of supported databases. The database you create will be referenced during the configuration process.

     

    The JSCAPE MFT Server database user should be granted only the minimum necessary privileges. Avoid using administrative or root database accounts.

     

    Required Privileges — Work closely with your DBA to ensure the database and user are created with the access levels described below.

     

    • Schema Management: CREATE, ALTER, DROP (Required for initial installation)

    • Data Manipulation: INSERT, UPDATE, DELETE, SELECT (Required for normal operation)

    • Index Management: CREATE INDEX, DROP INDEX (Required for performance optimization)

     

    Next, enter the following Database Settings for the custom database:

     

    • Database URL — the URL of the relational database, created earlier, as described above (e.g. jdbc:mysql://localhost:3306/mftserverconfig).

       

    • Database username — the name of an existing user account that has sufficient permissions for that database.

       

    • Database password — the corresponding password of that user account.

       

    • Synchronization period — Specifies how often GUI data is synchronized with the database. This is normally needed when you have two (2) or more instances of MFT Server connecting to a shared global datastore and you want to specify how often the configuration data on those servers are synchronized.

       

      Click Next to continue.

       

  7. Configure management/REST services and administrative credentials.

     

     

    • Management host/IP — The IP address that management service should listen on.  The IP address 0.0.0.0 is a special address that instructs service to listen on all available network interfaces.

       

    • Management port — The port that management service should listen on.  Default port is 10880.

       

      Note: Management host/IP and port identifies the default host/IP and port that MFT Server listens on when users are programmatically accessing MFT Server using the Java Management API. If you do not plan on using Java API calls, you can disable the host and port (after the installation) by accessing the MFT Server Manager, then navigating to Settings > MANAGER SERVICE > Manager Service. Uncheck the Enable Manager Service checkbox.

       

    • REST HTTP host/IP — The IP address that REST web service should listen on.   The IP address 0.0.0.0 is a special address that instructs service to listen on all available network interfaces.

       

    • REST HTTP port — The port that REST web service should listen on.  Default port is 11880.

       

      Note: Rest HTTP/S host/IP and port identify the default host/IP and port that MFT Server listens on when users connect to the web-based MFT Server Manager UI. The MFT Server Manager is the interface used to manage all aspects of MFT Server, like creating services, Users, Trading Partners, and configuring settings. It is also the host/IP and port used to programmatically manage the MFT Server settings using management REST API calls.

       

    • Username — Administrative username for managing services.

       

    • Password — Administrative password for managing services.

     

    Click Next to continue.

     

  8. Set allocated application memory.  Minimum allocated memory is 1024 MB but you may increase this later on if you need more. Click Next to continue.

     

     

  9. Click Finish.

     

     

    If everything works as expected, the MFT Server Windows service will start.

     

    To verify that MFT Server is running, you can check Windows Services.  Locate MFT Server in the list. It should have a status of Running.

     

    • If MFT Server is not running, navigate to the server log file located in the Program Files\MFT Server\var\log directory. Open the server log file named server0.txt to see if it offers any information regarding why the service is not running.

     

    A Windows installation includes both an administrative UI and a client UI. After the installation is complete, the MFT Server Manager (administrative UI) will automatically launch in your default browser, prompting you to log in so you can configure your server.

     

    The URL will consist of your MFT Server IP address or hostname, REST port (the default is 11880 - configured in Step 7) followed by /settings/login.  For example: http://192.163.1.44:11880/settings/login. When the login page displays, enter the username and password you provided during the installation (also configured in Step 7).

     

    To learn about the MFT Server Web Client UI, see Web-based file transfers

     

Note: If you are running any firewall software make sure that it is setup to allow MFT Server to run. For firewalls that use application white-listing, add the application server.exe located in the MFT Server installation directory.

 

See also

 

Accessing the user interface - MFT Server Manager - This is the web-based application used to configure and manage MFT Server.

 

MFT Server Manager Navigation

 

Redwood University - JSCAPE On-premise MFT Installation. Select Installing JSCAPE MFT Server.


Note: A login is required to access Redwood University.