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 (Evaluation only. Not for production purposes) - If this option is chosen, server configuration data will be stored locally in the embedded H2 database located in [MFT Server installation directory]/data

     

    Custom database - If this option is chosen, server configuration data will be stored in an external ANSI-compliant relational database like MySQL, MS SQL Server, Oracle, or PostgreSQL

     

    • Database URL - the URL of the relational database (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 Admin UI, 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 (Admin) UI. The Manager UI 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. In addition, the MFT Server Manager UI (administrative client) 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) followed by /settings/login.  For example: http://192.163.1.44:11880/settings/login

     

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

 

Launching the MFT Server Manager