Installing the Validate Server package on Linux

This page provides instructions for installing the Validate Server package using the installer.

Before you begin

Where do I get the software?

Download the packages from the Perforce Community Portal. Typically, only one or two users in an organization have access to the Validate technical support portal. If you don't have access, you can register for a new account.

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

Check the system requirements

Refer to the System requirements for a list of required packages and dependencies.

Installation notes

  • ulimit -n must be 2048 in order to run the Validate Server.
  • Ensure that the downloaded .sh file is executable. Use the chmod command to set the appropriate permissions:chmod 755 <p4-validate-installer.sh>
  • To control permissions when you are installing Validate, change the value of umask.
  • Install Validate software as a non-root user.
  • Ensure that the path in which you install the product is the same path from which users invoke the product. For example, the local path to the installation might be /local/tools/Validate, but users on other machines have to use the NFS path /opt/tools/Validate to invoke the product. Therefore, to ensure that users can invoke the product, use the /opt/tools/Validate path during installation.
  • Due to issues with file locking, user home directories should not be located on NFS.
  • The installer uses the environment variable 'TMPDIR'.
  • For some Linux installations, if you want to run the Validate Server, you may be required to install additional third-party libraries. For example: libaio1, libaio, or libaio.x86_64.
  • If you are installing on 64-bit Linux and the target machine has 6 GB or more of memory, the memory settings configuration will be increased to improve performance.
  • The Validate Server and Database Server need to be running on the same machine.

Do not locate the projects_root directory on NFS to avoid issues with file locking.

Running the installation package

Run the following command:

p4-validate-installer.24.1.x.x.<platform>.sh [options] <install_directory> [<component ...>]

where

  • <platform> is linux.
  • [<options>] are any of the options listed in Command-line options for the Server package.
  • <install_directory> specifies the directory in which you want to install Validate. Do not specify a subdirectory of the projects_root directory. Note that if the chosen directory is not empty, you will not be able to continue with the installation.
  • [<component ...>] is any of the arguments from Arguments for Server components. Separate multiple components with spaces. If you do not specify one or more components, the entire package will be installed. You can also see a list of arguments for the various components with the --list option.

After the installer completes successfully, the Validate tools is installed to the location specified and a projects_root is created in the install directory. The projects_root is configured using the specified license options, web and database ports; The projects_root is used to start the server.

Command-line options for the Server package

Name Short name Description
--agree -a Agree to license terms and do not display license agreement.
--add-service = true/false  

Control whether Klocwork Servers will be added to Windows Services after the installation. To use this option when installing from the cmd-installer, specify the appropriate flag:
validate-installer.exe install add-service = true/false
--database-port <port_number>   Specify the port number that you will use to run the Database Server. Default: 3306. This option is equivalent to specifying the port number with validate service.
--debug   Print debug information
--force -f Install without integrity checks
--help -h Display this help and exit
--license-file   Specify the license file to use when starting the license service.
--license-port <port_number>   Specify that the License Server will be run locally, but on a non-default port. Default: 27000. This option is equivalent to specifying the port number with validate service.
--license-server <host>[:<port>]   Specify a remote License Server host. The host argument is required; the port argument is optional. Default: localhost:27000. This option is equivalent to specifying the host and port with validate service.
--list -l List available features (components)
--projects-root <directory> -p Specify the complete path to a non-default projects_root directory. Default: <install_directory>/projects_root. The directory you specify must meet one of the following conditions:
  • it does not yet exist
  • it is empty
  • it is a valid projects_root directory created previously. Do not specify the same directory as the root Validate installation directory you have specified. Do not install Validate in a subdirectory of the projects_root directory.
--start-service = true/false   Control whether the windows services will be started after the installation completes (defaults to false).
--version -v display the version of Validate software and exit
--web-port <port_number>   Specify the port number that you will use to run the Validate Server. Default: 8080. This option is equivalent to specifying the port number with validate service.

Arguments for Server components

To install this Server component (feature)... ...enter the argument...
License Server LicenseServer
Validate Server ValidateServer

Add Validate to your PATH

On Linux, we recommend adding <Validate_install>/bin to your PATH. On Linux, we recommend adding <Validate_install>/bin to your PATH to make it easier to run Validate commands.

Copy the license file

Copy your license file to the following location:

<projects_root>/licenses