Overview
This article explains how to configure a custom temporary folder for JetPatch Connector installation on Linux and Windows endpoints.
This configuration only affects initial connector installation, as connector upgrades do not use the /tmp directory.
Note: This configuration is only relevant for initial connector installation. Connector upgrades do not use /var/jetpatch-temp or the configured temp path. During an upgrade, JetPatch uses /tmp directly via a short-lived system temp file (mktemp) regardless of any custom temp path configuration. The configured path only affects fresh connector deployments on machines where the connector is not yet installed. |
Upgrade Behavior
The temp path configuration described in this article does not apply to connector upgrades. The behavior differs between initial installation and upgrade as follows:
| Operation | Temp path used |
|---|---|
| Initial connector installation | Configurable — /var/jetpatch-temp (default) or custom path set in config file |
| Connector upgrade | Always uses /tmp via system mktemp — not configurable |
This means:
- If
/var/jetpatch-temphas restrictive permissions on an endpoint, initial installation will fail but upgrades will succeed as long as/tmpis writable. - Changing the temp path configuration does not affect upgrade behavior.
- The temp path configuration persists across JetPatch console upgrades — it does not need to be re-applied after upgrading the JetPatch server.
Configuration File Location
For Versions Before 5.0
Edit the following file on the JetPatch server:
| /usr/share/tomcat/default/conf/intigua.config.xml |
For Version 5.0 and Later
| usr/share/intigua/services/data/app-config/intigua-worker/application.properties |
Configuration Steps
For Linux Endpoints
Add the following lines to the top of the configuration file (after <root>), replacing "REAL PATH TO TEMP DIR" with the desired tmp path (e.g., /var/tmp):
<system> <linux> <temp-dir> REAL PATH TO TEMP DIR </temp-dir> </linux> </system> |
For Windows Endpoints
Add the following lines to the top of the configuration file (after <root>), replacing "REAL PATH TO TEMP DIR" with the desired tmp path (e.g., C:\Windows\temp):
<system> <win> <temp-dir> REAL PATH TO TEMP DIR </temp-dir> </win> </system> |
| Important: The directory path must already exist on the target machine. |
Applying the Changes
After saving the changes to the configuration file, restart the appropriate service:
| systemctl restart tomcat |
| docker restart intigua-worker |
Required Permissions
The configured temp directory must exist on the target endpoint before JetPatch attempts to use it, and the JetPatch user (the account assigned to that endpoint) must have read, write, and execute permissions on it.
To set the correct permissions on the default path:
chmod 777 /var/jetpatch-temp
Or to scope it to the JetPatch user's group:
chown root:<jetpatch-user-group> /var/jetpatch-temp chmod 775 /var/jetpatch-temp
Note: Permissions on /var/jetpatch-temp are not set by JetPatch automatically. They must be configured by a root/sudo user on each target machine. If the directory has incorrect permissions, initial connector installation will fail with a Permission denied error even when the JetPatch user has full sudo privileges — this is because the permission check happens at the file copy stage, before any sudo escalation.
To verify the JetPatch user can write to the directory:
sudo -u <jetpatch-user> bash -c 'echo test > /var/jetpatch-temp/test.sh && rm /var/jetpatch-temp/test.sh && echo OK'
Comments
0 comments
Please sign in to leave a comment.