This topic explains how to install C/C++test Professional.

Introduction

C/C++test is available as an Eclipse-based standalone version, as well as a plugin for Eclipse, which can be installed in any of the supported IDEs using the standard Eclipse plugin installation mechanism.

Installing C/C++test Standalone

To install C/C++test:

1. Extract the contents of the installation package to a desired location. The cpptest directory that contains all C/C++test files will be created. In this document, the cpptest installation directory is referred to as <INSTALL_DIR>.
   On Windows, some utilities for unpacking archives may prevent extracting the contents of the distribution package if the path to the extraction location exceeds 98 characters.
2. (optional) Add <INSTALL_DIR> and <INSTALL_DIR>/bin  to $PATH to enable convenient access to the cpptest and cpptestcli executables, and the utility tools shipped with C/C++test.

Launching C/C++test Standalone

To launch the C/C++test GUI, run <INSTALL_DIR>/cpptest.

To use C/C++test in the command line mode, run <INSTALL_DIR>/cpptestcli.

Uninstalling C/C++test Standalone

To uninstall C/C++test, close the C/C++test GUI and remove <INSTALL_DIR> from disk.

Installing C/C++test as a Plugin

To install C/C++test:

1. Extract the contents of the installation package to a desired location. The cpptest directory that contains all C/C++test files will be created. In this document, the cpptest installation directory is referred to as <INSTALL_DIR>.
   On Windows, some utilities for unpacking archives may prevent extracting the contents of the distribution package if the path to the extraction location exceeds 126 characters.
   
2. (optional) Add <INSTALL_DIR> and <INSTALL_DIR>/bin  to $PATH to enable convenient access to the cpptestcli executable and the utility tools shipped with C/C++test.
3. Open your IDE.
4. Choose Help> Install New Software in the menu bar.
5. Click Add.
6. Click Archive and choose <INSTALL_DIR>/integration/eclipse/parasoft_cpptest_professional-eclipse-<version>-p2-<os_arch>.zip.
7. Select Parasoft C/C++test.
   
   We recommend that you disable the Contact all update sites during install to find required software option to avoid accidental upgrades of Eclipse components.
8. Click Next and follow the wizard to complete the installation process.
9. Restart the IDE when prompted.

Launching C/C++test Installed as a Plugin

To launch the C/C++test GUI, open the IDE where the Parasoft C/C++test plugin is installed.

To use C/C++test in the command line mode, run <INSTALL_DIR>/cpptestcli.

Uninstalling C/C++test and the C/C++test Plugin

To uninstall C/C++test:

1. Close the C/C++test Perspective and all C/C++test views in your IDE.
2. Choose Help> About Eclipse IDE> Installation Details> Installed Software.
3. Select Parasoft C/C++test.
4. Click Uninstall... and restart the IDE when prompted.
5. Remove <INSTALL_DIR> from disk.

Configuring C/C++test Installed as a Plugin

Configuring C/C++test Installation Location

When you install C/C++test as a plugin, the C/C++test installation directory <INSTALL_DIR> must be specified in your IDE.  In typical scenarios, the location of <INSTALL_DIR> is automatically configured on the first startup of Eclipse after the plugin is installed.

To manually configure the C/C++test installation location:

1. Go to Parasoft> Preferences....
2. Enter the path to  <INSTALL_DIR> in the Installation directory field.

You can click Autodetect to automatically detect and configure the location of <INSTALL_DIR>. This may be useful when you're upgrading to a new version of C/C++test and you extracted the installation package to a new location, which requires updating the path to <INSTALL_DIR> in your IDE.

Configuring Eclipse Installation Location

When you install C/C++test as a plugin, the location of Eclipse to be used with cppptestcli must be configured to enable using C/C++test in the command line mode. In typical scenarios, the Eclipse location is is automatically configured on the first startup of Eclipse after the plugin is installed.

You can manually specify the Eclipse location in one of the following ways:

• Create (or modify if already exists) a .pathtoeclipse file that includes the absolute path to Eclipse and save it in the C/C++test installation directory <INSTALL_DIR>.

  D:\eclipses\eclipse_2020-06

• Specify the path to Eclipse when running analysis with cpptestcli by adding the -path-to-eclipse=</absolute/path/to/eclipse> option to your command line.

Advanced Installation Methods

Silent Installation

You can install C/C++test silently - in a non-interactive mode using the command line or a script. For example, this allows you to to adjust the installation process to your organization's infrastructure and policies or to remotely install C/C++test on multiple machines in the headless mode.

To install C/C++test silently:

1. Extract the contents of the installation package to a desired location using a command line extraction utility.
   - If you are installing C/C++test as a standalone application, no additional actions are required.
   - If you are installing C/C++test as a plugin, proceed to step 2.

2. Run the Eclipse executable from the command line with the -application org.eclipse.equinox.p2.director argument to run the p2 director application. The application is a command line tool provided by Eclipse for installing and uninstalling additional software from Eclipse-based products. Your full command line may resemble the following:
   On Windows:

   eclipsec.exe -consolelog -nosplash -application org.eclipse.equinox.p2.director -repository "jar:file:/D:/tools/cpptest/integration/eclipse/parasoft_cpptest_professional-eclipse-2020.2.0.20201019B1123-p2-win32.x86_64.zip!/" -installIU com.parasoft.xtest.cpptest.all.feature.group -profileProperties org.eclipse.update.install.features=true

   On Linux:

   ./eclipse -consolelog -nosplash -application org.eclipse.equinox.p2.director -repository 'jar:file:/home/user/tools/cpptest/integration/eclipse/parasoft_cpptest_professional-eclipse-2020.2.0.20201019B1123-p2-linux.x86_64.zip!/' -installIU com.parasoft.xtest.cpptest.all.feature.group -profileProperties org.eclipse.update.install.features=true

   Refer to the Eclipse documentation for details about the p2 director application.
   You can use the helper scripts shipped with C/C++test in [INSTALL_DIR]/integration/eclipse/tools to help you get started with silent installation.

If you want to pre-configure C/C++test after installation, see Preconfiguring C/C++test During Installation.

Multiple User Installation

To install C/C++test for running multiple instances of Eclipse with C/C++test in parallel; see Multi-user Installations.

Installing C/C++test with Legacy Installers

The installation process described on this page relies on the new generation of Parasoft installers. Should you install C/C++test with legacy installers, please refer to installation section in the Parasoft C/C++test Professional User Guide 2020.2.