This topic explains how to install the C/C++test plugin into a working copy of Eclipse or Linux system.

The section includes:

Prerequisites

System Requirements

Linux 64-bit

  • Linux with glibc 2.12 or higher
  • 4GB memory minimum, 8GB recommended
  • 2GHz or faster processor (x86_64-compatible), multi-CPU configuration recommended
  • Supported C / C++ compiler (see Compilers for a list of supported compilers)

Linux 32-bit (deprecated)

  • Linux with glibc 2.12 or higher
  • 4GB memory minimum, 8GB recommended
  • 2GHz or faster processor (x86-compatible), multi-CPU configuration recommended
  • Supported C / C++ compiler (see Compilers for a list of supported compilers)

Proper Compiler Configuration is Critical

In most cases, C/C++test needs to invoke the compiler and linker in order to perform static analysis and runtime testing tasks, which commonly involve preprocessing, compiling, and linking programs.

To access C/C++test’s full functionality, the machine where C/C++test is run must have the complete development environment and compiler tool chain.

IDE Requirements

  • Eclipse IDE for C/C++ Developers and a Java Runtime Environment (JRE) supported by Eclipse
  • Wind River Workbench
  • ARM DS-5
  • Texas Instruments Code Composer Studio

See IDE Support for details about supported versions.

Other Requirements

  • All users must be able to write to the Eclipse configuration directory. If all users cannot write to the current Eclipse configuration directory, then the location of that directory must be changed. To change the directory location, open the <Eclipse_Installation_dir>/configuration/config.ini file, then add a line of the format [email protected]/EclipseConfigData (Be sure to enter the appropriate location.) This configures Eclipse to keep all its configuration data in the $(HOME)/EclipseConfigData directory. You must have full access rights to that location
  • If earlier versions of C/C++test are installed on your system, the latest version of C/C++test must be installed in a fresh directory. Please install C++test in a different directory than the previous version installation, and then modify the PATH to point to the new installation.
  • During installation, you need to have permission to write to the Eclipse installation directory.
  • Additional disk space is required for C/C++test project data.
  • The recommended Japanese language encoding is Shift_JIS (ja_JP.PCK locale on Unix). Other encodings might cause font problems or prevent C/C++test from reading test results.
  • Installation scripts require that the working directory has write permissions.

Warning - Critical workaround for installations where some users have restricted write privileges

Known issues with the location of Eclipse configuration/cached data (https://bugs.eclipse.org/bugs/show_bug.cgi?id=54919) could prevent Eclipse from starting properly once C/C++test is installed.

To prevent this problem:

  1. Open the  <Eclipse_Installation_Dir>/configuration/config.ini file for editing.
  2. Add the following line (the actual directory name can be changed): [email protected]/EclipseConfigData

As a result, Eclipse should keep all its config data in $(HOME)/EclipseConfigData directory (you miust have full access rights to that location).

Multi-user installations

For details on running multiple instances of Eclipse with C/C++test in parallel see Multi-user Installations.

Installation

Parasoft Test Components

C/C++test Professional includes Parasoft Test components that are common across a number of Parasoft products version 9.x. If you want to use C/C++test Professional and other Parasoft Test 9.x products on a single Eclipse installation, run C/C++test installation as described below and specify the same Eclipse installation directory as the other Parasoft Test products use.

If Parasoft Test is already installed, it will be upgraded to the latest version (if needed) during C/C++test installation.

To install the C/C++test plugin for Eclipse on Linux:

  1. Copy the distribution file to the target location.
    • Because Linux does not have any restrictions on having multiple versions of the same software installed on the same machine, the best way to install C/C++test is to provide a separate directory for each version.
    • For example, if your software is installed in /opt/app/, then the recommended installation directory configuration should be something like /opt/app/parasoft/cpptest-extension/<version>. Version 10.3 could be installed in /opt/app/parasoft/cpptest-extension/ 10.3/ and version 10.4 could be installed in /opt/app/parasoft/cpptest-extension/10.4/. This provides the safest, most intuitive, and most flexible installation structure. During the installation, you will be prompted to enter a destination location for C++test Extension and Parasoft Test Extension files; defaults will be "parasoft/cpptest-extension/<version>" and "parasoft/test-extension/<version>". In this case, the target location for the distribution file should be /opt/app.
  2. Unpack the installation script using the appropriate command(s):
    • gunzip cpptest_<version>_<arch>.tar.gz
      tar -xf cpptest_<version>_<arch>.tar
  3. Execute the following command to run the installation script:
    • .cpptest_<version>_<arch>.sh
  4. Choose the appropriate Eclipse/CDT target platform type.
  5. Enter your Eclipse (or Development Suite) installation directory, then click OK.
    • Choose the directory that contains .eclipseproduct.

If you later want to uninstall C++test:

  1. Go to the C/C++test installation directory.
  2. Execute extuninstall C/C++test will then be "unregistered" from Eclipse.
  3. (Optional) Remove C/C++test files from the hard drive.

Alternative installation methods

For details on performing a silent installation see Preconfiguration C++test During Installation.

Startup

Before launching C/C++test

To allow C/C++test to autodetect compiler and makefile settings, ensure that the necessary executables (compiler/linker, makefile, etc.) are correctly configured. "Correctly configured" means different things on different compilers, but it typically involves ensuring that the executable is on the PATH.

To launch the plugin:

  • Launch Eclipse as normal.

Eclipse will automatically find the C/C++test plugin.

After Eclipse is launched, you should see a Parasoft menu added to the Eclipse menu bar. If you do not see this menu, choose Window> Open Perspective> Other, select C++test, then click OK.

If you suspect that C/C++test is not properly installed, see Troubleshooting and FAQs for help resolving some common installation problems.

  • No labels

Need assistance? Visit our support page