Knowledge Base

Installation or Upgrade Fails Due to Locked Out Jar Files

KB1165 - Feb 12, 2015

Type: Problem

Description: Why the installation or upgrade of the Sentry KMs may fail. Solutions to adopt.

Additional Keywords: Java, Jar

Related Topics


The installation or upgrade of the Sentry Software KMs may fail because some jar files are in use and locked out. In such a case, error messages can be observed in the log files located in the following folders:

  • On Windows systems: %USERPROFILE%\BMCINSTALL
  • On Linux/UNIX systems: $HOME/BMCINSTALL

Here are some examples of encountered error messages:

Unable to unlink/delete file  [C:\BMCSoftware\Patrol3\bin\SEN_HP3P_v1.jar].  Error is [Permission  denied].
Unable to install file '.\bin\SEN_HP3P_v1.jar' for product [senhp3pnakm].
Unable to unlink/delete file [D:\Program Files (x86)\BMC Software\Patrol3\bin\SEN_JavaCheck.jar].  Error is [Permission denied].
Unable to install file '.\bin\SEN_JavaCheck.jar' for product [sensvcnakm].


To make sure no jar files are in use or locked out:

  1. Run the following command to stop all PATROL Agent instances:
    • pconfig +KILL -host <hostname> -p <port>
  2. Because the collection hub used by Sentry KMs may take some time to terminate, verify that all instances are actually shut down before installing the KMs:
    • On Windows systems: launch the Task Manager. If needed, manually kill the required processes:
    • On Linux/UNIX systems: run the following command line ps -ef|grep -i matsya:
      [patrol@babbage ~]$ ps -ef|grep -i matsya
      patrol 996 20363 0 12:55 ? 00:00:03 /opt/bmc/Patrol3/Linux-2-6-x86-64-nptl/../SEN_jre64/bin/java -Xms128m -Xmx512m -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:SurvivorRatio=2 -XX:NewRatio=8 -jar /opt/bmc/Patrol3/Linux-2-6-x86-64-nptl/../bin/SEN_matsya.jar
      patrol 15840 32228 5 13:21 ? 00:00:44 /opt/bmc/Patrol3/Linux-2-6-x86-64-nptl/../SEN_jre64/bin/java -Xms128m -Xmx512m -XX:+UseParNewGC -XX:+UseConcMarkSweepGC -XX:SurvivorRatio=2 -XX:NewRatio=8 -jar /opt/bmc/Patrol3/Linux-2-6-x86-64-nptl/../bin/SEN_matsya.jar
      patrol 22457 16596 0 13:34 pts/2 00:00:00 grep -i matsya
  3. Because the SEN_JavaCheck.jar file may also be corrupted:
    1. Download and unzip the file
    2. Copy and paste the SEN_JavaCheck.jar file to the $PATROL_HOME/bin directory on the server where the PATROL Agent runs
    3. Restart the PATROL Agent.