Configuring Application Security after an upgrade

After you upgrade Application Security and enter your Application Security web address in a browser window, the Setup wizard opens. Use the Setup wizard to perform the database data migration and reseed the database.

1. Open the <fortify.home>/<app_context>/init.token file in a text editor.
2. Copy the contents of the init.token file to the clipboard.

3. Open a web browser and type your Application Security server URL.

4. Click ADMINISTRATORS.

5. In the Setup wizard sign in, paste the string you copied from the init.token file into the Security Token field, and then click SIGN IN.

6. If you need to change any configuration settings on the CONFIGURATION or CORE CONFIGURATION SETTINGS pages, you can do so using the instructions provided in Configuring Application Security for the first time.

7. Click NEXT until you reach the DATABASE SETUP page.

8. On the DATABASE SETUP page, do the following:

   1. In the DATABASE TYPE box, select the type that matches the Application Security database type.

   2. In the DATABASE USERNAME box, type the username for your Application Security database.

      For more information, see Database user account permissions.

   3. In the DATABASE PASSWORD box, type the password for your Application Security database.

   4. In the JDBC URL box, type the URL for the Application Security database.

      The database name (including letter case) in the JDBC URL must exactly match your Application Security database name.

      The MariaDB JDBC driver connects to the MySQL database server. Any JDBC URL parameters must use MariaDB driver syntax. Example of the correct collation parameter syntax:

      jdbc:mysql://<host>:3306/<database_name>?sessionVariables=collation_connection=<collation_name>

      Replace the parameter connectionCollation=<collation_name> with sessionVariables=collation_connection=<collation_name>.

   5. To test the connection to your database, click TEST CONNECTION.

      If the connection test fails, check the <fortify.home>/<app_context>/logs/ssc.log file to troubleshoot the cause.

   6. After the Setup wizard indicates that the connection was successful, read the warning and instructions, and then click DOWNLOAD SCRIPT.

   7. Save and run the ssc-migration.sql script.

      For instructions, see About the Application Security database tables and schema.

      Depending on the size of the source database, data migration might take several hours to complete.

9. After you run the ssc-migration.sql script, click NEXT.

10. On the DATABASE SEEDING page, do the following:

    1. Click BROWSE to locate and select your process seed bundle ZIP file, and then click SEED DATABASE.
    2. Click BROWSE to locate and select your report seed bundle ZIP file, and then click SEED DATABASE.
    3. (Optional) Click BROWSE to locate and select your PCI SSF seed bundle ZIP file, and then click SEED DATABASE.
    4. (Optional) Click BROWSE to locate and select your PCI basic seed bundle ZIP file, and then click SEED DATABASE.
11. Click NEXT.
12. Click FINISH.

13. Restart Tomcat server.