Chesar Frequently Asked Questions (FAQs) Part A - Technical questions. Chesar. Frequently Asked Questions (FAQs) Part A Technical questions

Transcription

1 Chesar Frequently Asked Questions (FAQs) Part A Technical questions Version 1.0 Page 1 of 14

2 Disclaimer The information contained in this manual does not constitute legal advice. The European Chemicals Agency does not accept any liability with regard to the contents of this document. The European Chemicals Agency is entitled to modify or revise the document at any time with or without notice and with or without cause. Version 1.0 Page 2 of 14

3 Document History Version Comment Date Version 1.0 First edition October 2011 Chesar Frequently Asked Questions (FAQs) Part A- Technical questions Reference: ECHA-10-B-21-EN Issue date: 12/10/2011 Language: English European Chemicals Agency, 2011 Reproduction is authorised provided the source is fully acknowledged in the form Source: European Chemicals Agency, and written notification is given to the ECHA Communication Unit If you have questions or comments in relation to this document, please send them (quoting the reference and issue date) using the information request form. The information request form can be accessed via the Contact ECHA page at: Version 1.0 Page 3 of 14

4 Table of Contents Document History... 3 Table of Contents... 4 General What is Chesar?... 5 Installation How to install Chesar? I cannot run the installer, when I click on it nothing happens After upgrading to IUCLID 5.3, why has my Chesar plug-in disappeared? Which PostreSQL version should be used with Chesar 1.x.x and IUCLID 5.x? Creating the new schema for Chesar in an Oracle database When starting Chesar, my IUCLID 5 crashes. Why? I need UNIX instructions for installing the Chesar plug-in I am receiving ORA error in the 5/5 step of the installer. What am I to do? The version shown in the title bar of Chesar is What am I to do?. 8 Technical Issues Can the CSR and the CHESAR plugin run simultaneously? When launching Chesar, I get an exception error when working on IUCLID 5 simultaneously, what must I do? Will Chesar work without problems on a computer with a 64-bit operating system? IUCLID 5/Chesar does not run on my Oracle database. I receive an error message "java.lang.nullpointerexception... AL32UTF8ToString" in the logs of the server Tomcat/base/log/iuclid5.log. What is wrong? I receive the error "ORA-01450: maximum key length (6398) exceeded". What could be wrong? Sometimes I get a Java.OutOfMemoryError or Java.lang.OutOfMemoryError:PermGen space error. What am I to do? I receive a Chesar error. What kind of logs/files do you need to investigate my case and where can I find them? Known Issues Chesar CSA export Application timeout Version 1.0 Page 4 of 14

5 General 1. What is Chesar? Please check the about page ( ) of the Chesar website. A general introduction of the application is also available in Chesar user manual 0: Introduction and scope of Chesar available on the Chesar website: Version 1.0 Page 5 of 14

