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
- Start the installation
wizard.
- Installation on macOS requires an
administrator password. When you are prompted with an authentication
dialog, enter the administrator password.
- 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 Wizard panel opens and recommends that
you quit any open applications. Click Next to
begin the installation procedure.
- In the Component Selection
installation panel, select the components to install. AppScan
Source components
are divided into server and client components:
- 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.
- 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.
- 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.
-
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.
- 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 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.
- 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.
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
- 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