- Release Notes
- Introduction
- Governance
- Source Control
- CI/CD Pipelines
- Feeds Management
- Logging
Troubleshooting Jenkins Plugin
If you run into installation or upgrade issues, consider the following troubleshooting scenarios.
Platform: CloudBees
uipcli
version fails to be updated, leading to a legacy uipcli
remaining cached. This causes the tools
folder to not be found after extraction.
Remedy:
UiPath.CLI.Windows.nupkg
or UiPath.CLI.nupkg
. You can do this using a snippet similar to the one in the following example:
UiPathInstallPlatform(
cliNupkgPath: 'C:\\Users\\uipathadmin\\CLIVersions\\UiPath.CLI.Windows.23.10.8894.39673.nupkg',
cliVersion: 'X_23.10.8753.32995',
forceInstall: true,
traceLevel: 'Information'
)
UiPathInstallPlatform(
cliNupkgPath: 'C:\\Users\\uipathadmin\\CLIVersions\\UiPath.CLI.Windows.23.10.8894.39673.nupkg',
cliVersion: 'X_23.10.8753.32995',
forceInstall: true,
traceLevel: 'Information'
)
cliNupkgPath
refers to the location of the cached uipcli
on your agent machine.
cliVersion
is set to X_23.10.8753.32995
to force UiPathInstallPlatform
to extract from cliNupkgPath
, avoiding the extraction of a legacy version from an internal .jar
file.
uipath-automation-package
plugin version is at least 3.1 (recommendation is 3.2), and if you are extracting a windows uipcli
, the agent must be a windows machine.
Description: Unauthorized error.
Remedy:
-
If you use basic authentication: make sure that the username-password combination on the web login is correct.
If federated authentication is enabled, make sure you write the username in the task as “DOMAIN\user”
-
If you use token authentication:
- Revoke the token from the API access panel and generate a new one.
- Make sure that the user that generated the key can access the Orchestrator and has a user account on the Orchestrator instance.
- If you authenticate against an on-premise Orchestrator: make sure that the Orchestrator certificate is valid and that the machine running the job trusts the Orchestrator certificate in case you are using a self-signed certificate. You might receive this error because of the certificate used for the Orchestrator not being valid. This might mean that it has the wrong CN or other validation issues.
Remedy: the user doesn't have the permission to perform the action. Make sure that the user has permissions to read folders, upload packages, create and update processes, read test sets and test cases, read background tasks, and create and run test sets.
Remedy: Make sure that the authenticated user used by CI/CD plugins has the Folders.View and BackgroundTask.View (only for 20.4) permissions.
Remedy: Make sure that the package that you are trying to deploy does not exist with the same version already. If it exists, consider using automatic package versioning, so that the new version is bumped up every time we deploy.
C:\Windows or C:\Program Files
) to which the user does not have permissions, make sure that the workspace is placed on a path that can be accessed by the
user.
???
.
file.encoding
to UTF-8 in Java options:
Windows
When running Jenkins on Windows as a Service: in the service configuration file add the arguments inside the tag. Follow the sample script below.
<arguments>-Xrs -Xmx512m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -jar "%BASE%\)\)jenkins.war" --httpPort=8080 --webroot="%BASE%\)\)war"</arguments>
<arguments>-Xrs -Xmx512m -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -jar "%BASE%\)\)jenkins.war" --httpPort=8080 --webroot="%BASE%\)\)war"</arguments>
--env JAVA_OPTS="..."
, following the example script below.
docker run --name myjenkins -p 8080:8080 -p 50000:50000 --env JAVA_OPTS=-Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 jenkins/jenkins:lts
docker run --name myjenkins -p 8080:8080 -p 50000:50000 --env JAVA_OPTS=-Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 jenkins/jenkins:lts
CATALINA_OPTS
. Follow the example script below.
export CATALINA_OPTS="-DJENKINS_HOME=/path/to/jenkins_home/ -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -Xmx512m"
export CATALINA_OPTS="-DJENKINS_HOME=/path/to/jenkins_home/ -Dhudson.lifecycle=hudson.lifecycle.WindowsServiceLifecycle -Dfile.encoding=UTF-8 -Xmx512m"
Linux
JAVA_ARGS
, and add the file encoding. Follow the example script below:
JAVA_ARGS="-Dfile.encoding=UTF-8 -Xmx512m"
JAVA_ARGS="-Dfile.encoding=UTF-8 -Xmx512m"
When running on RedHat Linux-based distributions: in the configuration file search for the argument JENKINS_JAVA_OPTIONS and add the file encoding. Follow the sample script below.
JENKINS_JAVA_OPTIONS="-Dfile.encoding=UTF-8 -Xmx512m"
JENKINS_JAVA_OPTIONS="-Dfile.encoding=UTF-8 -Xmx512m"