6 Installation 1. How to install Chesar? Download the Chesar installer from the download section ( Read the installer manual included in the installer package carefully. 2. I cannot run the installer, when I click on it nothing happens If the installer does not work, it could be because the.jar file is associated with another application. In order to run the jar file: Save the Chesar installer to a folder, for example C:\Chesar_Installer Click on the Windows 'start' menu and select 'Run' Enter 'cmd' and click 'OK' In the terminal window which appears type: cd C:\Chesar_Installer [press ENTER] type:java -jar ChesarInstaller-standard.jar [press ENTER] Once the installation is complete, close the cmd window by typing "exit" and pressing enter. 3. After upgrading to IUCLID 5.3, why has my Chesar plug-in disappeared? Chesar is only compatible with IUCLID version When updating IUCLID from version 5.2.x to 5.3.0, all existing plug-ins are removed from the application. Chesar data is not lost, but version needs to be installed using the "Update" mode (section of the installer manual). 4. Which PostreSQL version should be used with Chesar 1.x.x and IUCLID 5.x? Chesar 1.2 is a plug-in of IUCLID 5.3.x and is using the same PostgreSQL versions that are recommended for IUCLID 5.3. IUCLID supports PostgreSQL 8.4.x and IUCLID supports both PostgreSQL 8.4.x and 9.x. Version 1.0 Page 6 of 14

7 5. Creating the new schema for Chesar in an Oracle database If you are using an Oracle database, before you run the Chesar installer, you need to create a new schema (tablespace and user), and you need to log in as the SYS user to do this. Start SQLPlus and connect to Oracle as a system administrator: SQL>connect SYS/syspassword@servername/databasename AS SYSDBA Create the user and the tablespace in the database: SQL>create tablespace chesar datafile "chesar.dbf" size 200M autoextend on next 50M maxsize 1000M; grant create session to chesar identified by "CHESAR"; grant create table to chesar; grant create view to chesar; grant create sequence to chesar; alter user chesar quota unlimited on chesar; alter user chesar default tablespace chesar; Disconnect from the database: SQL>disconnect Connect to the database using the Chesar username and password in order to verify that the database server accepts a connection made by the Chesar user: SQL>connect chesar/chesar_password@servername/databasename You may now run the Chesar installer. 6. When starting Chesar, my IUCLID 5 crashes. Why? The error occurs because, when running the installer, you are asked to provide the "IUCLID server URL*:". These values are copied to the \bundles\csa.properties file of the eu.echa.iuclid.plugin.csa.zip, which can be found at webapps\i5server5\i5clientplugins\remoteplugins. An error occurs when the address in the \bundles\csa.properties file is not identical to the url used in the browser. The file should look, for example, like this: #Shadow folder settings shadow_folder.connection_server_url_host= shadow_folder.connection_server_url_port=8080 Version 1.0 Page 7 of 14

8 For example, if you enter: "IUCLID server URL*: :8080", when you connect to the application through your Browser, you must use the same parameters, for example: 7. I need UNIX instructions for installing the Chesar plug-in Chesar can be installed on the server side on either Linux, Unix or Windows, as a plug-in for IUCLID 5. There is an automated installer that generates the two plug-in files and also connects and builds the database structure. In the installer, you specify the directories where the plug-ins will be copied. If you would like to start the Chesar installer by typing: java -jar ChesarInstaller-standard.jar under Solaris, you will need an x-server or a GUI (Graphical User Interface). 8. I am receiving ORA error in the 5/5 step of the installer. What am I to do? This error has been reported for Chesar 1.2. The user receives ORA error message in the 5/5 step ( column being added already exists in table ) of the installer. The error ORA ( name is already used by an existing object") may also occur. The Chesar plug-in can be opened, but cannot be used; for example if one tries to import a substance, an error message is displayed. The problem seems to be that the user attempts to run the installer in update mode more than once. The user should: Version 1.0 Page 8 of Restore the previous Chesar schema from their backups 2. Run the Chesar installer from the command prompt and send us the results. Note: If you do not have a backup of your previous Chesar schema, create a new Chesar 1.2 schema and import all previously exported Chesar files into the new Chesar 1.2 schema. 9. The version shown in the title bar of Chesar is What am I to do? The correct installation has the version Chesar 1.2 displayed in the title bar. One common cause of this wrong version number being displayed is if you choose the option to install a new Chesar 1.2 over a previous version of Chesar, instead of using the option to upgrade it. In this scenario, the installer cannot overwrite the database, displays an error message but allows you to continue. The result is that Chesar 1.2 shows in the title bar the version and the application cannot be used.

9 We recommend you to follow the Chapter 4 of the installation manual to uninstall Chesar 1.2 and erase the Chesar database. Then, you can re-install the Chesar 1.2 plug-in e.g using the command line java jar ChesarInstallerstandard.jar. If you have back-up files, you can import them into the new Chesar 1.2. Version 1.0 Page 9 of 14

10 Technical Issues 1. Can the CSR and the CHESAR plugin run simultaneously? If you have already installed CSR and Chesar you can try to prevent conflicts by using the plug-ins separately: If you use the CSR plugin first, you need to restart your IUCLID 5 application before using the CHESAR plugin, and vice versa. 2. When launching Chesar, I get an exception error when working on IUCLID 5 simultaneously, what must I do? When Chesar is loading, perfoming any action on the IUCLID 5 application will trigger the following error message: com.jgoodies.looks.plastic.plasticcomboboxbutton.paintcomponent (?) PlasticComboBoxButton.java#206javax.swing.JComponent.paint(?) null#-1javax.swing.jcomponent.paintchildren(?) null#- 1javax.swing.JComponent.paint(?) null#- 1javax.swing.JComponent.paintChildren(?) null#- 1javax.swing.JComponent.paint(?) null#- 1javax.swing.JComponent.paintChildren(?) null#- 1javax.swing.JComponent.paint(?) null#- 1javax.swing.JComponent.paintChildren(?) null#- 1javax.swing.JComponent.paint(?) null#- 1javax.swing.JLayeredPane.paint(?) null#- 1javax.swing.JComponent.paintChildren(?) null#- 1javax.swing.JComponent.paint(?) null#- 1javax.swing.JComponent.paintToOffscreen(?) null#- 1javax.swing.BufferStrategyPaintManager.paint(?) null#- 1javax.swing.RepaintManager.paint(?) null#- 1javax.swing.JComponent._paintImmediately(?) null#- 1javax.swing.JComponent.paintImmediately(?) null#- 1javax.swing.RepaintManager.paintDirtyRegions(?) null#- 1javax.swing.RepaintManager.paintDirtyRegions(?) null#- 1javax.swing.RepaintManager.seqPaintDirtyRegions(?) null#- 1javax.swing.SystemEventQueueUtilities$ComponentWorkRequest.run (?) null#-1java.awt.event.invocationevent.dispatch(?) null#- 1java.awt.EventQueue.dispatchEvent(?) null#- 1eu.eca.iuclid.client.Application$1.dispatchEvent(?) Application.java#196java.awt.EventDispatchThread.pumpOneEventFo rfilters(?) null#- 1java.awt.EventDispatchThread.pumpEventsForFilter(?) null#- 1java.awt.EventDispatchThread.pumpEventsForHierarchy(?) null#- 1java.awt.EventDispatchThread.pumpEvents(?) null#- 1java.awt.EventDispatchThread.pumpEvents(?) null#- 1java.awt.EventDispatchThread.run(?) null#-1 This error is related to the user interface display and does not affect the use of the application. Please click continue and use the application normally. If you experience refreshing issues inside the IUCLID Windows, then close and restart IUCLID 5. Version 1.0 Page 10 of 14

11 3. Will Chesar work without problems on a computer with a 64-bit operating system? In the distributed mode, the Chesar client will only run correctly on a Windows 32-bit system. The server can run on 32 or 64-bit. It is planned for Chesar 2 to be platform independent. 4. IUCLID 5/Chesar does not run on my Oracle database. I receive an error message "java.lang.nullpointerexception... AL32UTF8ToString" in the logs of the server Tomcat/base/log/iuclid5.log. What is wrong? You need to: Download the latest ojdbc driver from the Oracle website: html according to your database version, Copy it to the IUCLID folder i.e. WEB-INF/lib. Stop and start Tomcat Restart IUCLID 5/CHESAR 5. I receive the error "ORA-01450: maximum key length (6398) exceeded". What could be wrong? The default value of block size for an installation of Oracle is 8 KB. It is possible that a data field in IUCLID 5/Chesar contains more data than is allowed for a block size of 8 KB. If this occurs, when an attempt is made to write the data to the database, the following error is generated: ORA-01450: maximum key length (6398) exceeded. To greatly reduce the chances of this error occurring, set block size to 16 KB. See the FAQ on the IUCLID 5 website for more detail. 6. Sometimes I get a Java.OutOfMemoryError or Java.lang.OutOfMemoryError:PermGen space error. What am I to do? Chesar is using the same memory allocated to IUCLID 5. In Chesar you can receive 2 types of OutOfMemory errors: 1) java.lang.outofmemoryerror: Java heap space This error indicates that the Heap utilisation has exceeded the value set by - Xmx. It can be avoided by increasing the maximum heap size, e.g.: - Xmx=1024m 2) java.lang.outofmemoryerror: PermGen space Version 1.0 Page 11 of 14

