Start here

Home
About Klocwork
What's new
Fixed issues
Release notes
Installation

Reference

C/C++ checkers
Java checkers
C# checkers
MISRA C 2004 checkers
MISRA C++ 2008 checkers
MISRA C 2012 checkers
MISRA C 2012 checkers with Amendment 1
Commands
Metrics
Troubleshooting
Reference

Product components

C/C++ Integration build analysis
Java Integration build analysis
Desktop analysis
Refactoring
Klocwork Static Code Analysis
Klocwork Code Review
Structure101
Tuning
Custom checkers

Coding environments

Visual Studio
Eclipse for C/C++
Eclipse for Java
IntelliJ IDEA
Other

Administration

Project configuration
Build configuration
Administration
Analysis performance
Server performance
Security/permissions
Licensing
Klocwork Static Code Analysis Web API
Klocwork Code Review Web API

Community

View help online
Visit RogueWave.com
Klocwork Support
Rogue Wave Videos

Legal

Legal information

Installing the Klocwork Server package on Windows

Installing the Klocwork Server package on Windows

This page provides instructions for installing the Klocwork Server package using the installation wizard. For instructions on unattended installation of both the Klocwork Server and desktop analysis plugins, see Unattended installation on Windows.

Your users can install the desktop analysis plug-ins from the product portal ("pull" installation) or, if your organization is set up for it, you can install the clients for your users in an unattended ("push") installation through a Software Management System (SMS) or similar system.

Before you begin

Upgrading? See Upgrading from a previous version.

Where do I get the software?

Download the packages from Klocwork Support. Typically, only one or two users in an organization have access to Klocwork Developer Network. If you don't have access, you can register for a new account.

You need a license. See Getting a license if you don't already have one.

Running two versions of the Klocwork Servers

If you will be running two sets of the Klocwork Servers, for example to test the Klocwork 2018.1 Servers while users continue to access your existing servers, you must run them on different projects_root directories (and set the ports appropriately).

Required permissions

  • Administrator access is required to install all Windows packages, whether using the installation wizard or unattended installation.
  • You must have administrator access to install the Klocwork Server.
  • You must have administrator permissions to start the Klocwork Servers (and to run the Klocwork Servers as Windows Services).
  • For Windows Server 2008, you must use the 'Run As Administrator' option in order to launch any Klocwork tools which access a projects_root that is located on a root directory.

Installation using the Windows installation wizard

Run the Klocwork Server installation wizard, following the prompts. Note the following:

  • During installation, one or more Visual C++ Runtime redistributable packages may be installed on your computer. Depending on your operating system, a reboot may be required at the end of the installation.
  • The installation package automatically detects whether you have a 32-bit or 64-bit operating system and installs the appropriate JVM.
  • If your system locale is Japanese, the installation package runs in Japanese. Otherwise, it runs in English.
  • You can specify server information during installation in the Klocwork Servers configuration screen to override the default settings. The defaults for the License Server are localhost and 27000. The default port for the Klocwork Server is 8080. See Viewing and changing Klocwork server settings for more information on ports.
  • For information on the Use secure server connection (HTTPS) checkbox, see Using a secure Klocwork Server connection.
  • You'll be asked where you want to create the projects_root directory, which is the data location for the Klocwork Servers and applications. It contains Klocwork Server settings and information about integration projects and build analysis runs. It also stores the Klocwork license file. The default location is <server_install>\projects_root.
    CAUTION:
    Do not install the Server package and the projects_root directory in the Program Files directory. Default security settings for Windows and Windows Server restrict writing to files in the Program Files directory.
  • During installation, you specify whether you want to use the locally installed License Server (Local) or connect to a remote License Server (Remote). Local, the default option, requires you to browse to your license file. If you select Remote, you must specify the host name and port number for your License Server.
  • If you specify a new location for the projects_root directory during installation, you have the option of starting the Klocwork Servers as Windows services automatically following installation. This option is available on the Set up Klocwork Servers dialog of the Server package installer. If you do not select this option, you need to start the servers manually following installation.
  • The Klocwork Server and Database Server need to be running on the same machine.

Installing the License Server on a separate host

If you want to install the License Server on a separate host from the Klocwork servers, you need to install it from the command line using the following command:
kw-server-installer.18.1.x.x.windows.exe /w /S /v"/qn /norestart INSTALLDIR=<local_directory> ADDLOCAL=LicenseServer,JRE"
where:
  • <local_directory> specifies the directory in which you want to install the License Server.

Note on the Path environment variable

On Windows, the Klocwork bin directory is automatically added to your Path environment variable as follows:

Installation package Environment variable modified Value used
Server System Path <server_install>\bin
Desktop Analysis Tools System Path <desktop_analysis_tool_install>\bin

Log files for Windows installation

An installation log file is saved to the Temp directory of Local Settings whenever one of the Klocwork installation packages is started on Windows. For example, on Windows 7, the installation log file is saved to %LOCALAPPDATA%\Temp.

These log files are named Klocwork<release>-<package>.log . For example, the installation log file for the Klocwork 2018.1 Server package is named Klocwork2018.1-Server.log.

A logs directory is also created in the root Klocwork installation directory during installation. For the Server installer, for example, the log files in this directory store kwservice output when the servers are first started and the projects_root directory is initialized.

Start the servers

To start the servers, use Windows Services Administration or kwservice start:

kwservice --projects-root <projects_root> start 
where <projects_root> is the projects_root directory you specified during installation

Example

kwservice --projects-root C:\klocwork\projects_root start 

Log in to Klocwork Static Code Analysis

After starting the Klocwork servers, Klocwork Static Code Analysis is accessible from a browser using the URL of the Klocwork server hostname and the Klocwork server port chosen during the install (for example, server21:8080). By default, the person who installed Klocwork is set as the Klocwork administrator, and is given the Projects root admin role. Initially, the Basic Authentication access control method is used, so no password is needed to log in. For example, if the user account used during the installation was ‘jsmith’, to log in to Static Code Analysis with the administrator role, use the credentials:
username: jsmith
password: <empty>
For more details on security and authentication methods, see Security and permissions.