Installing FootPrints

This topic explains the installation process for new installations of versions 12.1.00 and later. You can install FootPrints on Linux or Windows systems. For more information about using Silent mode for Linux installs, see Installing FootPrints using Silent Mode.

Notes


  • With the release of FootPrints 12.1.01, support for installation of version 12.1.00 or earlier will not be available. 
  • FootPrints can only be installed once on each server (not in parallel on one server).

  • Do not install Footprints version 12.1 or Apache Tomcat 7 on a server on which Footprints version 11.x is installed. The Tomcat application used by Footprints version 11.x for the Executive Dashboard conflicts with the installation of Apache Tomcat 7 required to use Footprints version 12.1.x. The installation of Footprints 12.1 might fail or might not be stable.

  • For FootPrints 20.18.03, the Apache Tomcat 8.5 is the only supported web server.


To perform the installation

  1. Review Prerequisites for important pre-installation steps, including how to install Java and Tomcat. 
  2. Log on to the system where you want to install FootPrints as an Administrator.
  3. Download the installer file.
    For more information, see Downloading the installation files.
  4. Extract the installer file contents into a temporary location.
  5. Double-click the setup file. For Windows, this file is named setup.exe. For Linux, this file is named setup.bin. If a security access message appears, click Yes.
    The installer Welcome screen appears.
  6. If you want to install in a language other than English, click the down arrow and select a language. 
  7. Click OK.
    The Installer wizard verifies that your server meets the requirements and then the License Agreement pane appears.

    Note

    For Windows systems: If you did not modify the Terminal Services settings, a notification window appears with instructions to update the Terminal Services. You must exit the Installer, modify the settings, restart the server and start the Installer wizard again.

  8. Select I agree and click Next.
    The Installation Documentation pane appears, offering a link to the Installation Guide.
  9. Click Next.
    The Installer wizard processes your selections so far and then the Installation Folder pane appears.
  10. Accept the default location or click Browse to select an installation folder.
    The selected folder must be empty.
  11. Click Next.
    The Administrator Setup pane appears.
  12. Enter the authentication information:
    1. Type values in the Login name, Password & Re-type password fields.

      Tip

      - Login Name must be between 8 and 50 characters. The first character must be a letter or a number. The following characters are not allowed: @\[]()":;|<>+=,?*.

      - Passwords must be between 8 and 50 characters long and must contain at least one uppercase letter, one lowercase letter, one numeral, and one special character. No character should be repeated more than three times. Passwords are validated by the system.

    2. Enter information in the Full name and Email address fields.
      The administration email address you provide cannot include the plus (+) or dash (-) characters.
  13. Click Next.
    The Encryption Key Setup pane appears.
  14. Enter the encryption key phrase that you want to use. If this phrase is not already recorded offline, save this phrase now at an appropriate location.
    Encryption key phrases must be between 8 and 80 characters long. Any characters or symbols may be used.
  15. Click Next.
    The Encryption Warning pane may appear.
  16. Click Next.
    The Identify and Configure Tomcat Web Server pane appears.
  17. Select the location of an installed Tomcat Web Server:

    1. Click Browse to select the installed server.
    2. If the Tomcat configuration files are not in the same location as the server, select Tomcat configuration files are installed in a different folder.
      The  Folder of installed Tomcat configuration files field appears.
    3. Click Browse to select the location and click Next.
      The select engine and host pane appears, showing the discovered information.
  18. (Optional) Select Tomcat Web Server information:

    1. In the Engine field, select the Tomcat Web Server Engine that you want to use.
    2. In the Host field, select the Tomcat Web Server Host that you want to use.
  19. Click Next.
    The Database Setup and Configuration pane appears.
  20. Complete the fields to create the database and enter your access credentials:

    1. if you are not directly on the machine and are connecting through Terminal Services, modify, select the type of database, and click Next.
      The installer verifies that your selections are valid, and the authentication pane appears.

      Note

      If you select to install SQL Express, the requirements pane appears, recommending that you review the hardware and software requirements before proceeding. Click Next.

    2. Enter your user credentials and other connection information for the server and click Next
      • SQL Server: you will be asked for the Server Instance name to connect to, a SQL user name and password to use that has the permission to create database, create user, and create table, and the port to use to connect. You can also choose to use windows credentials instead of a SQL user that must have the same permissions. The user credentials will only be used during the install and not saved for future use. 
      • PostgreSQL: you will be asked for the Host name, a SQL user and password with permission to create database, create user, and create table, a port, and a system database name. The user credentials will only be used during the install and not saved for future use. The system verifies access to the database, and the Database objects permissions pane appears.
    3. Select Allow installer to create database or Use existing database.
    4. If you selected Use existing database, select the database from the list.
  21. Click Next.
    The system verifies that the selected database is available. If you selected SQL Express, the password entry pane appears. Otherwise, the FootPrints Database Users pane appears; proceed to step 22.

  22. For SQL Express:

    1. Enter the password for the "sa" account defined in SQL Server Express.
    2. Click Next.
      The FootPrints Database Users pane appears.
  23. The installer creates three database users that are used by the system while making calls to the database as the application is being used. If you do not like the suggested passwords, you can enter your own passwords. Ensure to store these passwords elsewhere in an encrypted file.

    Tip

    Passwords must be at least six characters and include at least one lowercase letter, one uppercase letter, one number, and at least one number sign (#) or dollar sign ($). In addition, no character can be used consecutively more than twice.

  24. Click Next.
    The report user pane appears.
  25. The installer creates a database user for optional use if you decide to connect to the database with a third party tool in the future. Enter a password for this user.

    Tip

    Passwords must be at least six characters and include at least one lowercase letter, one uppercase letter, one number, and at least one number sign (#) or dollar sign ($). In addition, no character can be used consecutively more than twice. Ensure to save this password elsewhere.


  26. Click Next.
    The Application URL pane appears.
  27. Enter the path that someone will use to get to the application from their web browser in the FootPrints Server URL and Port field.

    Tip

    For example,

    - FootPrints Server URL: http://servicedesk.mycompany.com:8080. If this is not yet known, enter the IP address or fully qualified domain name of the server followed by a colon which is followed by the port.

    - The default port for Tomcat is 8080. If this is not known, enter "http://localhost:8080".

    For the FootPrints Application Path field, enter the string that appear must appear after the previous when accessing the application from their web browser. If this is not known, retain the default value.

  28. Click Next.
    The Ready to Install summary pane appears. You can copy this summary to store elsewhere.
  29. Review the contents of the summary and then click Install.
    The installer checks that there is sufficient disk space. If so, the progress pane appears. Errors display in this pane when they occur. When installation is complete, a success message appears.
  30. To view the installation log, click View Log.
    The log details appear in a new window. You can click an error to view additional details. If a Tomcat server was installed, it will be started.
  31. Click Finish.
    The installer closes all windows that it opened.
  32. Install a 30-day trial license:
    1. Log on to FootPrints.
      The Manage License page appears, showing a message to download a 30-day trial license.
    2. Click the message.
      The demo license download page opens in a new browser window.
    3. Download the license file.
    4. Return to the Manage License page and click Load License.
      The File Upload dialog box appears.
    5. Navigate to the license file and open it.
      The license is uploaded. If no workflow process is defined in your environment, the Create a new Business Process page appears.
    6. Select a Business Process template to help you get started with working in FootPrints. Selecting a Business Process Templates configures a lot of out-of-the-box common functionality. Unless you are an expert, you should choose a template
      For more information about using Business Process templates, see Configuring business processes using the out-of-the-box templates .
  33. Start the Tomcat server.
    Installation is completed.

Related topics

Installing

Upgrading FootPrints version 12 to a newer version

Uninstalling FootPrints

Administering

Was this page helpful? Yes No Submitting... Thank you

Comments

  1. Linda Kirkpatrick

    I'm digging pretty hard to find the prerequisite info for the install here. Instructions for how to install tomcat, java, etc....

    Feb 09, 2019 04:16
    1. Dottie Wood

      Hi, Linda. Thanks for reaching out to us!

      In steps 3 and 4 of the Prerequisites topic, you can find links to Knowledge Base articles that explain how to install and configure Java and Tomcat. The writing team will look into adding those links to this topic. Again, thanks for your input!

       

      Feb 11, 2019 01:01
      1. Dottie Wood

        Hi, Linda. Step 1 in this topic now includes a link to the Prerequisites topic. Thanks!

        Feb 20, 2019 09:50