12 This error indicates that the Permanent Generation segment of the heap has exceeded its maximum value. Permanent Generation holds meta-data that describes user classes (classes that are not part of Java language). It can be avoided by increasing the maximum permanent generation size, e.g.: - XX:MaxPermSize=128m If you have the stand-alone version of IUCLID 5.3, then please right-click the IUCLID 5 icon and choose Properties in the Shortcut tab. In the Target field, please make only the changes marked below in bold and leave the rest of the line unmodified: e.g. Target:"C:\Program Files\Java\jre6\bin\javaw.exe" -Xms512m - Xmx1024m -XX:MaxPermSize=128m -classpath conf;lib/* - Djava.library.path=lib/native eu.eca.iuclid.client.workstationlauncher 7. I receive a Chesar error. What kind of logs/files do you need to investigate my case and where can I find them? To investigate Chesar errors, we need the log files at the time of the problem, a detailed description and, if possible, an export file.c1z that reproduces the problem. This will help us to investigate the case, identify the problem and propose a solution. Therefore please send us: 1. The Chesar messages.log file from e.g. C:\Documents and Settings\Your_User_Name\.iuclid5\.jpf_shadow\*hostname*\CSAPlugin@5.2. 6\var\log\ 2. The IUCLID 5 log file from e.g. C:\Users\Your_User_Name\.iuclid5\iuclid5.log 3. If you have the distributed version of IUCLID 5, please also include the IUCLID 5 log file i5client.log from your client PC desktop and the relevant server side files. In Apache Tomcat, the logs are in the ApacheSoftwareFoundation\Tomcat and in ApacheSoftwareFoundation\Tomcat\logs directory on the server side. Please include a zip containing the files: i5server.log, catalina, stdout, stderr, localhost Version 1.0 Page 12 of 14

13 Known Issues Chesar CSA export CSA created and exported with Chesar cannot be imported in another instance of Chesar However, the data is properly saved in the database. This issue will be solved in the next version of Chesar. 2. Application timeout It is possible that after a long period of "non use" of Chesar (and more especially if the computer went into Hibernation mode) some actions (e.g saving to the database) stop working properly. If this occurs, close and restart IUCLID 5. Version 1.0 Page 13 of 14

14 European Chemicals Agency Annankatu 18, P.O. Box 400, FI Helsinki, Finland Tel: Fax: info@echa.europa.eu Version 1.0 Page 14 of 14