##################################
System Administrator Documentation
##################################

This documentation begins with information aimed at OS-level administrators
and moves on to day-to-day management of OMERO for facility managers (who may
find it useful to read the
:help:`Facility Managers walkthrough <example_facility_manager.html>` for an overview
first).

***************
Getting started
***************

The OMERO server system provides storage and processing of image data
which conforms to the :model_doc:`OME Specification <specifications/>`.
It can be run on commodity hardware to provide your own storage needs,
or run site-wide to provide a large-scale collaborative environment.

Although getting started with the server is relatively straightforward,
it does require installing several software systems, and more advanced
usage including backups and integrated logins, needs a knowledgeable system 
administrator.

Usage
#####

You may find the :doc:`/users/clients-overview` user guide useful before 
working through the installation and maintenance guides provided in this 
section of the documentation.

Components
##########

The server system is composed of several components, each of which runs
in a separate process but is co-ordinated centrally.

-  :doc:`/developers/server-blitz` - the data server provides access to 
   metadata stored in a relational database as well as the binary image data 
   on disk.
-  :doc:`/sysadmins/dropbox` - a filesystem watcher which notifies the server
   of newly uploaded or modified files and runs a fully automatic import 
   (designed as the first implementation of :doc:`/developers/Server/FS` 
   referred to in the architecture diagram).
-  :doc:`/developers/server-processor` - a process-launcher for running user-defined
   scripts.
-  :doc:`/developers/Tables` - provide a way to efficiently store large,
   tabular results.
-  :doc:`OMERO.indexer </sysadmins/search>` - keeps a full-text search index
   up-to-date for searching.

If you are interested in building components for the server, modifying
an existing component, or just looking for more background information, there 
is a section about the server within the :doc:`/developers/index`;
the best starting point is the :doc:`/developers/Server` for developers.

**************************
Requirements & limitations
**************************

.. toctree::
    :maxdepth: 1
    :titlesonly:

    whatsnew
    Version requirements: supported platforms and versions <version-requirements>
    System requirements: hardware specification and examples <system-requirements>
    server-setup-examples
    limitations

************
Installation
************

This section provides guidance on how to install and set up OMERO.server
and OMERO.web on any of the supported UNIX and UNIX-like platforms.
Following the installation links below you will find specific walkthroughs
provided for several systems, with detailed step-by-step instructions.
Reading through the :doc:`unix/server-installation` and
:doc:`unix/install-web/web-deployment` pages first
is recommended as this explains the entire process rather than just being a
series of commands. Further, we recommend  :doc:`ansible-docker` which gives a quick and easy start-up with and gives a handy tooling for your intstall and maintenance routines.

.. toctree::
    :maxdepth: 1
    :titlesonly:

    ansible-docker
    unix/server-installation
    unix/install-web/web-deployment
    unix/server-binary-repository
    unix/server-postgresql
    advanced-install

.. Unclear if we consider the loss of this anchor a breaking change:
.. _maintenance_and_upgrading:

*********
Upgrading
*********

Starting with OMERO 5.6, OMERO.server and OMERO.web installations
are assumed to be separate throughout documentation, each with its own virtualenv.
and installation directory.

.. toctree::
    :maxdepth: 1
    :titlesonly:

    system-migration
    python3-migration
    server-upgrade
    omeroweb-upgrade

.. _server_upgrading:

***********
Maintenance
***********

This section contains instructions for administering, troubleshooting, and
backing-up your installation.

.. toctree::
    :maxdepth: 1
    :titlesonly:

    troubleshooting
    cli/index
    server-backup-and-restore
    UpgradeCheck
    repository-move

.. _index-optimizing-server:

*******************************
Optimizing Server Configuration
*******************************

This section discusses the options for configuring OMERO.server for optimum
performance and security.

.. toctree::
    :maxdepth: 2
    :titlesonly:

    server-security
    server-ldap
    server-performance
    search
    fs-upload-configuration
    server-advanced-configuration
    config
    server-syslog

**************
Managing OMERO
**************

This section contains details on how to manage users, groups and data access
in OMERO. New in OMERO 5.4.0, full administrators can now create restricted
administrators to allow facility managers or other trusted users to carry out
tasks on behalf of all users.

.. toctree::
    :maxdepth: 2
    :titlesonly:

    server-permissions
    restricted-admins
    lookup-tables

.. seealso::

    - Command Line Interface guides for :doc:`cli/usergroup` and
      :doc:`/users/cli/chown`
    - :help:`Wlakthrough for Facility Managers <example_facility_manager.html>`

***********************
Data Import and Storage
***********************

This section contains details of how OMERO.fs allows you to import and store
data with OMERO 5.

.. toctree::
    :maxdepth: 2
    :titlesonly:

    dropbox
    in-place-import
    import-scenarios

.. _index-public-data:

*************************************
Optimizing OMERO as a Data Repository
*************************************

This section explains how to customize the appearance and functionality of
OMERO clients to host images for groups or public viewing.

.. toctree::
    :maxdepth: 2

    public

.. toctree::
    :maxdepth: 2
    :titlesonly:

    customization
