FAQ

Archives

Looking for older IUCLID versions?

Previous IUCLID 5 versions can be found on the IUCLID 5 archives page.

Previous IUCLID 6 versions can be found on the IUCLID 6 archives page.

Software requirements

Q3. Is PostgreSQL supported for use with IUCLID 6? 

A3. PostgreSQL is not supported for use with IUCLID 6. The only databases supported are JavaDB/Derby (free, as in no charge) and Oracle (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. Details of the operating systems tested and supported by ECHA are available on the system requirements page of the IUCLID website.   

Q6. Does IUCLID 6 run on macOS?  

A6. Yes. IUCLID 6 Desktop is available for macOS from the download page of the IUCLID website.   

Installation and system configuration

Q9. If we install IUCLID 6 to test our system, can we still use IUCLID 5.6 to prepare dossiers? Can we test IUCLID 6 while still working on and editing the content of a separate database under version 5.6?  

A9. Indeed, you should still use the version 5.6 of IUCLID to prepare dossiers for submission to ECHA for example, until the update of ECHA's submission tools. However you can install and migrate your data to IUCLID 6 already now. The migration from IUCLID 5 to IUCLID 6 copies data from one system to another so both systems can be used in parallel. Once the submission systems are updated to accept IUCLID 6 files, a final migration from IUCLID 5 to IUCLID 6 will have to be performed.   

Q22. What credentials should I use to log in to IUCLID for the first time?   

A22. This depends on whether users have been migrated from IUCLID 5 and whether the password of user SuperUser was changed via the Windows installation wizard. If neither of these were done, use the following credentials to log in to IUCLID 6 for the first time:
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 as SuperUser.
IUCLID 6 Desktop version now also offer the option to work without user management. In that case the login step is by-passed.

 If you have installed one of the IUCLID 5 Portable versions, please note that the credentials to login are admin / admin

Q23. Is it possible to have both IUCLID 5 and IUCLID 6 installed on the same application server, side-by-side?   

A23. Technically it is possible to install IUCLID 5.6 Distributed and IUCLID 6 Server side by side on the same server. To do it you must first ensure that Tomcat (IUCLID 5) and Glassfish (IUCLID 6) use different ports. Such configuration should be used for test purposes only, because we do not support this for production.
To install IUCLID 6 Server, follow the steps from the installation manual which can be downloaded here      

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. 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 to memory can be solved simply by increasing the maximum limit of allocation of RAM by increasing the value of the parameter Xmx for the relevant Java virtual machine (JVM). Where Xmx is set, Xms may also be set. The locations and default values are:

Application Default value Settings file
IUCLID 6 Desktop 2 GB (-Xmx2048m) <installation directory>\glassfish4\glassfish\domains\domain1\config\domain.xml
IUCLID 6 Server (Server) 4 GB (-Xmx4096m) <installation directory>\glassfish4\glassfish\domains\domain1\config\domain.xml
IUCLID 6 Server (Client) 1 GB (-Xmx1024m) <installation directory>\glassfish4\glassfish\domains\domain1\iuclid6\iuclid6-war-<version>.war\launch.jnlp
Updater tool (command line version) 1 GB (-Xmx1024m) <IULCID updater tool>\bin\updater.cmd

 

For example, to increase the memory allocation for IUCLID 6 Desktop from the default of 2 GB to 4 GB, edit the file domain.xml at the path shown above, changing the text -Xmx2048m to -Xmx4096m. Note that the section in the XML is server-config, not default-config.

Migration from IUCLID 5 to IUCLID 6

Q10. How is the migration process done from IUCLID 5.6 to 6?  

A10. Data can be migrated from any supported IUCLID 5.6 database to IUCLID 6 using the installer for IUCLID 6. In addition, IUCLID 5.6 files with extension i5z can be imported into IUCLID 6. For more information see the following page on this website https://iuclid6.echa.europa.eu/archive-iuclid-5..nnn..  

Q11. What needs to be done to prepare IUCLID 5 for migration?  

A11. To migrate a IUCLID 5 database to IUCLID 6, ensure that it is version 5.6. To download IUCLID 5.6, and to see more information on migration, see the following page on this website https://iuclid6.echa.europa.eu/archive-iuclid-5..nnn..     

Q14. Which way of migration do you recommend for more than 3,000 substances, via export / import or using IUCLID 6 installer?  

A14. The preferred method is to ensure that the version of IUCLID 5 is IUCLID 5.6, and then to migrate to a fresh installation of IUCLID 6 using its installer. For more information see the following page on this website https://iuclid6.echa.europa.eu/archive-iuclid-5..nnn..      

Q16. Is it possible to import into IUCLID 6, an i5z file that was made in IUCLID 5.6?  

A16. Yes, IUCLID 6 accepts the import of IUCLID 5.6 files. During import, the data is automatically migrated to the IUCLID 6 format. However, IUCLID 6 is not able to export data in the IUCLID 5 format.    

Q17. Does the IUCLID 6 installer support migration of PostgreSQL databases to Derby?

A17. Yes. The IUCLID 6 installer migrates data from PostgreSQL to Derby databases. It connects to both IUCLID 5 and IUCLID 6 databases at the same time, and executes the migration from any supported IUCLID 5.6 database to the latest version of any supported IUCLID 6 database.    

Q18. Is the migration process the same for both desktop and server versions?  

A18. The migration of data from a IUCLID 5 database to a IUCLID 6 database performed by the IUCLID 6 installer works independently of whether either database were used in a desktop or a server configuration. There is no separate tool for the desktop and server configurations.

It is not always essential to migrate data using the IUCLID 6 installer, because i5z files created in IUCLID 5.6 can be imported into IUCLID 6. The use of the IUCLID 6 installer is recommended for large amounts of data, for example, thousands of dossiers.    

Q19. Is it possible to switch the database from a standalone IUCLID 5.6 database to a server IUCLID 6 version?

A19. Yes. Use the IUCLID 6 installer to migrate the data from a IUCLID 5.6 database, to a fresh IUCLID 6 database. The IUCLID 6 database can then be used with either a desktop or server version of IUCLID 6.   

Q33. I have several IUCLID 5 Server databases and I would like to use the new Instance Based Security in IUCLID 6 to merge these databases in only one IUCLID 6 database. How shall I proceed?   

A33. The introduction of Instance Based Security (IBS) in IUCLID 6 allows data to be migrated and/or imported from different IUCLID 5 databases into one merged IUCLID 6 database in which access to the data is partitioned between Users and groups of Users.
Before attempting to merge IUCLID 5 databases, familiarise yourself thoroughly with the IBS functionality and consider what action to take (Cf. IUCLID 6 User Manual).
Some common scenarios are described here.     

Q34. I used the IUCLID 6 installer to migrate a IUCLID 5.6 database to a IUCLID 6 database and now I would like to check the result. How should I proceed?    

A34. When the IUCLID 6 installer is closed after a migration, it writes a report on the migration to the following file:

<iuclid 6 installation directory>/logs/installer-report.log

The file contains a report in structured text, that for further analysis, can be imported in to a spreadsheet application such as Excel.

Categories Display