FAQ

Software requirements

Q3. Is PostgreSQL supported for use with IUCLID 6? 

A3. PostgreSQL is not currently supported for use with IUCLID 6. However, this is under review because it could provide a way of delivering a higher performance. If you would like to test using PostgreSQL, please contact the IUCLID helpdesk for instructions.

The only databases supported are JavaDB / Derby, which is free, as in no charge, and Oracle, which is commercial. For more information about software requirements please refer to the documentation section of this website.

Q4. Is Tomcat supported for use with IUCLID 6? 

A4. Tomcat is not supported for use with IUCLID 6. This is one of the major technical changes between IUCLID 5 and IUCLID 6. The Tomcat application server is replaced by GlassFish (version 3.1.2 or 4).   

Q5. Which operating systems are supported by the server version: Linux, Windows, macOS?  

A5. IUCLID 6 can be run under Windows, macOS, or Linux. Details of the operating systems tested and supported by ECHA are available on the system requirements page of the IUCLID website.   

Installation, update, and system configuration

Q76. What is required to install IUCLID 6?

A76. Before installing IUCLID 6, check the following.

  1. If you have less than 5 GB of data you may not have to install IUCLID 6 at all, because you may be able to use an instance of IUCLID 6 hosted in the ECHA Cloud Services. Please check the associated Terms and Conditions to see whether your are eligible for the service. This solution is also particularly useful if you want to give a consultant remote access to your data.
  2. If you do not want to, or cannot use the IUCLID Cloud Services, you can install IUCLID 6 Desktop on a local computer running MS Windows, macOS, or Linux. This is a desktop application where all your data is stored locally, and is accessible by one user at a time. The resources required are such that for a few hundred datasets or dossiers, any fairly recent computer or laptop should work, but ensure that there is enough memory available when actually running IUCLID. If you need to provide remote access to multiple users of data, you will need to download and run IUCLID 6 Server. More precise requirements are given on this website under System Requirements. More information about the differences between the Cloud, Desktop, and Server versions of IUCLID are given at the top of the download page.
  3. The user installing IUCLID must have appropriate permissions to create the IUCLID 6 installation folder. For MS Windows it is recommended that IUCLID 6 is installed in a directory like C:\iuclid6, D:\iuclid or similar. To avoid problems with access rights, we do not recommend installation in the Windows folder Program Files.
  4. The installer for IUCLID 6 Desktop is documented in its user interface, and in the video here. Instructions for IUCLID 6 Server are provided in the document Installation and Update Instructions for IUCLID 6 Server.
Q77. What is required to upgrade IUCLID 6?

A77. Before upgrading IUCLID 6, check the following.

  1. Download the appropriate IUCLID Updater Tool for the system to be upgraded.
  2. Make a backup of your data. For IUCLID 6 Desktop this can be done by running the tool iuclid6-backup-restore.exe that comes with the application. It is located in the installation directory.
  3. Ensure that the user under which the updater is run has write permissions to the installation folder and all the files under it. In windows this can be checked for a file by right-clicking on the file, selecting Properties, and then viewing the settings under the tab Security.
  4. If the database is very large, consider the configuration of memory that is described in Q48.
  5. The IUCLID Updater Tool is documented in its user interface, and in the video here. The IUCLID Updater Tool works for both the Server and Desktop versions of IUCLID 6. Additional instructions that apply only for IUCLID 6 Server are provided in the document Installation and Update Instructions for IUCLID 6 Server.
  6. Before upgrading or restoring IUCLID 6 Server without running a gui, ensure that the values for the installation to be upgraded have been entered in to the configuration file indicated below:
    <IUCLID Updater Tool>\config\updaterConfig.properties
Q22. What credentials should I use to log in to IUCLID after installation?

A22. This depends on whether the password of the user SuperUser was changed via the Windows installation wizard, and whether users have been migrated from IUCLID 5. If neither of these were done, after an installation, use the following credentials to log in to IUCLID:
Username: SuperUser
Password: root

All credentials are case sensitive. For non-administrative use of IUCLID 6 it is recommended to use a user other than SuperUser. You can create new users whilst logged in to the classic user interface as SuperUser.

The IUCLID 6 Desktop version offers the option to work without user management. In that case the log in step is by-passed.

For IUCLID 5 Portable, the credentials to log in are admin / admin.

Q40. If I am unable to make an effective installation of IUCLID, what information should I send to the Helpdesk?

A40. Please communicate the following information to the Helpdesk:

  • Screenshot of every step of the installation procedure
  • Log files: see FAQ entry Q39     
Q46. I would like to know which version of IUCLID 6 Desktop is installed on my computer: the 32 or the 64-bit version.   

A46. In case you do not remember which version of IUCLID is installed, you can download a small executable file to find out. Here is how to check your IUCLID 6 version:

  • Execute the file by double-clicking it
  • For a 32-bit version you should obtain the following result

  • For a 64-bit version you should obtain the following result

Please note that there is only one updater provided for IUCLID 6 that will update your existing IUCLID 6 Desktop installation to the latest one, whether it is a 32-bit or a 64-bit installation.

Q48. How should the computer memory (RAM) usage of IUCLID 6 and its associated software tools be configured?

A48. The following problems can be caused by insufficient system memory (RAM) being available to IUCLID 6 or its associated software tools:

  1. IUCLID 6 or a tool does not start;
  2. Unusually slow performance, especially when large files are handled;
  3. The error “Out of Memory exception” is output either to log files or the command line.

To avoid these problems, and to use resources most efficiently, consider the total RAM available to the computer, and how it is allocated to IUCLID 6 and each of its software tools. The recommended system resources for IUCLID 6 are stated here. Many problems like those given above can be solved simply by changing the values of certain system parameters in settings files and/or scripts. A detailed guide to memory management for IUCLID 6 and its tools, aimed at non-IT specialists, is provided in the document Java and Memory in IUCLID 6. What follows below is aimed at users with sufficient IT skills that they need to know only where to find the parameters.

IUCLID 6 and its tools are Java applications. Many problems relating t