Non-install panel installation steps
These instructions guide you through the complete AppScan® Source default installation. By default, the standard desktop installation installs the AppScan Source Database, AppScan Source for Analysis, and the AppScan Source command line interface (CLI).
Procedure
- 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).
- Locate the AppScan Source product zip file (in your AppScan Source media pack - or the electronic image that you downloaded as part of a AppScan Source eAssembly at FlexNet Operations).
-
Extract the image to a local drive. In the resulting directory:
- Microsoft™ Windows™: Run AppScanSrc_Installer.exe
- Linux™: On 32-bit systems, run setup.bin. For 64-bit systems, see Installing AppScan Source results in error "Graphical installers are not supported by the vm".
Detailed information about launching the installation wizard can be found at Starting the installation wizard.
-
Extract the image to a local drive and, in the resulting directory, locate and run
setup.exe. Detailed information about launching the installation wizard
can be found at Starting the installation wizard.
Note: There are images for each product in the AppScan Source family. The setup.exe file is located at the root of these zipped images.
- Ensure that the AppScan Enterprise Server has been installed and that connection information for it has been provided by your administrator. See AppScan Enterprise Server overview to learn more about the server.
- Start the installation wizard.
- 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.
- 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.
- 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.
- In the Component Selection
installation panel, select Server Component Selection and
then choose the components to install:
- AppScan Source Database
- AppScan Source for Automation
After you have selected the components that you want to install, click Next to advance to the next installation panel.
- In the Component Selection
installation panel, 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 (not selected by default)
- Windows only: AppScan Source for Development Visual Studio plugins (not selected by default)(Visual Studio plugin options are available only if the installer has detected Microsoft Visual Studio on your system)
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.
- 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 (x86)\ibm\appscansource
- Linux: If you are the root user, the Installation Wizard installs your software in /opt/ibm/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.
- 64-bit versions of Microsoft
Windows:
- If you choose to install a solidDB® database
in the Database selection panel, you are prompted with the Configure solidDB Admin
User panel. In it, configure the solidDB database
administrator account. The default database administrator user name
and password are both dba. You cannot change
this user name, however, the password can be changed.Note: To learn how to change the user password after completing the product installation, see Changing solidDB user passwords after installation.
Click Next advance to the next installation panel.
- The Configure solidDB AppScan
Source User
panel allows you to configure the solidDB AppScan
Source database
user account. You can retain the default user name, ounce,
and default password, ounce. All components
that read from or write to the AppScan Source
Database use
this account.Note:
- If you change the user names and passwords, you must keep a record of the new configuration in case your HCL® support representative requires access to your AppScan Source Database.
- To learn how to change the user password after completing the product installation, see Changing solidDB user passwords after installation.
Click Next to advance to the next installation panel.
- 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 HCL
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:
- AppScan Enterprise Server: Specify the URL for your AppScan Enterprise Server instance.
- User ID: Specify your AppScan Enterprise
Server administrator user ID. If the server is configured for Windows authentication, enter the Windows user ID
that was used when your account was added to the server (the user ID must be in the format
<host name>\<user id>
). - Password: Specify the password for your AppScan Enterprise Server user ID.
- Database Host Name: Specify the host name for the machine on which you
have installed the AppScan Source
Database.Note: The entry in this field should always be the fully-qualified host name of the machine on which the installer is running. This value should be pre-filled in this field at install time and should only be changed if the value has pre-filled incorrectly.
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 at Registering the AppScan Source Database with AppScan Enterprise Server . 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 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.
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/
orlocalhost
. 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. -
AppScan Enterprise Server: Specify the hostname for your AppScan Enterprise
Server instance in the existing URL format. For this installation scenario, specify
https://localhost:9443/ase/
orlocalhost
. -
AppScan Enterprise Server: Specify the hostname for your AppScan Enterprise
Server instance in the existing URL format. For this installation scenario, specify the
fully-qualified host name of the machine on which the AppScan Enterprise
Server is installed.
Tip: If the fully-qualified host name does not work, try entering the IP address of the host machine.