Installation

Applies to: PayPlus Enterprise v3.2 Last updated: March 2026

Pre-Installation Checklist

Complete all items in this checklist before beginning installation. Installation will fail if prerequisites are not met.

System Requirements

Hardware Requirements

Software Requirements

Installation Procedure

1. Extract the installation archive.
   Extract payplus-enterprise-3.2.0.zip to the installation staging directory. The archive contains: payplus.ear (application archive), install/ (installation scripts), config/ (configuration templates), sql/ (database scripts), and docs/ (release notes).

   unzip payplus-enterprise-3.2.0.zip -d /opt/payplus-install

2. Copy the license file.
   Copy payplus.lic to config/license/payplus.lic within the extracted archive. The installation script validates the license before proceeding.
3. Configure the installation properties file.
   Edit install/payplus-install.properties and set the following required values:

   install.dir=/opt/payplus
   appserver.type=jboss
   appserver.home=/opt/jboss-eap-7.4
   db.type=oracle
   db.host=dbserver01.bank.internal
   db.port=1521
   db.name=PPDB
   db.user=ppuser
   db.password=CHANGEME
   payplus.admin.user=ppAdmin
   payplus.admin.password=CHANGEME

   Change all CHANGEME values to secure values complying with your institution's password policy.
4. Run the database schema installation script.
   

   cd /opt/payplus-install/install
   ./install-db.sh --config payplus-install.properties

   The script creates all required tables, sequences, indexes, and initial reference data. Verify the output for any ORA- or SQL Server errors before proceeding.
5. Run the application installation script.
   

   ./install-app.sh --config payplus-install.properties

   The script deploys payplus.ear to the application server, configures data sources, sets environment variables, and creates the PayPlus service.
6. Start the PayPlus service.
   

   systemctl start payplus   # Linux (systemd)
   # or, on Windows:
   net start "PayPlus Enterprise"

   Wait approximately 60–90 seconds for the application to fully initialize.
7. Verify the installation.
   Open a browser and navigate to https://<server>:8443/payplus. The PayPlus login page should appear. Log in with the ppAdmin credentials configured in step 3. The system dashboard should display with all services showing Online status.

Database Setup

Oracle Database

Before running the installation script, create the PayPlus database user with the following grants:

-- Run as DBA
CREATE USER ppuser IDENTIFIED BY "SecurePassword123!";
GRANT CONNECT, RESOURCE TO ppuser;
GRANT CREATE TABLE, CREATE SEQUENCE, CREATE INDEX TO ppuser;
GRANT UNLIMITED TABLESPACE TO ppuser;
ALTER USER ppuser DEFAULT TABLESPACE payplus_data TEMPORARY TABLESPACE temp;

SQL Server

-- Run as sa or sysadmin
CREATE DATABASE payplus_db;
CREATE LOGIN ppuser WITH PASSWORD = 'SecurePassword123!';
USE payplus_db;
CREATE USER ppuser FOR LOGIN ppuser;
ALTER ROLE db_owner ADD MEMBER ppuser;

Application Server Configuration

JVM Heap Settings

The default JVM heap settings are suitable for test environments. Adjust for production based on expected payment volume:

Set heap values in $PAYPLUS_HOME/bin/payplus-env.sh (Linux) or payplus-env.bat (Windows):

JAVA_OPTS="-Xms4g -Xmx8g -XX:+UseG1GC -XX:MaxGCPauseMillis=200"

HTTPS / TLS Configuration

PayPlus Web Console requires HTTPS. Configure a TLS certificate from your institution's PKI or a trusted CA before go-live. Self-signed certificates are acceptable for lab environments only.

1. Obtain a certificate in PKCS#12 format (.p12) from your institution's PKI team.
2. Import the certificate into the PayPlus keystore: $PAYPLUS_HOME/config/security/payplus.keystore
3. Update payplus.properties: set ssl.keystore.path, ssl.keystore.password, and ssl.certificate.alias.
4. Restart the PayPlus service.

Post-Installation Validation

Upgrading from a Previous Version

1. Back up the database. Take a full database backup immediately before the upgrade. Verify the backup is restorable before proceeding.
2. Back up the configuration directory. Archive $PAYPLUS_HOME/config/ to a safe location. This preserves all connector settings, compliance rules, and workflow definitions.
3. Stop the PayPlus service. Confirm all in-flight payments have been processed or safely suspended. Check the payment queue for any pending items.
4. Run the upgrade script. Extract the new version archive and run upgrade.sh --from 3.1 --config payplus-install.properties. The upgrade script applies database schema migrations and redeploys the application.
5. Verify database migrations. Review upgrade.log in the installation staging directory. All migrations must complete with status SUCCESS.
6. Start the PayPlus service and complete the post-installation validation checklist above.