Installing AppScan® Source and integrating it with an existing AppScan® Enterprise Server

In this scenario, AppScan® Source components are installed on one machine - and they are configured to connect to an existing AppScan® Enterprise Server.

About this task

This scenario is divided into two sections:
Important:

Installing AppScan® Source

Procedure

  1. Locate the HCL® 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 FlexNet Operations).
  2. Extract the image to a local drive. In the resulting directory:
    • Microsoft Windows: Run AppScanSrc_Installer.exe
    • Linux: Run setup.bin as root.

    Detailed information about launching the installation wizard can be found at Starting the installation wizard.

  3. 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.
  4. The installation wizard displays an important notice regarding licensing. For additional information on licensing, see How to obtain and apply licenses for AppScan Source products. If you have HCL licenses available, click OK to proceed.
  5. After you launch the installation wizard, the Welcome - Installation Wizard panel opens and recommends that you quit any open applications. Click Next to begin the installation procedure.
  6. In the Component Selection installation panel, select the components to install. AppScan® Source components are divided into server and client components:
    1. To install AppScan® Source server components, select Server Component Selection and then choose the components to install:
      • AppScan® Source for Automation
    2. To install AppScan® Source client components, select Client Component Selection and then choose the components to install:
      • AppScan® Source for Analysis
      • AppScan® Source Command Line Interface
      • AppScan® Source for Development for Visual Studio 2019
      • AppScan® Source for Development for Eclipse, RAD, MobileFirst (not selected by default)

      By default, when Client Component Selection is selected, the AppScan® Source for Development plug-in components are deselected and all other components are selected.

    After you have selected the components that you want to install, click Next to advance to the next installation panel.
  7. In the Install Model installation panel, specify whether you want to configure AppScan® Source to work with AppScan® Enterprise Server or as a standalone tool.
    • AppScan® Source Enterprise Mode

      Scan configurations, filters, rules, and assessments can be shared across AppScan® Source clients.

    • AppScan® Source Standalone Mode

      Scan configurations, filters, rules, and asssessments are stored locally and cannot be shared across AppScan® Source clients.

    After making your choice, click Next to advance to the next installation panel.
  8. In the Installation Target Specification page, specify the installation directory. The default directories, by operating system, are:
    • 64-bit versions of Microsoft Windows:
      <SYSTEMDRIVE>:\Program Files\HCL\AppScanSource
    • Linux: If you are the root user, the Installation Wizard installs your software in /opt/hcl/appscansource. If you are not the root user, you can install the AppScan® Source for Development Eclipse plug-in - which installs to <home_directory>/AppScan_Source by default.
    Important:
    • The installation directory name can only contain English characters. Folders with names containing non-English characters are not permitted.
    • If you are installing on Windows, you must have Administrator privileges to install AppScan® Source components.
    • If you are installing on Linux, you must have root privileges to install AppScan® Source server components.

    Click Next to advance to the next installation panel.

  9. Enter the username and password to start the Automation server.

    If you have already provided AppScan® Enterprise server details on Server Connection page, the Automation server host will be enabled.

    Click Next to advance to the next installation panel.

  10. 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.
  11. Review and accept the terms of the license agreement and then click Next to continue.
  12. 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.

  13. In the Installation Complete panel, you can initiate product activation immediately after exiting the installation wizard by selecting Launch HCL® AppScan® Source License Manager. Click Done to complete the standard installation and exit the Installation Wizard.
  14. In the License Manager utility:
    1. To apply a license file, click Import and then browse to your downloaded AppScan® Source license.
    2. 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.

Logging into AppScan® Source

About this task

Refer to the section below for a description of the fields requested when you log in. For detailed information, see Logging in to AppScan Enterprise Server from AppScan Source products.

Procedure

  • User ID: Specify your user ID.
  • Password: Specify the password for your user ID.
  • AppScan Enterprise Server: Specify the hostname for your AppScan® Enterprise Server instance in the existing URL format. If the AppScan® Enterprise Server is located on the same machine, specify https://localhost:9443/ase/ or localhost. If the AppScan® Enterprise Server is located on a remote machine, specify the fully-qualified host name of the machine on which it is installed.
    Tip: If the fully-qualified host name does not work, try entering the IP address of the host machine.