System Configuration

Polypheny offers a streamlined system, facilitating rapid setups by minimizing administrative overhead.

System Requirements

Ensure optimal operation of Polypheny by adhering to the following minimum system requirements:

Name Specification Mandatory
Capacity min. 20 GB
# CPUs 2
RAM 4 GB
Docker (locally or remote)
💡 Note
While not obligatory, enabling Docker support and linking Polypheny to a Docker instance is strongly recommended. Absence of this connection precludes the use of features like on-demand data store deployment and Notebooks.

Ports

Polypheny primarily utilizes the following ports for its operations:

Port Description
7659 Web UI
20591 Query Interface for drivers and connectors

All ports and additional system capabilities can be configured centrally.

Configuration File

Deployments of Polypheny are managed through a configuration file, formatted in HOCON and parsed internally using GSON.

Polypheny maintains all configuration data as part of the server deployment. Upon initial deployment, Polypheny autonomously generates a new configuration file (default: polypheny.conf) within ${POLYPHENY_HOME}/config/. Configuration alterations can be implemented at runtime via the Web UI, SQL, or directly within the configuration file prior to launching Polypheny.

Below is a sample configuration:

"runtime/webuiServerPort"=7659

"docker/defaultContainerRegistry"="docker.registry.io"

"runtime/dockerInstances" {
    dockerConfig01 {
        alias=localhost
        communicationPort="7001"
        handshakePort="7002"
        host=localhost
        id="25"
        proxyPort="7003"
        registry=""
    }
}

Data Folder

Polypheny utilizes the local file system for storage, defaulting to a specialized folder named .polypheny within the executing user’s home directory. This location can be modified by defining a system environment variable, POLYPHENY_HOME, to indicate the preferred location before initiating Polypheny.

Utilizing systemd on Linux Systems

For initiating and autonomously operating Polypheny on Linux systems, utilizing systemd is recommended. Establish a systemd service by creating a polypheny.service Unit-File within /etc/systemd/system.

💡 Note
If utilizing our precompiled binaries for Linux distributions, a systemd Unit-File is preconfigured for your convenience.
[Unit]
Description=Polypheny-DB - A self-adaptive Polystore providing cost- and workload-aware access to heterogeneous data
After=multi-user.target

[Service]
Environment=POLYPHENY_HOME=/path/to/data/
ExecStart=/opt/polypheny/bin/Polypheny -daemon
ExecReload=/bin/kill -HUP $MAINPID
KillMode=process

Upon file creation, reload the configuration:

systemctl daemon-reload polypheny.service

Subsequently, initiate the service:

systemctl start polypheny.service
© Polypheny GmbH. All Rights Reserved.