Hrms 2.5 Installation -

Installing the HRMS module in ERPNext involves either a guided installation on Frappe Cloud or a manual bench CLI process for self-hosted instances. Key steps include fetching the app, installing it on the specific site, and configuring initial settings like company policies. For a visual walkthrough, watch this guide on YouTube. Install Frappe ErpNext with HRMS

Step 6 — Application Server Configuration

Assign:

  • HTTP Port: 8080 (default) – change to 80 if no other web server exists.
  • HTTPS Port: 8443 (you will bind a certificate later via the admin console).
  • Session Timeout: 480 minutes (or 60 minutes for high-security environments).

7. HRMS 2.5 Application Installation (Non-container)

  1. Obtain HRMS 2.5 package (tar.gz or zip) and transfer to server:
    • scp hrms-2.5.tar.gz admin@server:/opt/
  2. Extract and set ownership:
    • sudo tar -xzf /opt/hrms-2.5.tar.gz -C /opt/
    • sudo chown -R hrms:hrms /opt/hrms-2.5
  3. Configure environment variables or config file:
    • Edit conf/application.properties (or YAML) with DB URL, user, password, app port, and external service endpoints.
    • Example DB URL (Postgres): jdbc:postgresql://db-host:5432/hrms_db
  4. Install Java service wrapper (systemd) for automatic start:
    • Create /etc/systemd/system/hrms.service with ExecStart pointing to java -jar /opt/hrms-2.5/hrms.jar --spring.config.location=/opt/hrms-2.5/conf/
    • Reload and enable:
      • sudo systemctl daemon-reload
      • sudo systemctl enable --now hrms
  5. Check logs (journalctl -u hrms or /opt/hrms-2.5/logs) for startup success.

Step 5 — Database Configuration

This is the most critical screen. Input: hrms 2.5 installation

  • Database Server: localhost or 192.168.1.50\HRMSINSTANCE
  • Authentication: Choose “SQL Server Authentication” (avoid Windows Auth for app-to-db connections unless on a domain with managed service accounts).
  • Database Name: HRMS25_PROD (the installer will create it)
  • Collation: SQL_Latin1_General_CP1_CI_AS

Click Test Connection. If successful, the installer will now populate ~150 tables with initial seed data. This step takes 5–10 minutes.

4. Step-by-Step Installation Procedure

Step 5: Download and Install Odoo 12 (The HRMS Core)

We will clone the Odoo 12 source code from GitHub. Installing the HRMS module in ERPNext involves either

  1. Clone the Repository:

    sudo su - odoo12 -s /bin/bash
git clone https://www.github.com/odoo/odoo --depth 1 --branch 12.0 /opt/odoo12/odoo
exit

  2. Set Permissions:

    sudo chown -R odoo12:odoo12 /opt/odoo12

Phase 2: Downloading the Authentic HRMS 2.5 Installer

With the rise of third-party resellers, obtaining a tampered installer is a real security risk. Always source your installer from:

  • The official vendor portal (e.g., Oracle, SAP SuccessFactors, or your specific HRMS vendor’s support site).
  • A digitally signed ISO or ZIP file containing SHA-256 checksums.

Pro tip: After downloading, run certutil -hashfile HRMS_2.5_Setup.exe SHA256 (Windows) or sha256sum (Linux) and compare the output to the vendor’s official checksum. If they differ, discard the file immediately. HTTP Port: 8080 (default) – change to 80

7. Post-Installation Validation

Perform these checks before going live:

| Test Case | Expected Result | Status | |-----------|----------------|--------| | Add new employee | Employee ID generated, email sent | ☐ | | Mark attendance via biometric | Real-time sync in attendance log | ☐ | | Apply for leave | Approval workflow triggers to manager | ☐ | | Process payroll for one employee | Salary slip generated, TDS computed correctly | ☐ | | Generate ESI/ PF challan | Values match statutory limits | ☐ | | Run monthly attendance summary | No missing punches, overtime calculated | ☐ | | Perform database backup | Backup file created without errors | ☐ |