Troubleshooting
Installation issues
Missing requirement during installation process
Problem:
You’ve got a message like:
Missing requirement: Safe X3 Studio DLTK Core x.x.x.x (com.sage.x3.xdt.dltk.core x.x.x.x)
requires ‘bundle org.eclipse.core.runtime [3.8.0,4.0.0)’ but it could not be found
Resolution:
You are running a version of Eclipse that is no longer supported.
Visit the Home page to know what are the recommended and the minimum supported versions of Eclipse.
Download a ready to use package.
I cannot update my current installation
Problem:
The update failed with timeout or other reason.
Resolution:
Try the following point:
- Double check the update site url.
- Unselect the “Contact all update sites during install to find required software” checkbox in the Install dialog box and try again.
- Verify your proxy configuration.
- Check that the update site is reacheable from a web browser, if not this could be a temporary network failure.
The installation dialog does not display the latest version
Problem:
When I go to the menu Help > Install New Software… and I select or add the update site url, the dialog does not display the latest version.
Resolution:
Reloading the site should solve the problem:
- From the “Install New Software…” dialog box, click on the “Available Software Sites” link
- Select the update site in the list
- Click on the “Reload” button.
The update has broken my installation
Download a ready to use package.
After updating I have errors such as “Failed to create the part’s control” or “Plug-in … unable to load class …”
Problem:
The Eclipse ui and/or Error log view displays errors like above.
Resolution:
This is probably due to an obsolete version of Java. Please, note that Java 1.6 is no longer supported.
Install the latest Java update to solve the problem.
Launching issues
Since updating to Java 8, my Eclipse instance displays a Java message and exits.
Problem:
When launching Eclipse, a dialog box is displayed with a message mentioning an error regarding the JVM like: Java was started but returned an exit code=13
Resolution:
This is a known issue of Java 8 on windows. Java 8 now creates a link and puts that link into the system PATH environment variable.
The path is: C:\ProgramData\Oracle\Java\javapath.
The problem is that if you have an Eclipse 64 bits installed and you update Java with a 32 bits JVM because of a 32 bits browser, then you change the target of this link and then the system tries to run a 64 bits Eclipse installation with a 32 bits JVM.
The solution is to update your system by installing a 64 bits Java 8 JVM.
Visit the Java download page to download and install it.
Eclipse starts and exits just after selecting my workspace
Problem:
Following a system or Eclipse crash, Eclipse exits without any error message during the workspace loading.
Resolution:
The persistent file containing the workbench information can be corrupted. This file is in your workspace folder in the following relative path:
.metadata/.plugins/org.eclipse.e4.workbench/workbench.xmi
You should solve the problem by deleting this file.
Usage issues
Each time I open Eclipse, I am prompted to enter the password for each project.
Problem:
The Safe X3 Studio plug-in stores passwords in the Eclipse secure storage. If it has not been well configured it is not possible to store passwords.
Resolution:
Change the master password using the Change Password… button on the Secure Storage preference page as mention in the Resolving problems section.
If it does not work, try the other solutions mentioned in this section.