Installing on Linux

RPM Console Installation

 

Note: Several Linux distributions exhibit slow response as a result of the newly introduced FIPS TLS library. To prevent this issue, please see Installing haveged prior to installing MFT Server

 

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

 

  1. Place the install.rpm file in a directory on the destination server.

     

  2. Install. Run the following command from the directory containing the RPM file you placed on your server:

     

    rpm -iv install.rpm

     

  3. Configure and initialize database.  Go to the /opt/mft_server directory and run the following commands.

     

    ./js-database-configuration -configure

     

    ./js-database-configuration -init

     

  4. Add an administrative user.  Go to the /opt/mft_server directory and run the following command.

     

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

     

    For example

     

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

     

  5. Configure Administration Service.  Go to the /opt/mft_server directory and run the following command:

     

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

     

    For example:

     

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

     

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

     

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

     

    Note: MFT Server Service host/IP and port identifies the default host/IP and port that the MFT Server Service 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.

     

  6. Configure the Web/REST settings. Go to the MFT Server installation directory, located in the mft_server directory relative to where the unzip command was executed, and run the following command:

     

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

     

    For example:

     

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

     

    Note: 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 (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 IP and port used to programmatically manage the MFT Server settings using management REST API calls.

     

  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.

     

    For example:

     

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

     

  8. Startup Administration Service.  From the /opt/mft_server directory run the following command:

     

    ./start_service.sh

 

The MFT Server Service should now be running.  To connect to this service and manage your server see the following topics:

 

Server configuration > Launching the administrative client

 

Auto-starting in Linux and Solaris 9 environments

 

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

 

ZIP Console Installation

 

Note: Several Linux distributions exhibit slow response as a result of the newly introduced FIPS TLS library. To prevent this issue, please install haveged before installing MFT Server

 

  1. Place the install.zip file in a directory on the destination server.

     

  2. Install. Run the following command from the directory containing the ZIP file you placed on your server:

     

    unzip install.zip

     

  3. Configure and initialize database. Go to the MFT Server installation directory, located in the mft_server directory relative to where the unzip command was executed, and run the following commands:

     

    ./js-database-configuration -configure

     

    ./js-database-configuration -init

     

  4. Add an administrative user. Go to the MFT Server installation directory, located in the mft_server directory relative to where the unzip command was executed, and run the following command:

     

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

     

    For example:

     

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

     

  5. Configure Administration Service.  Go to the /opt/mft_server directory and run the following command:

     

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

     

    For example:

     

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

     

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

     

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

     

  6. Configure the Web/REST settings. Go to the MFT Server installation directory, located in the mft_server directory relative to where the unzip command was executed, and run the following command:

     

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

     

    For example:

     

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

     

    This service is what you will connect to using the MFT Server Manager to manage your server.

     

  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.

     

    For example:

     

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

     

  8. Startup Administration Service.  From the /opt/mft_server directory run the following command:

     

    ./start_service.sh

 

The MFT Server Service should now be running.  To connect to this service and manage your server see the following topics:

 

Server configuration > Launching the administrative client

 

Auto-starting in UNIX environments

 

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