In a Windows Environment

Perform the following procedure to run Code Insight as a Windows service.

To run Code Insight as a Windows service, do the following:

Using the command prompt, navigate to this location:
```
<CODE_INSIGHT_ROOT_DIR>\tomcat\bin
```
Stop the Tomcat server. See Enabling Secure HTTP Over SSL.
Open the service.bat file with a text editor.
Set the JRE_HOME and CATALINA_HOME environment variables by adding these lines to the beginning of the file. (You can copy these the variable values from the catalina.bat file.)
- set CATALINA_HOME= <CODE_INSIGHT_ROOT>\tomcat
- set JRE_HOME= <CODE_INSIGHT_ROOT>\jre
- Replace <CODE_INSIGHT_ROOT> with the directory path where Code Insight is installed.
Locate the following variable definition, which sets the minimum size of the Tomcat JVM heap:
```
 "%JvmMs%" == "" set JvmMs=128
```
- Replace 128 with 12288:
```
 "%JvmMs%" == "" set JvmMs=12288 
```
Locate the JvmMx variable definition (just after the JvmMs definition). This definition sets the maximum size of Tomcat JVM heap.
```
if "%JvmMx%" == "" set JvmMx=256 
```
- Replace 256 with 26079 (which is the minimum amount of RAM required for Code Insight on a 32 GB instance).
```
if "%JvmMx%" == "" set JvmMx=26079 
```
note
The maximum heap size should be no greater than 80 percent of your available memory.
Under the %EXECUTABLE%" //IS//%SERVICE_NAME% ^ section, update the following parameters with the highlighted values:
- --Description "``CodeInsight``" ^
- --DisplayName "``CodeInsight``" ^
Locate the --JvmOptions parameter under the %EXECUTABLE%" //IS//%SERVICE_NAME% ^ section, and edit it as follows:
Locate the %JvmArgs% option ** ** in the --JvmOptions parameter:
- --JvmOptions "-Dcatalina.home=%CATALINA_HOME%;-Dcatalina.base=%CATALINA_BASE%;-D%ENDORSED_PROP%=%CATALINA_HOME%\endorsed;-Djava.io.tmpdir=%CATALINA_BASE%\temp;-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager;-Djava.util.logging.config.file=%CATALINA_BASE%\conf\logging.properties;%JvmArgs%" ^
- Replace %JvmArgs% with the following two options:
  - -Dcodeinsight.ssl=<true/false>—If Code Insight is configured for SSL, configure this option as true. Otherwise, leave the value as false (the default). This value must match the value configured for
    -Dcodeinsight.ssl in the <CODEINSIGHT_ROOT_DIR>\tomcat\bin\catalina.bat file, used to configure Code Insight for HTTPS. See Enabling Secure HTTP Over SSL for details.
  - -DcodeinsightInstallPath=<CODE_INSIGHT_ROOT>—Replace <CODE_INSIGHT_ROOT> with the directory path where Code Insight is installed.
note
Be sure to separate the options from each other with a semi-colon (;).
- The following is an example:
- --JvmOptions "-Dcatalina.home=%CATALINA_HOME%;-Dcatalina.base=%CATALINA_BASE%;-D%ENDORSED_PROP%=%CATALINA_HOME%\endorsed;-Djava.io.tmpdir=%CATALINA_BASE%\temp;-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager;-Djava.util.logging.config.file=%CATALINA_BASE%\conf\logging.properties;-Dcodeinsight.ssl=false; -DcodeinsightInstallPath=D:\codeinsight-0.00.0-00" ^

If Code Insight uses a proxy server, add the following options to the -JvmOptions parameter. These options are used to run the proxy server as a service.

note

Be sure to separate the options from each other with a semi-colon (;).

Proxy option	In the option, replace...
-Dhttps.proxyHost=<HOST>	`<HOST>` with the IP address or hostname for the proxy server.
-Dhttps.proxyPort=<PORT>	`<PORT>` with the port used by the proxy server.
-Dhttps.proxyUser=<UNAME>	`<UNAME>` with user ID used to log into the proxy server.
-Dhttps.proxyPassword=<PWD>	`<PWD>` with the password used to log into the proxy server: If you have configured Tomcat Vault to encrypt the proxy password, enter the password alias defined in the vault configuration. If you have not configured Tomcat Vault to encrypt the password, enter the plain-text password. For information about configuring Tomcat Vault to encrypt the password, refer to Configuring a Proxy Connection Using an Encrypted Password.
-Djdk.http.auth.tunneling. disabledSchemes	Nothing. Specify as is.

Save the service.bat file and exit the text editor.
At a command prompt, enter the following command to add a system environment variable with the name CODEINSIGHT_ROOT. In the command, replace C:\ <CODE_INSIGHT_ROOT> with the path of your Code Insight installation directory.
```
setx CODEINSIGHT_ROOT "C:\<CODE_INSIGHT_ROOT>" 
```
Execute the service.bat install command to install the Apache Tomcat Windows service.
When the service is installed, open Windows Services and search for the Display name you specified in step 7 (in this case, CodeInsight).
Right-click the CodeInsight service and select Start.