Procedure
- Upgrade the AppScan® Enterprise Server according
to the installation instructions provided with it. See AppScan Enterprise Server overview to learn more about the server.
- Locate the IBM® Security AppScan Source product
zip file (in your AppScan Source media
pack - or the electronic image that you downloaded as part of an AppScan Source eAssembly
at IBM Passport Advantage®).
- Extract the image to a local drive. In the resulting directory:
Detailed information about launching the installation wizard can be found in the Starting the installation wizard topic in the IBM Security AppScan Source Installation
and Administration Guide.
- You are presented with a screen that
allows you to select the national language that will be displayed
in the installation panels. Select the language and click OK to
proceed.
- After you launch the installation
wizard, the Welcome - Installation Upgrade Wizard panel opens and
recommends that you quit any open applications. Click Next to
proceed.
- If your existing installation
included the AppScan Source Database,
the Server Connection panel opens, followed by Database upgrade
and maintenance panels.
- In the Server Connection panel, choose one of these options:
Important: - If the Enterprise Server that you will connect to is enabled for NIST 800-131a compliance, you cannot test a connection to
the server. In this case, proceed without specifying a server. After the installation of AppScan Source
and the Enterprise Server are complete, follow the instructions for Registering the AppScan Source Database with AppScan Enterprise Server,
ensuring that the Force TLSv1.2 option is applied.
- If your AppScan Enterprise Server has been set up with Common Access Card (CAC) authentication, select Let me proceed
without specifying a server and then use the appscanserverdbmgr_cac
utility for all server connection settings and tests.
Click Next to advance to the next installation panel.
- The next installation panel advises
you that the Database will
be updated during the installation and that the update can take up
to 30 minutes. You should not cancel the installation or power down
your computer during the Database upgrade.
Click Next.
- To facilitate Database maintenance,
enter the credentials for your solidDB® AppScan Source database
user account and then click Next when you are
ready to proceed with the Database upgrade.
- In the language pack selection panel,
choose the language packs to install. When you install a language
pack, the AppScan Source user
interface will display in that language when it runs on an operating
system that is running that locale.
By default, English is
selected (and cannot be deselected). If the installation wizard is
displaying a national language other than English (in other words,
a language other than English was selected in the installation wizard
welcome panel), that language will also be selected in this panel
(however, it can be deselected).
After you have selected the
language packs that you want to install, click Next to
advance to the next installation panel.
Note: If you do not install
a specific language pack, you will not be able to add that language
post-installation.
- Review and accept the terms of the
license agreement and then click Next to continue.
- Review the summary of installation
options before proceeding. If you want to change your selections,
click Previous to return to the previous pages.
When you are satisfied with your installation choices, click Install.
The installer copies files to the hard disk drive.
For Linux server installations only:
After copying files, you must identify the daemon user. Select Create
User 'ounce' or Run with Existing User,
either to create the default user, ounce, or run
with an existing user. (The installation validates that the user exists.
Note that the selected user must have a valid shell.)
During
the installation, clicking Cancel at any time
results in the uninstallation of all components.
- In the IBM Security AppScan Enterprise
Server Configuration panel, specify the settings that will allow a solidDB
database to connect to the AppScan Enterprise Server. By default, this installation panel pre-fills with entries that assume the database and server
are installed on the same machine, with default settings. To configure the AppScan Source Database with the AppScan Enterprise Server, select the Configure the AppScan Enterprise Server now check box and
complete these settings:
Click Next to advance to the next installation panel.
Note: If you will be using an Oracle database, ensure that
Configure the AppScan Enterprise Server now is not selected and then click
Next. This installation panel is not used for registering an Oracle database
with the Enterprise Server. Instead, configure the database connection post-installation using a utility that is included
with AppScan Source.
Information about this can be found in the Registering the AppScan Source Database with AppScan Enterprise Server topic
in the IBM Security AppScan Source Installation
and Administration Guide. This utility can also be used to configure a solidDB
connection instead of using this installation panel.
- In the Installation Complete panel, you can
initiate product activation immediately after exiting the installation
wizard by selecting Launch IBM Security AppScan Source License
Manager. Click Done to complete
the standard installation and exit the Installation Wizard.
- In the License Manager utility:
- To apply a license file, click Import and
then browse to your downloaded AppScan Source license.
- To apply a floating license, click Configure
license servers and then click Add.
Enter the information for the host machine that contains the floating
license.
See Activating the software for additional activation instructions.
Results
As of AppScan Source Version
8.7, application data is stored outside of the installation directory.
If you are upgrading from AppScan Source Version
8.6.x or earlier, your existing application data will be moved to
the Default AppScan Source data directory.
In addition, a backup of your existing (pre-Version 8.7) application
data will be stored in <data_dir>/upgrade_backup (where <data_dir> is
the location of your AppScan Source program
data, as described in Installation and user data file locations).
As
of AppScan Source Version
9.0, the AppScan Source for Development Eclipse plug-in is
supported on macOS. If you are upgrading from AppScan Source Version
8.8.x or earlier on macOS, AppScan Source for Development features
will be available for install into Eclipse environments after the
upgrade is complete (use of these features requires the appropriate
license). For information about installing AppScan Source for Development to
Eclipse environments, see Applying the AppScan Source for Development (Eclipse plug-in) to Eclipse and supported Eclipse-based products.