Skip to content

Connect a PLOSSYS netdome System


After the installation, the PLOSSYS netdome (p4) connector has already been activated. In the PLOSSYS netdome system, the node-p4rest service has to be installed.

For connecting a PLOSSYS netdome system as backend system for SEAL Operator, execute the following steps:


Install the node-p4rest Service in the PLOSSYS netdome System

  1. In a browser, log on to the SEAL Systems delivery platform with your logon data:

    https://delivery.sealsystems.de

    Hint - logon data

    You receive the logon data from your Technical Project Manager at SEAL Systems.

  2. Download the node-p4rest-5.1.13-216.x86_64.rpm file from the SEAL Systems delivery platform. It is saved as node-p4rest-5.1.13-216.x86_64.rpm.

  3. Install node-p4rest-5.1.13-216.x86_64.rpm. With this, the node-p4rest service will be installed.

    • RHEL:

      sudo yum install node-p4rest-5.1.13-216.x86_64.rpm
      
    • SUSE:

      sudo zypper install node-p4rest-5.1.13-216.x86_64.rpm
      
  4. For setting system variables for the node-p4rest service, create and edit the following file:

    /opt/seal/plossys/etc/p4.env
    
  5. Make sure that the name of the system variable file is specified in the service configuration, /lib/systemd/system/node-p4rest.service:

    [Service]
    ...
    EnvironmentFile=-/opt/seal/plossys/etc/p4.env
    ...
    

    Hint - minus

    The minus (-) in front of the path is important in order to avoid an error if the file does not exist.

  6. Specify the following mandatory node-p4rest key and PLOSSYS netdome variable as system variables in /opt/seal/plossys/etc/p4.env:

    Example - set system variables

    ID_PROVIDER_NAME=https://localhost:32769/auth/realms/SEAL
    PLSROOT=/opt/plossys
    
  7. Specify the following optional node-p4rest keys and PLOSSYS netdome variables as system variables in /opt/seal/plossys/etc/p4.env unless the respective default fits:

    • ID_PROVIDER_CERT (optional): Path and the file name of the certificate generated by the OIDC identity provider

    • INFOSERVER_URL (optional): URL of PLOSSYS Infoserver

    • PLSHOST (optional): Server name of PLOSSYS Infoserver

    • PLSPORT (optional): Port number of PLOSSYS Infoserver

    • PGHOST (optional): Server name of the PLOSSYS netdome PostgreSQL database used for the job reply

    • PGPORT (optional): Port number of the PLOSSYS netdome PostgreSQL database used for the job reply

    • RLIGATE (optional): Name of the target directory for the repro list files (rli, rlist)

    • SERVICE_URL (optional): URL under which the service can be accessed

    Literature - PLOSSYS netdome system variables

    For further information about the PLOSSYS netdome system variables, refer to the PLOSSYS netdome System Description.

  8. Restart the node-p4rest service:

    sudo systemctl restart node-p4rest
    

Activate the Connector and Specify the Keys for the Connection

In SEAL Operator, activate the connector and specify the keys for the connection:

  1. Export the complete configuration of SEAL Operator from Consul to a YAML file in order to ensure that the current configuration settings are used.

    operator config export <filename>.yml --insecure
    
  2. In the section of the PLOSSYS netdome (p4) connector, set cstatus to on. The Fileupload (scratch) connector has to be activated as well.

    operator:
      connectors:
        ...
          p4:
            cstatus: 'on'
            serviceName: operator-p4
            url: 'https://localhost:3010'
          scratch:
            cstatus: 'on'
            serviceName: operator-fileupload
            url: 'https://localhost:3009'
        ...
    

    Caution - do not turn off

    Do not deactivate the Fileupload (scratch) connector due to the PLOSSYS netdome (p4) connector will not work otherwise!

  3. In the env section, specify the following keys for the seal-operator-p4 service:

    env:
      service:
      ...
        operator-p4:
          tag:
            any:
              ACTION_EXECUTOR: P4
              PLOSSYS_URL: 'https://<plossys_4_server_name>:3011'
      ...
    

    Literature - keys

    For further information about the available keys, refer to the description of the Keys.

  4. Specify the following optional keys if required:

    • APW_URL: URL of the APW REST server

    • JWT_USERNAME: User name set in the JSON Web Token (JWT)

    • PLOSSYS_TIMEOUT: Timeout for connecting and retrieving data from the PLOSSYS netdome system

    • STAMP_META: Flag if additional sheets are stamped as well

    • TARGET_CONTENT_TYPE: PLOSSYS netdome-specific job format, repro list or set collation

    • TARGET_FILE_KEY: Key where to put the names of local files when exporting to a repro list

    • USER_NAME_KEY: Key where to put the name of the logged-in user when exporting to a repro list

  5. Save the <filename>.yml file and re-import it to Consul.

    operator config import <filename>.yml --insecure
    

Specify the Logon Data

In SEAL Print Client, specify the logon data to the PLOSSYS netdome system:

  1. Open SEAL Print Client and log on to it.

  2. Open the Server Settings by selecting Settings in the user menu.

    Open server settings

  3. In the PLOSSYS 4 section of the server settings, change to the edit mode, specify the user name and password and save the settings.

    Logon data for PLOSSYS netdome


Customize the Panel (Optionally)

The PLOSSYS 4 panel configuration contained in delivery contains some standard parameters but is normally not sufficient for replacing an existent P2P or PAD installation for example. For how to customize the panel, refer to Customize the Panel.


Back to top