Skip to main content

WebIDQ on-premises installation guide

Before starting with the installation, check the system requirements carefully together with the local IT team.

Database installation

During WebIDQ on-premises installation and migration, deactivate any power saving settings of the computer.

PostgreSQL

  1. Download PostgreSQL for Windows, click here.

    1. On the PostgreSQL website, click on Windows.
    2. On the page "Windows installers" click Download the installer.
    3. Download the latest version for Windows x86-64.
  2. Run the downloaded PostgreSQL installation file, e.g. postgresql-#.#-#-windows-x64.exe, and follow the instructions of the installation setup wizard.

    Administrator rights are required!

  3. Select the all components to install.

    Define PostgreSQL password

  4. Specify a password for the PostgreSQL database.

    Define PostgreSQL password

    Document this password! It is required for accessing the database and for making backups.

    The name of the superuser account is postgres.

  5. Define a port which is used to communicate with the database. The default port number is 5432.

    PostgreSQL port

  6. In the Advanced Options dialog, select [Default locale].

    PostgreSQL Advanced Options

  7. When the Stack Builder dialog opens, click Cancel.

    PostgreSQL Stack Builder

WebIDQ on-premises installation

A mybiocrates account is required.

For communication between the WebIDQ on-premises host and mybiocrates as well as for updates, e.g. of the user manual, ports 443 and 9090 must be open for the WebIDQ on-premises host. If required check the firewall settings.

  1. In mybiocrates > Subscriptions check if a WebIDQ subscription is active.

    On-premises subscription

    If no WebIDQ on-premises subscription is active, redeem a voucher or purchase a subscription from the biocrates web shop.

  2. Download the WebIDQ on-premises installer from mybiocrates > Downloads.

    Download the WebIDQ on-premises

  3. Run the downloaded WebIDQ on-premises installation file, e.g. WebIDQ-installer-###.exe, and follow the instructions of the installation setup wizard.

    Administrator rights are required!

  4. WebIDQ on-premises and mybiocrates account synchronization.

    1. From the WebIDQ setup window Configuration, copy the "WebIDQ on-premises URL" to the clipboard.

      Copy on-premises URL

    2. In mybiocrates > Subscriptions, paste the "WebIDQ on-premises URL" from the "WebIDQ setup window | Configuration" (previous step) into the field "WebIDQ on-premises URL".

      Paste on-premises URL

      Click Save.

    3. In mybiocrates > Subscriptions, to copy the "WebIDQ on-premises identifier" click Copy WebIDQ on-premises identifier.

      Copy WebIDQ on-premises identifier

    4. In the WebIDQ setup window Configuration, paste the "WebIDQ on-premises identifier" and click Test identifier.

      Paste WebIDQ on-premises identifier

      If this information is shown Identifier not correct, please contact the support team.

    5. Complete the Configuration setup, by clicking Next.

      Complete configuration setup

  5. Specify database connection details for WebIDQ.

    Database

    Data which is available in WebIDQ is stored in or loaded from this database.

    For PostgreSQL database installation, refer to section Database installation.

    PostgreSQL connection settings
    HostPC installation: localhost
    Server installation: server name
    Databasedefault installation:
    no entry
    Username
    default installation
    postgres
    Passworddefined during Database setup
    Port
    default value
    5432

    PostgreSQL connection settings

  1. Click Test connection. If "Connection successful" is shown, click Next.

    Test connection

  2. Optional: Define a proxy server, as shown below in step “Define proxy server”.

    Define proxy server

  3. WebIDQ on-premises is installed. Database is setup on first login.

    Installing database

  4. After the completion of the WebIDQ on-premises installation, the link to access WebIDQ is shown in the Setup - WebIDQ, e.g. "http://pc-name:9090".

    Link to WebIDQ

  5. To be able to access WebIDQ, in mybiocrates > Assign users check if WebIDQ is enabled for all assigned users.

    Activate WebIDQ for users

To start WebIDQ open a web browser and use the link to WebIDQ, e.g. "http://pc-name:9090".

Supported web browser: Chrome or Edge

Define proxy server

A proxy server can be defined during the WebIDQ on-premises installation setup. To define a proxy server, follow these steps.

If WebIDQ on-premises is already installed, to define a proxy server repeat the installation.

  1. Download the latest version of WebIDQ on-premises from mybiocrates > Downloads.
  2. Run the downloaded WebIDQ on-premises installation file, WebIDQ-installer-###.exe.
    Administrative privileges will be required.
  3. During the WebIDQ on-premises installation a proxy server can be defined, as shown below in step “Define proxy server”.

    Define proxy server

Database migration from MetIDQ

If desired, a MetIDQ to WebIDQ database migration can be performed. This procedure is described in the document Technical guide-WebIDQ migration.

OP import

Before starting with the first kit run, download all OPs for the used kit(s) and LC-MS systems(s).

Please refer to sections Kit specific OPs and Loading operating procedures.

Update WebIDQ on-premises installation

To update WebIDQ on-premises, download the latest installer from mybiocrates > Downloads.

Download the WebIDQ on-premises

  • The current version of the on-premises installation can be found in the licenses section:

    avatar icon > About > Third-party licenses About

    Example WebIDQ version 314: Version

  • Once the download file provides a higher number an update can be installed.

  • The current version of the on-premises version installer is part of the file name (WebIDQ-installer-XXX.exe)

The installation of the update may need additional rights on the server (please consult your local administrator). The installation of the update preserved all settings and data.