|
Topics: |
This section describes installation considerations for iWay Trading Partner Manager (TPM).
For security purposes, Apache Tomcat versions 8.5.x and higher have implemented stricter validation policies for host names containing underscore (_) characters, which are no longer allowed in host (domain) names.
If you configured iWay TPM to use a host name that contains an underscore character (for example, system_tpm), the following exception is generated when starting iWay TPM:
2019-10-02 15:15:16.141 INFO 5188 --- [nio-8092-exec-1] o.apache.coyote.http11.Http11Processor: The host [system_tpm:8092] is not valid Note: further occurrences of request parsing errors will be logged at DEBUG level. java.lang.IllegalArgumentException: The character [_] is never valid in a domain name. at org.apache.tomcat.util.http.parser.HttpParser$DomainParseState.next(HttpParser.java:963) ~[tomcat-embed-core-9.0.22.jar!/:9.0.22] at org.apache.tomcat.util.http.parser.HttpParser.readHostDomainName(HttpParser.java:859) ~[tomcat-embed-core-9.0.22.jar!/:9.0.22]
As a workaround, adjust your host name by removing any underscore (_) characters.
When installing iWay TPM, if you received any messages regarding SQL scripts during the iWay TPM database connection test phase, ensure that the correct SQL script is executed. For more information, see Using SQL Scripts.
In the latest version of iWay TPM, different encryption is used for passwords. The migration script updates the admin user and you will log in as an administrator the first time. You may want to clean your user file, or set new passwords as part of the migration process.
After updating the default user in the database, you will no longer be able to log in to an older version of iWay TPM with this database. If you need to connect to an older version of iWay TPM, then you must manually add a new user to the database.
For example, to add a user called super:
USE [INSERT DATABASE NAME HERE]
INSERT INTO tpm_users (Username,Firstname,Surname,RoleName,Password,BlockUser) VALUES
('super','Internal','User','1','ENCR(3125314932363225318631772363217323321632272523252255321432173218)','Unblock')Ensure to restart iWay TPM after modifying or changing passwords.
To enable host-based authentication using PostgreSQL (other than localhost), you must configure the pg_hba.conf file. On PostgreSQL, client authentication is controlled by the pg_hba.conf file, which is stored in the database cluster's data directory (for example, C:\Program Files\PostgreSQL\11\data).
For more information about using and configuring the pg_hba.conf file, see the following website: