Switch branches/tags
Azure-Add-Nuget-Settings-Update CONTRAST-7831 CONTRAST-8781 CONTRAST-12222-protect-docs CONTRAST-14638-trouble-java CONTRAST-17463-re/move-articles CONTRAST-17470-what-is-contrast CONTRAST-17566 CONTRAST-18659-profiler-docs CONTRAST-20358-config CONTRAST-20381 CONTRAST-20663-update-ruby-config CONTRAST-20961-freemium-docs CONTRAST-21091-Add-VS-Plugin-Doc CONTRAST-21316-remove-appname CONTRAST-21554-remove-assembly CONTRAST-23556-integrated-service CONTRAST-23556-speedracer CONTRAST-23895-flask-app CONTRAST-25182-Add-Dotnet-Chaining CONTRAST-25297-java-command CONTRAST-25851-service-clarification CONTRAST-25851-service-flag CONTRAST-26040-common-config CONTRAST-26040-dotnet-adjust CONTRAST-26040-node-common-config-changes CONTRAST-26736-cert-config CONTRAST-26737-node-docs CONTRAST-26999-java-common-config CONTRAST-27030 CONTRAST-27167-vulns-grid CONTRAST-27312-node-config-emph CONTRAST-27409-changes-to-support-contrast-env-var-prefix CONTRAST-27463-node-10-lts CONTRAST-27975-remove-dotnet-proxy-host CONTRAST-28172-java-docker CONTRAST-28194 CONTRAST-28440-vsts-backlogs CONTRAST-28941-build-based-view-options CONTRAST-29173-spring-aop Contrast-AlexB-patch-1 DanFiedler-AddSystemReqs DanFiedler-FormatSuppTech Node-Install-Config-Updates OD3-Test-LayoutUpdates OD3-Test-Merged OD3-Test-TerraGood-MikeGood-Synced OD3-Test-TerraGood OD3-Test Release-356-Profiler-Chaining-Flag-Fix Update_General_Properties ZD#9080-Supported-LDAP-Servers bamboo contrast-25989-exec-helper-troubleshooting contrast-26111-verify-java-exec-helper ddooley77-patch-1 dhafley-patch-1 distributed-config dotnet-directory-changes fix-appname ide-plugins installer_doc j0nS3idman-patch-1 j0nS3idman-patch-2 j0nS3idman-patch-3 j0nS3idman-patch-4 j0nS3idman-patch-5 javaagent-appname-change linux-pkgs master mobile-help-doc nahsra-cve-shields nahsra-protect-rules-update node-8 node-env opendocs-redesign-links org-stats-filename-bug orientation-tests philtest rebranding remove-profilerBehavior revert-525-CONTRAST-27047 reword-node-OS-support route-coverage-jersey rss search solarisSupport static-site-generator test-image-standards update-node-config wrong-min-version zookeeper_docs
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
93 lines (55 sloc) 5.19 KB

Corrupt Binary

gunzip: sfx_archive.tar.gz: not in gzip format

If you see this error, something went wrong during the transfer process of the installer. The easiest way to confirm this is to calculate the MD5 of the installer you're attempting to run, and compare it to the MD5 hash listed on our Hub site. Most likely this occurred if the file was transferred in ASCII mode instead of binary mode, particularly if SCP/SFTP was used.


To resolve the issue, transfer the file again, and explicitly specifying binary mode.

Failed Migration Due to Access Restrictions

Error on rename ... (Errcode: 13)

If you see this error, a migration failed during Contrast startup. The failure was most likely caused by the current user having insufficient privileges to modify files in the directory in which Contrast was installed.


To resolve the issue, uninstall Contrast and delete the remaining data files. You can then either elevate the user's permissions in the installation directory or choose a new directory where the user has full privileges. While it's uncommon, Administrator users can encounter this problem if there are extra file restrictions put in place by your organization.

Superadmin Configuration Unaccessible in 3.1.3

There is a known bug in Contrast EOP 3.1.3 that makes the Superadmin configuration interface inaccessible.


To resolve this issue, you must create an empty file in the filesystem at $CONTRAST_HOME/data/conf/

Multiple contrast-server JARs

There is a known issue in contrast 3.1.1 - 3.1.3 where the contrast-server binary isn't replaced during the upgrade process. This could cause classloading issues in the server which cause functionality to become unpredictable.


To resolve this issue, remove the older JARs from the $CONTRAST_HOME/lib directory that start with contrast-server-3.1. There should only be a single contrast-server version in that directory. After removing the files, restart Contrast.

Database Backup Gives Error

ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' (2)

In some fresh vanilla installations of Redhat or CentOS, the server could have an unresolvable hostname. During the installation process, Contrast detects the hostname for the server to set configuration parameters for how to connect to the database.

** Example:** A default CentOS 5.6 installation sets its hostname to centos.localdomain, but a corresponding entry isn't added to the /etc/hosts file.

If the hostname is unresolvable, the system defaults to localhost, which works for other areas of the system. However, the automated backup uses the mysqldump tool that associates the localhost hostname with a file socket connection instead of a network socket connection.


To resolve this error, set the database hostname to either a resolvable hostname or the IP address assigned to the server. This can be done using the encrypted properties editor tool that ships with the product.

$ bin/edit-properties -e data/esapi -f data/conf/ 

Once you're in the properties editor, type the name of the property that you would like to change. In this case, you want to update the value of the to the new hostname or IP address assigned to the server. Once you update this value, hit Q to quit out of the tool, select Y to save, then enter a comment for your change. You can verify the backup functions by running the $CONTRAST_HOME/bin/ script manually (as the contrast_service user, or whatever user you designated during installation).

sudo -u contrast_service /opt/Contrast/bin/
Reading Database Configuration
Ensuring Database Connectivity: Up
Backing up Schema: contrast to /opt/Contrast/data/backups/db/contrast.20150223.sql

Service Won't Start Due to Missing sudo/su

The sudo and/or su commands might not be available on some flavors of Linux. However, this is a simple issue to resolve.

For example, the runuser command is the default on the default installation of Amazon Linux within AWS, but it isn't an option during the installation. While Contrast makes an effort to support as many environments as possible with our Enterprise On-Premises (EOP) product, it's impossible to predict every potential scenario and test it internally.


You can resolve this issue by either installing sudo or su on your target server. If that's not an option, you can edit the $CONTRAST_HOME/bin/contrast-server.initd script directly and update it to reflect your environment.

Can't Find Your Problem?

If you have an issue that these answers don't solve, submit a ticket to the Support team with a description of the issue, the steps that caused it to occur, and any logs or screenshots that you have. The team will address your issue as soon as possible.