To view the host and port settings for the Klocwork Servers, use the command kwservice get-service-properties (this does not use a Klocwork license).

If you have installed the Klocwork Servers in a central location and will be running one or more of the servers from another host machine, you will need to set the host name for these servers.

IMPORTANT NOTES:

• When issuing server configuration commands, the projects_root must be visible from the machine you're logged into.
• If you specify a different host for one or more Klocwork Servers using the procedure below, you will no longer be able to start the servers from the host where you previously started them.
• If the server hosts are located on a different subnet from the Klocwork clients, you must use the fully qualified host name for the Klocwork Servers in the procedure below. Otherwise, the clients will not be able to connect to the servers.
• You cannot change the physical host of the Klocwork License Server in the license file. If you need to move the License Server to another host, you must contact Klocwork for a new license file. However, you can use the procedure below if the name of the machine hosting the License Server has changed, or if you want to change how the host name is defined (for example, from a simple to a fully qualified host name). The host name in the license file must match the host name specified with the procedure below.
• If you have set up redundant License Servers, ensure that you specify the host name of the master License Server.
• See also Making network changes that affect the host name or IP address of a host machine.

To set the host name for one of the Klocwork Servers:

1. Stop the server, if is running. See Stopping the Klocwork Servers.
2. Run the following command:

   kwservice --projects-root <projects_root> set-service-property <server_name> host <host_name> 
   

   where

   • <projects_root> is the projects_root directory you want to use
   • <server_name> is one of:
     • database
     • license
     • klocwork
   • <host_name> is the name of the machine that will host the specified server (Klocwork recommends using the fully qualified host name; see "Important Notes" above).

   Example:

   kwservice --projects-root C:\Klocwork\projects_root set-service-property database host server0196.acme.com 
   

3. Start the server. See Starting the Klocwork Servers.

1. Stop the server, if it is running. See Stopping the Klocwork Servers.
2. Run the following command:

   kwservice --projects-root <projects_root> set-service-property <server_name> port <port_number> 
   

   where
   • <projects_root> is the projects_root directory you want to use (mandatory argument)
   • <server_name> is one of:
     • database
     • license
     • klocwork
   • <port_number> is the port to be used by the specified server.
3. Restart the server. See Starting the Klocwork Servers.

Example

To set the port used by the Klocwork Server to port 8074:

kwservice --projects-root C:\Klocwork_Server\projects_root set-service-property klocwork port 8074

If you need to change any aspect of a server's network setup that will affect its IP address and/or its fully qualified host name, follow the procedure below to ensure that Klocwork applications continue to function properly.

To make a network change that will affect the host name or IP address of a machine hosting Klocwork Servers:

1. Stop the Klocwork Servers. See Stopping the Klocwork Servers.
2. Make your network configuration change (or disconnect your computer from the network).
3. If the Klocwork License server is running on the machine, make a backup copy of the Klocwork license file, then edit the license file to change the host name or IP address to the new host name or IP address.
4. Start the Klocwork Servers again. See Starting the Klocwork Servers.
5. Communicate the changes to anyone else who needs to know (for example, IT team, Klocwork administrator, build engineer, or development teams).