Separating SEAL APW Service from the Management Server¶
SEAL APW Service is usually installed on the same management server as easyPRIMA. This way easyPRIMA can store the required dynamic data locally in the SEAL APW Service database.
Separating SEAL APW Service from this Management Server means easyPRIMA has to store the required dynamic data on a remote system instead. This might be useful e. g. in PLOSSYS 5 clusters for the reasos of system stability.
If you whish to separate SEAL APW Service from easyPRIMA and the management server, you need to change the configuration of both, SEAL APW Service and easyPRIMA.
Configuring SEAL APW Service¶
-
In an editor, open the
apw-rest.yml
file. -
Activate the following parameters:
-
Deactivate the following parameters:
omsHost
omsPort
omsType
-
Activate the
ADMIN_ROUTE_ACCESS
parameter. This enables SEAL APW Service to receive data from the remote easyPRIMA.ADMIN_ROUTE_ACCESS: '0.0.0.0'
Hint - localhost only
For security reasons, by default only the
localhost
user is granted access to theadmin
route. -
Configure an
.htaccess
password protection to secure theadmin
route despite easyPRIMA being granted access to all remote systems in the cluster.AUTH_ADMIN_TYPE: 'basic'
HTPASSWD_ADMIN_FILE: '.../.htpasswd'
For details on the
.htaccess
password protection, refer to the original documentation of the software producer: Apache HTTP Server Documentation.You will find
.htpasswd
generators in the internet.
Caution - firewall configuration
When installing SEAL APW Service, by default port number 8085 is opened in the firewall configuration to grant access to SEAL APW Client.
Additionally, if you install SEAL APW Service on a remote system, you have to open port number 8084 in the firewall configuration manually to grant access to easyPRIMA.
Configuring easyPRIMA¶
-
In your file manager or in the SEAL shell, change to the following directory:
server\edc\conf
-
Open the
edc.cfg
configuration file. -
In the
[APWREST]
section, activate the following settings, if necessary, and replacelocalhost
by the remote server name on which SEAL APW Service is installed:CONFIG_URI = "https://<APW_Service_host_name>:8084/apw-rest/settings/sealapw"
EXPORT_URI = "https://<APW_Service_host_name>:8084/apw-rest/admin/printers"
OMSCONFIG_URI = "https://<APW_Service_host_name>:8084/apw-rest/admin/omsconfig"
RELOADCACHE_URI = "http://<APW_Service_host_name>:8084/apw-rest/admin/commands/reload-cache"
-
Save the file and exit.