Installation and Upgrade

System requirements

Klocwork Solo for Java is supported on the following Windows platforms:

Hardware platform support

• Disk space

The Klocwork Solo for Java plug-in requires 20 Mbytes of disk space.

Processor speed

1 GHz or better

RAM

1 Gbyte

Licensing

A full license allows you to analyze up to 1,000 files per project. A trial license allows to you analyze 300 files per project.

Note: Licensing fails when using Remote Desktop.

IDE, RAD, and Java support

Supported Eclipse versions

Klocwork Solo works as an integrated component of Eclipse 3.2, 3.3, and 3.4.

Supported IBM Rational Application Developer versions

Klocwork supports RAD 7.x.

Supported Java versions

Klocwork supports Java 1.5 and 1.6. In addition, the following Java frameworks are supported: J2EE, J2SE, and J2ME.

Install Klocwork Solo

To download the local, remote or archive site, you must register with Klocwork.

Downloading

If you plan to install by local or archive site, use the Download button at https://download.klocwork.com.

Installing the update site

• Start Eclipse.
• For:

  Eclipse 3.2 or 3.3	Eclipse 3.4
  Go to Help > Software Updates > Find and Install. Click Search for new features to install.	Go to Help > Software Updates. Click the Available Software tab. Click Add Site.

Click here if you are installing by remote site.

1. Click Local or Archive.
2. Browse to the location of your local or archived site and click Open and click OK.

   The update site is added to the list of sites to search.

3. For:

   Eclipse 3.2 or 3.3	Eclipse 3.4
   Add a check to the new Klocwork update site, and then click Finish. Select your site and click Next. Accept the license terms, and click Next. Click Finish. The Feature Verification panel appears. Click Install All.	Click Install. Click Finish.

4. When you are prompted to restart Eclipse, click Yes.

When Klocwork Solo for Java is installed, you can see and access the Klocwork icons and Project Explorer pop-up menu.

Upgrading

If you have a previous version (Klocwork Developer for Java 7.6), you must uninstall it before installing the new version.

Check the plug-in version

To check which version of the Eclipse plug-in you have installed, do the following:

1. From the Help menu, choose About Eclipse SDK.
2. Click the Klocwork icon.

   The version information for Klocwork Solo is displayed.

Uninstall Solo from Eclipse

Uninstallation removes the plug-in but does not remove any of your data, such as projects, configuration files, license files, or reports.

Uninstall from Eclipse 3.2 and 3.3

To uninstall Klocwork for Java from Eclipse 3.2 and 3.3:

1. If the Klocwork perspective is open, close it.
2. From the Help menu, click Help > Software Updates > Manage Configuration.

   The Product Configuration dialog appears.

3. Expand the items in the navigation pane until you see the Klocwork directory. Right-click the Klocwork directory and select Uninstall.

   When you're prompted to restart Eclipse, click Yes.

   Eclipse restarts and the Klocwork buttons and menu items are no longer present. Klocwork projects remain in their storage location.

Uninstall from Eclipse 3.4

1. Start Eclipse, and click Help > Software Updates.

   The Feature Updates window appears.

2. On the Installed Software tab, click Klocwork for Java.
3. Click Uninstall.

   The Uninstall dialog appears.

4. Click Finish.

   You are prompted to restart Eclipse when the uninstallation is completed.

5. Click Yes.

Activate the Klocwork license

The trial version activates your trial license automatically when you use a Klocwork Solo for Java feature, such as running an analysis (allowing you to analyze up to 300 source files per project).

If you are buying Klocwork Solo for Java, you will need to activate your license. When you buy Klocwork Solo, your license allows you to run an analysis on up to 1,000 Java source files at a time.

Note: Licensing fails when using Remote Desktop.

There are two ways to install your Klocwork license:

• Online (automated)
• Offline (with files you receive via email)

To activate your license online:

1. In Eclipse, click Window > Preferences > Klocwork > License.
2. Enter the activation code received from Klocwork.
3. (optional) If you would like to use proxy settings, enter the details.
4. Click Activate.
5. Click OK on the Information view.
6. Click OK to close the Preferences view.

To activate your license offline (via email):

1. In Eclipse, click Window > Preferences > Klocwork > License.
2. Click Offline Activation.
3. Enter the activation code received from Klocwork.
4. Click Generate Request.

   An XML request file will be created. Send this file to Klocwork, and Klocwork will send you a license file via email.

5. Save the license file to your local hard drive.
6. Click Process Response.
7. Click Use license file, then browse to the location of your Klocwork license and click Open.

   The License window reappears.

8. Click Apply, and then OK to close the Preferences view.

Licensing fails when using Remote Desktop

Analysis or any other action requiring license checking will fail if you are accessing Klocwork Solo for Java using Remote Desktop.

Change the host machine for your Klocwork license

You may need to move your licensed Klocwork software to a different machine. Instead of buying a new license, Klocwork allows you to move the license to another machine. As with the initial license activation, you can do this online or offline, if necessary.

Note: You can change your host a maximum of two times per year.

To change your host machine online:

1. In Eclipse, click Window > Preferences > Klocwork > License.
2. Click Change Host.
3. Change your host details.
4. Click OK.
5. On your new machine, install the software as described in Installing Klocwork Solo and activate your license as described in Activate the Klocwork license.

To change your host machine offline:

1. In Eclipse, click Window > Preferences > Klocwork > License.
2. Click Offline Activation.
3. Click Change Host.
4. Change your host details.
5. Click OK.
6. On your new machine, install the software as described in Install Klocwork Solo and activate your license as described in Activate the Klocwork license.