Installing the Validate package on Windows
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.
How do I get a license?
Contact Perforce support to obtain a license file. Your IT department may have a remote license server set up, or you need to specify a license file in your projects_root/licenses folder. See Getting a license if you don't already have one, and Transition license from FlexLM to Reprise for a walkthrough of the Reprise web interface.
Important information about Reprise License Manager (RLM)
rlm.pw
file has been discontinued as of RLM version 16.1.0 and is not available in Klocwork 2025.1 or later.-
For release 2025.1 and higher:
-
Release 2025.1 or higher ships with RLM version 16.1.0BL1 and the web interface will run as a root or admin user.
-
From release 2025.1, the RLM web interface uses HTTPS by default. Once the license server starts, to log in to the RLM web interface on port 5054, go to
https://<hostname>:5054
and type the default usernameadmin
and passwordadmin
. You will be prompted to change the password at first login. It is recommended that you change the default password at first login.
-
-
For releases 2023.4 to 2024.4:
-
Release 2023.4 or higher ships with RLM version 15.1BL2 and the web interface will run as a root or an admin user.
-
For releases 2023.4 to 2024.4, the default username
admin
and passwordpassword
is used to access the RLM web interface on port 5054. Before starting the license server for the first time, change the default username by editing the<Validate install>/3rdparty/bin/rlm.pw
file. Once the license server starts, to log in to the RLM web interface on port 5054, go tohttps://<hostname>:5054
and type your new username and passwordpassword
. It is recommended that you change the default password at first login.Failure to change the preset username will cause the license server to stop within 10 minutes. It is recommended that you change the default password at first login.
-
-
For releases 2023.2 and 2023.3: In several versions of RLM (including 15.0), the web server is disabled if the user running RLM is a root or an admin user. You can manage named user licenses by running the license server service as a local user, then accessing the licensing web portal locally on port 5054. See Cannot use RLM web interface for details.
Important information about ports: The valid range for ports is 0-65534. Ports cannot be duplicated and the web services port uses the specified port and its +1 (for example, 8080 and 8081). Ports are checked to see if they are available; if they are in use, a warning is given. You can choose to continue and reconfigure later if necessary. Remote service ports (such as license services) are checked to see if they are valid. If there is a connection problem, you can continue but starting the services is not possible until they are valid.
Option 1: Installation using the Windows installer
Run the Validate Server installer, following the prompts. Note the following:
-
Validate versions 2023.4 and later have no dependencies on Microsoft Visual C++ Redistributable 2013 or older. The Validate server for Windows has a dependency on the 64-bit Visual C++ redistributable package. The vc_redist.x64.exe package is available from Microsoft at https://support.microsoft.com/en-gb/help/2977003/the-latest-supported-visual-c-downloads.
- 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 installs the appropriate JVM.
- If your system locale is Japanese, the installation package runs in Japanese. Otherwise, it runs in English.
- You'll be asked where you want to create the projects_root directory, which is the data location for the Validate Servers and applications. It contains Validate Server settings, information about integration projects, and build analysis runs. It also stores the Validate license file. The default location is
C:\ProgramData\Perforce\Validate
.Do not Install the Validate 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. - You can specify server port information during installation in the Configure Validate servers dialog to override the default settings.
-
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, enables you to specify the location of your license file; it is then automatically copied into the projects_root/licenses folder. You can copy this file into the folder at a later time manually, but in that case the server cannot be started automatically after you complete installation. If you select Remote, you must specify the host name and port number for your License Server. The Windows license service is disabled in this case but you can enable it later if needed.
- You also have the option of starting the Validate Servers as Windows services automatically following installation. If you do not select this option, you need to start the servers manually following installation.
Option 2: Installation using the command line
If you are the System Administrator and prefer to install Validate silently on the command line, you can run the installer in CLI mode, as follows:
p4-validate-installer.22.1.0.9999.win64.exe install [option=value]
where:
- [option=value] are the settings and their values that you can configure on the command line.
Below are the available options you can specify during the installation.
p4-validate-installer.<version>.<platform>.exe --help
Option | Description |
---|---|
projects_root <directory> | Specify the complete path to a non-default projects_root directory. Default: %ProgramData%\Perforce\Validate\projects_root. The directory you specify must meet one of the following conditions:
|
license-server <host>[:<port>] |
Specify a remote License Server host. The host argument is required; the port argument is optional. Default: localhost:27000.
|
license-port <port_number> | Specify that the License Server will be run locally, but on a non-default port. Default: 27000. |
database-port <port_number> | Specify the port number that you will use to run the Database Server. Default: 3306. |
web-port <port_number> | Specify the port number that you will use to run the Web Server. Default: 8080. |
start-service | Optional: Specify whether to start the service as a windows service (Default: no). |
--accept-licenses (--al) | Accepts all licenses without user input. |
--confirm-command (-c) | Confirms starting of installation, update, or removal of components without user input. |
--root (-t) | Specify the location of the server files installation. |
Example
p4-validate-installer.24.1.0.9999.win64.exe install projects_root=c:\mydata\projects_root license-server=reprise license-port=27000 web-port=8221 database-port=3221 -c --al -t C:\space\Validate_24_1
The installer must be run from a command line that has administrator privileges, otherwise it fails.
Note on the Path environment variable
On Windows, the Validate bin directory is automatically added to your Path environment variable as follows:
Installation package | Environment variable modified | Value used |
---|---|---|
Validate | System Path | <validate_install>\bin |
Desktop Analysis Tools | System Path | <desktop_analysis_tool_install>\bin |
Log files for Windows installation
An installation log file is saved to your installation directory whenever one of the Validate installation packages is started on Windows.
A logs directory is created in the root Validate installation directory during installation. For example, the log files in this directory store validate service output when the servers are first started and the projects_root directory is initialized.