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 install haveged before installing JSCAPE 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/JSCAPE_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/JSCAPE_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/JSCAPE_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 JSCAPE MFT Server Service , where [ip address] and [port] are the IP/port that you want the JSCAPE MFT Server Service to listen on, and [timeout in seconds] is the timeout value for this service.  The defaults port for JSCAPE 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 JSCAPE MFT Server installation directory, located in the JSCAPE_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 JSCAPE MFT Server Manager to manage your server.

7. Configure the credentials used when invoking command line utilities. Go to the /opt/JSCAPE_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/JSCAPE_MFT_Server directory run the following command:

./start_service.sh

The JSCAPE 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 JSCAPE 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 JSCAPE 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 JSCAPE MFT Server installation directory, located in the JSCAPE_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 JSCAPE MFT Server installation directory, located in the JSCAPE_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/JSCAPE_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 JSCAPE MFT Server Service , where [ip address] and [port] are the IP/port that you want the JSCAPE MFT Server Service to listen on, and [timeout in seconds] is the timeout value for this service.  The defaults port for JSCAPE 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 JSCAPE MFT Server installation directory, located in the JSCAPE_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 JSCAPE MFT Server Manager to manage your server.

7. Configure the credentials used when invoking command line utilities. Go to the /opt/JSCAPE_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/JSCAPE_MFT_Server directory run the following command:

./start_service.sh

The JSCAPE 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 JSCAPE MFT Server on Java 9 or Java 10 read Running on Java 9 or 10