Note
This documentation is for the new OMERO 5.1. version. See the latest OMERO 5.0.x version or the previous versions page to find documentation for the OMERO version you are using if you have not upgraded yet.
We do not recommend changing the time zone on your server. The server is currently set to use local time and changing time zones will result in a mismatch between the original data import times stored in the server and the way the clients report them. A fix for this is forthcoming but will not be in 5.1.
OpenJDK8 is not currently supported, however OracleJDK8 is supported. OpenJDK and OracleJDK versions 6 and 7 are also supported.
Windows does not handle non-Latin characters well in the command prompt (console). If you use Unicode characters in your passwords, you may find they are not correctly formed. Therefore, we recommend you avoid them if at all possible.
The development server included with OMERO.web does not work under Windows XP. This server is included to allow you to easily evaluate and develop the OMERO.web component. As it should not be used in a production environment, while an inconvenience, this should not stop the deployment of a production version of OMERO.web. See OME forum topic.
On Windows servers not all binary files corresponding to a delete may be removed from the binary repository. See Binary data for more details.
Under older Ubuntu installations, the ‘import folder’ option in the desktop clients currently does not work.
OMERO.cpp will not currently build on Windows due to exceeding DLL symbol limits on this platform, leading to a failure when linking the DLL. It is hoped that this platform limitation can be worked around in a future OMERO release.
Starting with OMERO 5, the server works directly from original files. At times, this requires a significant number of open file handles. If you are having problems with large or frequent imports, are seeing “Too many open file descriptors” or similar, you may need to increase the maximum number of open files per process. On Linux, this may be done by setting the nofile limit in /etc/security/limits.conf, for example:
omero soft nofile 10000
omero hard nofile 12000
This permits the omero user to have 10000 open files per process, which may be increased up to a maximum of 12000 by the user. The username and limits will need adjusting for the specifics of your installation and usage requirements. Note that these settings take effect only for new logins, so the server and the shell or environment the server is started from will require restarting. Run ulimit -a as the user running OMERO to verify that the changes have taken effect.
If you have a dataset containing any images which are also present in any other datasets, you will not be able to delete it. First, you must remove the shared images by cutting the links.
If you have data which has been linked by other users, you cannot make the group that data is in into a private group.
Pyramids of image tiles are currently not generated for images with floating-point pixel data, meaning the imported image will be scrambled if it is over a certain size (configurable using omero.pixeldata.max_plane_height and omero.pixeldata.max_plane_width but set to 3192x3192 pixels by default). This primarily affects the following file formats:
If images are imported with one of the omero import --skip options skipping calculation of the global minima and maxima pixel values, OMERO clients will use the extrema of the pixel type range by default. Users can adjust the minima/maxima via the rendering settings. Recalculating minima and maxima pixel values after import is currently not supported.
If you are using the advanced configuration setting FlexReaderServerMaps for importing Flex data split between multiple directories for use with OMERO.tables, you should not upgrade to 5.1.0.
Enabling synchronization of LDAP on user login will result in LDAP being treated as the authority on both group membership and also the available groups. Any groups defined in OMERO and not in LDAP will result in users being removed from these groups. The groups will still exist in OMERO but user membership will be treated as being defined by LDAP alone.