You can preconfigure the Parasoft Test component during installation. Parasoft Test is a framework shipped with Parasoft products that enables many common functionalities, such as code analysis and test execution.
This topic explains how you can preconfigure Virtualize during installation to streamline consistent installation across multiple team machines. This process applies to all supported platforms and IDEs.
Sections include:
| Table of Contents |
|---|
Preconfiguring the Installation
To preconfigure Virtualize during installation:
- Create a localsettings file that includes the options you want to preconfigure the installation with. See Localsettings for details on available options.
Pass that localsettings file to the installer using the
/configureor--configureparameter.
For example:Windows:
/configure=<path-to-localsettings-file>Unix:
--configure <path-to-localsettings-file>
The localsettings file will be copied into the root directory of Parasoft Test as parasofttest.ini. Settings from that file are used to initialize a clean workspace during startup.
| Tip | ||
|---|---|---|
| ||
You can also configure licensing upon command line startup using -localsettings. For details, see Licensing. |
If you want to apply settings to an existing workspace, you need to add an additional property to the localsettings file: enforce.configure=true. This overrides existing settings during the first startup after the installation/reinstallation.
Note that with the Windows installer:
- If the same version (or a newer version) of Parasoft Test is installed on the machine, the localsettings file won't be copied during installation or reinstallation.
- If the location passed in
/ParasoftTestDiris different than the location of an existing Parasoft Test installation, the localsettings file won't be copied during reinstallation.
Windows Options
| Scroll Table Layout | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
| Option | Description |
|---|---|
| /SILENT /VERYSILENT | Run installer in silent mode. The wizard and the background window are not displayed. |
| /DIR=<location> | Destination location for installed product's files. |
| EclipseDir=<location> | Location of target platform. |
| /Configure=<localsettings file> | Pre-configure product during installation step. |
| /ParasoftTestDir=<location> | Destination location for Parasoft Test's files (Use this option if Parasoft Test is not already installed). |
See http://www.jrsoftware.org/ishelp/index.php?topic=setupcmdline for additional options and help.
Additional Notes about Windows Installation
- If the same version (or a newer version) of Parasoft Test is installed on the machine, the localsettings file won't be copied during installation or reinstallation.
- If the location passed in
/ParasoftTestDiris different than the location of an existing Parasoft Test installation, the localsettings file won't be copied during reinstallation.
UNIX Options (for Linux, or Mac)
| Option | Description |
|---|---|
| --install-dir <location> | Destination location for installed product's files. |
| --configure <localsettings file> | Pre-configure product during installation step. |
| --parasofttest-install-dir <location> | Destination location for Parasoft Test's files. |
| --help | Prints the available command line options. |
Examples
| Code Block | ||||
|---|---|---|---|---|
| ||||
parasoft_soavirt_<version_arch>.exe /SILENT /DIR=<soavirt dir> /ParasoftTestDir=<parasofttest dir> /configure=<localsettings file>
parasoft_soavirt_<version_arch>_eclipse_plugin.exe /SILENT /DIR=<soavirt dir> /ParasoftTestDir=<parasofttest dir> /EclipseDir=<eclipse dir> /configure=<localsettings file> |
| Code Block | ||||
|---|---|---|---|---|
| ||||
parasoft_soavirt_<version>_linux.sh --non-interactive --install-dir <soavirt dir> --parasofttest
-install-dir <parasofttest dir> --configure=<localsettings file>
parasoft_soavirt_<version>_linux_eclipse_plugin.sh --non-interactive --install-dir <soavirt dir>
--parasofttest-install-dir <parasofttest dir> --target-location <eclipse dir> --configure=<localsettings file> |
Sample localsettings File
Here is a sample localsettings file that configures Team Server and License.
| Code Block |
|---|
soatest.license.use_network=true soatest.license.network.host=main1.parasoft.com.pl soatest.license.network.port=2222 soatest.license.network.edition=server_edition virtualize.license.use_network=true virtualize.license.network.host=main1.parasoft.com.pl virtualize.license.network.port=2222 virtualize.license.network.edition=server_edition tcm.server.accountLogin=true tcm.server.enabled=true tcm.server.name=main1.parasoft.com.pl tcm.server.password=test tcm.server.port=18888 tcm.server.username=test enforce.configure=true |