Installing AppScan Source on macOS

This topic describes how to install the setup app on macOS.

About this task

As of version 9.0.3.11, AppScan® Source no longer supports macOS or iOS Xcode project scanning.

Procedure

  1. Start the installation wizard.
  2. Installation on macOS requires an administrator password. When you are prompted with an authentication dialog, enter the administrator password.
  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. 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.
  5. In the Component Selection installation panel, select the components to install. AppScan Source components are divided into server and client components:
    1. To install HCL® AppScan Source for Automation, select Server Component Selection and then select AppScan Source for Automation. To learn about installing HCL AppScan Source for Automation, see Installing 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 Eclipse, RAD, MobileFirst

      By default, when Client Component Selection is selected, only AppScan Source for Analysis and AppScan Source Command Line Interface are selected beneath it.

    After you have selected the components that you want to install, click Next to advance to the next installation panel.
  6. In the Installation Target Specification page, specify the installation directory. The default directory is /Applications/AppScanSource.app on macOS.
    Important:
    • The installation directory name can only contain English characters. Folders with names containing non-English characters are not permitted.

    Click Next to advance to the next installation panel.

  7. If the AppScan Source for Automation component was selected for installation, the HCL AppScan Source for Automation Configuration panel displays. Complete this page as follows:

    If your AppScan Enterprise Server authentication method is user ID and password:

    • AppScan Enterprise Server Host Name: The host name or IP address of the AppScan Enterprise Server to which the Automation Server will connect.
    • User Name: Enter the AppScan Source user that the Automation Server uses to process requests.
    • Password: Enter the AppScan Source user's password.
    • Confirm Password: Confirm the password.

    Click Next to advance to the next installation panel.

    If your AppScan Enterprise Server is enabled for Common Access Card (CAC) authentication, leave all fields in this page blank and click Next to advance to the next installation panel.

    Note: If you do not complete the HCL AppScan Source for Automation Configuration panel during installation, or if your AppScan Enterprise Server is enabled for Common Access Card (CAC) authentication, you must configure AppScan Source for Automation after installation to run as an AppScan Source user by specifying login credentials from the command line. See the HCL AppScan Source Utilities User Guide for more information.
  8. 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.
  9. Review and accept the terms of the license agreement and then click Next to continue.
  10. 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.

  11. 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.
  12. 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.

Results

If you installed AppScan Source for Automation and the user account that you specified for it in the Configuration installation panel does not already exist, you will need to create it manually (post-installation) with the AppScan Enterprise Server, AppScan Source for Analysis, or the AppScan Source command line interface (CLI). For complete access to AppScan Source for Automation capabilities, this user account requires these permissions:

  • Application and Project Management
    • Register
    • Scan
  • Assessment Management
    • Save Assessments
    • Publish Assessments
Important: After installing on macOS, AppScan Source may fail to launch if the system host name cannot be resolved. In this case, you may receive a message that includes this warning:
WARNING: "IOP00710208: (INTERNAL) Unable to determine local 
     hostname from InetAddress.getLocalHost().getHostName()"

This occurs because AppScan Source relies on interprocess communication, requiring that localhost and your system host name can be resolved to an IP address.

To resolve this, ensure that localhost and your system host name can be resolved using the nslookup Terminal command. If they cannot be resolved, one way to ensure that they can is to modify your /etc/hosts file to include them. In the /etc/hosts file,

  • Include a mapping of your host name to 127.0.0.1
  • Include a mapping of localhost to 127.0.0.1