Installing on AIX

This section describes how to install MFT Server on an AIX system using the ZIP installer file, downloaded from the JSCAPE website.

 

ZIP Console Installation

 

Before installing MFT Server, you must create a database that will serve as the MFT Server backend database. See Databases for a list of supported database types.

 

Note: If you are using the built-in H2 database, you do not need to create a database. You can proceed to the installation instructions. However, only use the H2 database for evaluation purposes, where the test load is not expected to be heavy. All other MFT Server environments must use one of the supported databases.

 

If you are running MFT Server in a high availability (HA) environment, review this information before installing the product - Configuring a centralized global datastore

 

To install using the ZIP file, perform the following steps as a user with root privileges.

 

  1. Place the install.zip file in a directory on the destination server. The directory commonly used is /opt. This is recommended but not required.

     

  2. Run the following command from the directory where you placed the zip file:

     

    unzip install.zip

     

    Example: Using the 2025.1 zip file downloaded from the JSCAPE website, the command is: unzip mft-server-install-unix-2025.1.0.528.zip

     

    A directory named mft_server is created within the directory where you placed the zip file and ran the unzip command. For example, if you ran it from the /opt directory, you will see a directory structure as follows: /opt/mft_server.

     

    Note: The commands you are required to enter in the following steps must be done from within the mft_server directory. Therefore, after running the unzip command, navigate to the mft_server directory. For example, enter cd mft_server.

     

  3. Configure and initialize the MFT Server database. Follow the instructions to either initialize your database or the built-in H2 database, depending on which one you are using.

     

    Initialize your database (excludes the H2 database)

     

    Run the following commands:

     

    ./js-database-configuration -configure -url <URL> -user <DB user> -password <DB Password> - For more details see js-database-configuration

     

    Example: ./js-database-configuration -configure -url jdbc:mysql://mftserverdb.d7movljn.us-west-2.rds.amazonaws.com:3306 /MFT_Server -user admin -password '***'

     

    Next, run the init command to initialize the database schema:

     

    ./js-database-configuration -init

     

    Create and Initialize the H2 database

     

    Run the following commands:

     

    ./js-database-configuration -configure

     

    Successful command reply:


    MFT Server Database Application v. <MFT Server version number and release date>

    Saving application database configuration...

    Done.

     

    ./js-database-configuration -init

     

    Successful command reply:

     

    MFT Server Database Application v. <MFT Server version number and release date>

    Initializing application database...

    Done.

     

  4. Add an administrative user. This is the account used to log in to the MFT Server Manager user interface. MFT Server Manager is where you configure MFT Server and its associated services, Users, Trading Partners, etc.

     

    Run the following command:

     

    ./js-addadmin -db -username [username] -password [password] -sa

     

    Example: ./js-addadmin -db -username admin -password secret -sa

     

    Successful command reply:

     

    MFT Server Create Administrator Application v. <MFT Server version number and release date>.
    Creating administrator 'admin'...

    Done.

     

  5. Configure Administration Service.  The Administration service is used to provide programmatic access to MFT Server using the Java Management API. Historically, the MFT Server Manager UI was written using the Java Management API. The UI was rewritten using the REST API. Although the user interface written using the Java Management API has been retired, the ability to access MFT Server using the Java Management API is still supported. Run the following command:

     

    ./js-server-configuration -host [ip address] -port [port] -timeout [timeout in seconds]

     

    Example: ./js-server-configuration -host 0.0.0.0 -port 10880 -timeout 60

     

    This will configure your MFT Server Adminstration Service, where [ip address] and [port] are the IP/port that you want the MFT Server Adminstration Service to listen on, and [timeout in seconds] is the timeout value for this service. The default port  is 10880.

     

    Successful command reply:

     

    MFT Server Management Configuration Application v <MFT Server version number and release date>.

    Saving configuration...

    Done.

     

    Note: 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 user interface, then navigating to Settings > MANAGER SERVICE > Manager Service. Uncheck the Enable Manager Service checkbox.

     

    Note: The IP address 0.0.0.0 is a special address that instructs the service to listen on all available network interfaces.

     

    AIX systems are typically configured to run the IBM JVM, therefore it is necessary to make some changes to various configuration files in order to instruct the JVM on what security provider and encryption algorithm to use for starting up the MFT Server Service.

     

    See Running under IBM JVM for complete details and instructions.

     

  6. The Web/REST settings are configured for access to MFT Server via the MFT Server Manager web-based user interface, and for programmatic access using REST API calls. MFT Server Manager is the interface used to manage all aspects of MFT Server, like creating services, Users, Trading Partners, and configuring settings. The same type of configurations can be performed programmatically using REST API calls. The MFT Server Manager was written using the REST API. The REST IP and port identify the IP and port that MFT Server listens on.

     

    Run the following command:

     

    ./js-web-configuration -host [REST ip address] -port [REST port] -timeout [timeout in minutes]

     

    Note: ./js-web-configuration -host 0.0.0.0 -port 11880 -timeout 10

     

    The Rest IP and port identify the default IP and port that MFT Server listens on when users connect to the web-based MFT Server Manager UI. 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 IP and port used to programmatically manage the MFT Server settings using management REST API calls.

     

    Successful command reply:

     

    MFT Server Web Configuration Application v <MFT Server version number and release date>.

    Saving configuration...

    Done.

     

  7. Configure the credentials used when invoking command line utilities. Go to the /opt/mft_server directory and run the following command:

     

    ./js-client-configuration -host [host] -port [port] -timeout [timeout in seconds] -user [username] -password [password]

     

    Make sure the user and password parameters match the username and password that were used earlier in the js-addadmin command.

     

    Example: ./js-client-configuration -host 0.0.0.0 -port 10880 -timeout 60 -user admin -password secret

     

    Successful command reply:

     

    MFT Server Client Configuration Application v <MFT Server version number and release date>.

    Saving configuration...

    Done.

     

  8. Generate a Server Key. Run the following command:

     

    ./js-add-server-key -rsa -size 4096 -alias example_rsa - Note, example_rsa is the name of the key. Feel free to name it whatever you would like. The recommended key size is 4096.

     

    Note: The Server Key can also be created using the MFT Server Manager, after the installation.  See Keys > Server Keys > Generate > Generate Key.

     

    Successful command reply:

     

    MFT Server Create Server Key Application v. <MFT Server version number and release date>

    Creating server key '<key name>'...

    Done.

     

  9. Copy the license key file to the etc directory that is relative to MFT Server's installation directory (e.g. /opt/mft_server/etc). This must be done before attempting to start the service.

     

    Note: The license key file is provided to each customer in a zip file. The MFT Server license is in the zip file's JSCAPE MFT Server folder. It is named license.lic.

     

  10. Startup MFT Server Service.  From the MFT Server installation directory run the following command:

     

    ./start_service.sh

 

To verify that MFT Server is running, enter: ps aux | grep mft_server

 

If MFT Server is not running, navigate to the MFT Server log file: /opt/mft_server/var/log

 

Enter: cat server0.log - This displays the contents of the file to the terminal window.

 

Once your system is up and running, you can access the web-based user interface named MFT Server Manager. The URL to enter in your web browser is based on the information you entered in Step 6 of the installation process. After successfully accessing the application, you will be prompted login. The credentials to use are based on the account information you specified in Step 4 of the installation process. See the links below for more details.

 

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

 

Auto-start using SysVinit scripts

 

If you intend to run MFT Server on Java 9 or Java 10 read Running on Java 9 or above