Install SecureTransport to use the embedded database

Use this installation procedure to install SecureTransport on UNIX-based platforms where the installation will use the embedded database server:

  • Stand-alone SecureTransport Server
  • SecureTransport Server in a Standard Cluster
  • SecureTransport Edge

Check the pre-installation information and prerequisites before you install.

This procedure assumes that SecureTransport is not installed on the system. Only one instance of SecureTransport Server or SecureTransport Edge is supported in a production environment. To upgrade an existing installation, refer to the SecureTransport Upgrade Guide.

  1. Log in to the system as the user who will run SecureTransport.
  2. Copy the Axway Installer file into a temporary directory and navigate to that temporary directory.
  3. Extract the installation files using the following commands:
    unzip SecureTransport_5.4.0_Install_<OS>-<processor>_<buildNumber>.zip
  4. where the placeholders represent the following:
    • <OS> is the operating system: aix (for IBM AIX), linux (for Linux), or sun (for Oracle Solaris).
    • <processor> is the type of processor running the operating system: power-64, or sparc-64, or x86-64.
    • <BuildNumber> is the actual build number listed in the installer executable file, for example, BN1234.
  5. Enter the following commands to run the Axway Installer:
    ./setup.sh -m console
  6. The installer initializes and displays a welcome message and a prompt.
    Initialization in progress
    ................

    ----------------------------------------
    Welcome
    ----------------------------------------
    Welcome to the Axway Installer wizard for SecureTransport Server and SecureTransport Edge.
    This wizard will install SecureTransport Server or SecureTransport Edge on your computer.
    Next (type Next or N or n): to go to next Dialog
    Previous (type Previous or P or p): to go to previous Dialog
    Quit (type Quit or Q or q): to abort
    If you want to delete a field value, use the Space bar or the Tab key.
    During installation, all values or choices must be validated by pressing Enter.
    Enter (Next, Quit).
    >Next
  7. Press Enter.
  8. The installer will display the license agreement page by page. After each one there is a Press ENTER to continue prompt. After all license agreement pages are displayed, the installer displays the license agreement and the following prompt (for accepting or rejecting the license agreement):
    [1] I accept the terms of the license agreement.
    [2] I do not accept the terms of the license agreement.
    Enter a number [1-2] to select an option or (Previous, Quit).
    :>2
  9. Enter 1 to accept the license agreement. Enter 2 to reject the license agreement and cancel the installation (default).
  10. The installer displays a prompt for the Axway installation directory:
    ----------------------------------------
    Installation directory
    ----------------------------------------
    Specify the directory where you want to install the products and documentation.
    1: Installation Directory:           /<userHome>/Axway
    Enter 1 to select an option or (Next, Previous, Quit).
    :>Next
  11. where <userHome> represents the home directory of the user running the installation.
  12. To change a value, enter the number for the value.
  13. The installer displays a prompt for you to enter a new value.
  14. Enter the new value.
  15. The value of the Installation Directory field must be an absolute path. The installer installs its files, including files required to update and uninstall SecureTransport 5.4, in the directory that you specify in this step and uses that directory as the parent directory in the default values of the SecureTransport installation directory. You specify the SecureTransport installation directory in a later step.
  16. The installer displays the installation type choice:
    ----------------------------------------
    Modules
    ----------------------------------------
    Select the modules you want to install, then type Next to continue the configuration.

    Axway SecureTransport V5.4:
    1 :[x] Server
    2 :[ ] Edge
    Enter a number[1-2] (Next, Previous, Quit)
    :>Next
  17. To install SecureTransport Server, accept the default. To install SecureTransport Edge, enter 2 and confirm that Edge is selected when the installer displays the prompt again.
  18. The installer displays a prompt for the SecureTransport installation directory:
    ----------------------------------------
    Installation directory
    ----------------------------------------
    To specify the directory where the product is installed, type the path directly, or press Enter to select the displayed default.
    1: Select the installation directory for SecureTransport:
    <AxwayHome>/SecureTransport
    Press 1 to change the selected option or (Next, Previous, Quit).
    :>Next
  19. where <AxwayHome> is the directory you specified in the previous installation directory step.
  20. Accept the default or change the directory name.
  21. Do not use the directory where you copied the installer files. All SecureTransport Servers in a cluster or SecureTransport Edges that are synchronized must use the same installation directory. The name of the SecureTransport installation directory cannot contain space characters, the tab character, or the ~ character. For example, /root/Axway/STServer is valid, but /root/Axway/ST Server is not.
  22. This installation directory is referred to as <FILEDRIVEHOME> throughout this document and other SecureTransport documents.
  23. If you are installing SecureTransport Edge, the installer displays the embedded port number prompt shown in the next step.
  24. If you are installing SecureTransport Server, the installer displays the database selection prompt:

    ----------------------------------------

     

    Database settings
    ----------------------------------------
    [1] Embedded Database (MySQL)
    [2] External Oracle Database
    [3] External Microsoft SQL Server Database
    Enter a number [1-3] to select an option or (Previous, Quit).
    :>1

  25. Press Enter to accept the default, the embedded database.
    NoteFor installation using an external database, see Install SecureTransport Server in an Enterprise Cluster or to use an external database.
  26. The installer displays the embedded port number prompt:

    ----------------------------------------

     

    Database settings
    ----------------------------------------

    Provide the settings for the MySQL database:

    1: Port: 33060

     

    Press 1 to change the selected option or (Next, Previous, Quit).
    :>Next

  27. Enter 1 to select a new port number for the embedded database installed by SecureTransport or accept the default setting.
  28. The installer displays the default SecureTransport ports, nightly log rotation, and import secret file configuration:
    ----------------------------------------
    Configuration
    ----------------------------------------
      Select the options that you want to enable:
      SecureTransport Ports
    1: SSL Admin UI Port:           444
    2: Tomcat Shutdown Port:        8005
    3: Enable Nightly Log Rotation: true
      Import Secret File
    To synchronize the configuration of this ST Server with another ST Server you must import the same secret file (located on the remote ST Server at: <installation path>/bin/taeh). Otherwise, leave the field empty to generate a new secret file.
    4: Secret File Path:

    Enter a number [1-4] to select an option or (Next, Previous, Quit).
    :>Next
  29. Accept or modify the default configuration.
  30. The information required is:
    • SSL Admin UI Port – The port used to connect to the Administration Tool. When you install SecureTransport as a non-root user, the default value for Admin port number is 8444.
    • Tomcat Shutdown Port – The port used to shut down the Tomcat server
    • Enable Nightly Log Rotation – Select if you want the system to perform automatic backup and purging of log files on a nightly basis. When this feature is enabled, SecureTransport Server backups log files, generated on the respective day, and creates a new one for the subsequent day. The server takes a back up and creates a new log file at 23:59 or 00:00 hours, depending on the log file type. This option is enabled by default. You can enable or disable the nightly log rotation after installation. For more information, see the SecureTransport Administrator's Guide, Server Log Rotation Scheduling.
    • Secret File Path – The path to the secret file you copied from another SecureTransport Server installation to this system, if blank, the installer creates a secret file (See Secret file.)
  31. When you have modified these values as required for your installation, press Enter.
  32. The installer prepares the installation execution and displays its last prompt:
    ----------------------------------------
    Installation execution
    ----------------------------------------
    All selected products are ready to install. Type Next to start installing. If not, type Previous to make changes.
    Enter (Next, Previous, Quit).
    >Next
  33. Press Enter to start the installation.
  34. The installer displays progress messages as it completes the installation tasks.
  35. When the installation is complete, the installer displays:

    Installation successful

     

    ----------------------------------------

     

    Summary

    ----------------------------------------

    The information below summarizes the installation status. Refer to install.log for more details.

     

    ----------------------------------------------------------

    Axway_Installer_V4.8.0

    Installed in /opt/TMWD/Axway/

    Axway_Installer_4.8.0_SP3 has been applied successfully.

    ----------------------------------------------------------

    Product: SecureTransport_V5.4

    Installed in /opt/Axway/SecureTransport

    ----------------------------------------------------------

    Enter a number [1-2] to select an option.

     

    [1]Finish installation

    [2]Update the installed products

    :>1

  36. Press Enter to exit the installer or select update mode to apply patches or service packs without leaving the installer.

The installer also creates a log file, <AxwayHome>/install.log.

After successfully installing SecureTransport, you must perform a number of post-installation steps, such as applying your SecureTransport licenses, and enabling, configuring, and starting the SecureTransport services. For more information, see the SecureTransport Getting Started Guide.

Related topics:

Related Links