Agile REVEL Installation Manual

The Agile REVEL is a modern, scalable software platform designed for rapid deployment and integration. It features a modular architecture, cloud-native capabilities, RESTful APIs, real-time data processing, and comprehensive security protocols. This manual provides essential guidance for system administrators and IT professionals to safely and effectively install, configure, and verify the Agile REVEL platform. Below are key sections covering prerequisites, installation steps, configuration, verification, and post-installation tasks.

System Requirements & Prerequisites

Key components: Application Server, Database Server, Web Server, Network Infrastructure.

Component	Minimum Specification
Operating System	Linux (RHEL/CentOS 8+), Windows Server 2019+
CPU	4-core 2.4 GHz or higher (64-bit)
RAM	16 GB minimum
Storage	100 GB free disk space (SSD recommended)
Database	PostgreSQL 12+, MySQL 8.0+ or MS SQL Server 2019
Web Server	Apache 2.4+ or Nginx 1.18+
Runtime	Java Runtime Environment 11 or .NET Core 6.0
Network	Static IP, Ports 80/443, 8080 open
Browser Support	Chrome 90+, Firefox 88+, Edge 90+
Privileges	Administrator/Sudo access on target server

Pre-Installation Checklist

Verify all prerequisites before beginning the installation process.

1. Confirm hardware and software requirements are met.
2. Obtain installation package and valid license key from Agile vendor portal.
3. Ensure database server is installed, running, and accessible.
4. Configure firewall rules to allow necessary traffic (HTTP/HTTPS, database ports).
5. Create a dedicated service account with appropriate permissions.

WARNING! Installation on non-compliant systems may lead to failures or security vulnerabilities. Always perform in a test environment first.

Installation Procedure

Run the installer with elevated privileges; follow on-screen prompts.

1. Extract the installation archive to a target directory (e.g., /opt/agile-revel).
2. Launch the installer: On Linux, run `./install.sh`; on Windows, run `setup.exe`.
3. Accept the license agreement.
4. Specify the installation path (default recommended).
5. Select installation type: Typical (recommended) or Custom.
6. Enter database connection details (host, port, name, credentials).
7. Configure web server settings (hostname, port, SSL certificate if available).
8. Start the installation process. This may take several minutes.
9. Upon completion, note the URL for the administration console.

CAUTION! Do not interrupt the installation process. Ensure stable power and network connectivity.

Initial Configuration

• First Login: Access the admin console via the provided URL. Use default credentials (admin / changeme).
• System Settings: Configure organization name, time zone, default language, and email server (SMTP).
• License Activation: Navigate to System > License and enter the provided license key.
• Database Connection: Verify and test the connection under System > Database.
• Module Activation: Enable required platform modules (e.g., Reporting, API Gateway, Workflow Engine).
• Logging: Set log levels and rotation policies.

Platform Verification

Confirm the installation is successful and all services are running.

Service Status: Check via system service manager (e.g., `systemctl status agile-revel` on Linux). All core services should be 'active (running)'.

Web Console: Log in to the administration console. Verify no error messages appear on the dashboard.

Health Check: Navigate to `https://[your-host]/api/health`. The response should be `{"status":"UP"}`.

Database Connectivity: Use the console's database test tool. Ensure read/write operations are successful.

API Endpoints: Verify key REST API endpoints are accessible (e.g., `/api/v1/users`).

Connecting to Data Sources

Agile REVEL can integrate with external databases, APIs, and file systems.

1. Navigate to Configuration > Data Sources.
2. Click 'Add New Data Source'.
3. Select type (JDBC, REST API, File System, Message Queue).
4. Provide connection parameters (URL, credentials, driver class).
5. Test the connection.
6. Save and name the data source for use in modules.

Tip: Use connection pooling for database sources to improve performance. Encrypt all credentials stored in the configuration.

User & Role Setup

Define users, groups, and permissions to control platform access.

1. Create Roles: Go to Security > Roles. Define roles (e.g., Administrator, Analyst, Viewer) with specific permissions.
2. Create User Groups: Organize users into logical groups for easier permission management.
3. Add Users: Go to Security > Users. Add users manually or import from LDAP/Active Directory.
4. Assign Roles/Groups: Assign each user to one or more roles and groups.
5. Password Policy: Enforce strong password policies and expiration rules.

WARNING! Limit administrative privileges. Follow the principle of least privilege.

Security Configuration

Enable security features to protect the platform and data.

SSL/TLS: Enforce HTTPS for all web traffic. Install a valid certificate from a trusted CA.

Network Security: Restrict access to the admin console and API endpoints via firewall rules (IP whitelisting).

Authentication: Configure multi-factor authentication (MFA) for administrative accounts.

Audit Logging: Enable comprehensive audit trails for all user actions and system changes.

Data Encryption: Ensure data at rest (database) and in transit (network) is encrypted.

Backup & Recovery Setup

Establish a routine backup strategy to prevent data loss.

Backup Components: Application configuration, Database, Uploaded files, Logs.

Procedure: Use platform's built-in backup tool (System > Backup) or script database and file system backups.

Frequency: Daily incremental backups; weekly full backups.

Storage: Store backups in a secure, off-site location.

Recovery Test: Periodically test the recovery process to ensure backups are valid.

CAUTION! Backups containing sensitive data must be encrypted.

Regulatory Information

Agile REVEL is designed to assist with compliance frameworks including GDPR, HIPAA, and SOC 2. The platform includes features for data anonymization, access logging, and consent management. Copyright © 2025 Agile Software Solutions Inc. All trademarks are the property of their respective owners. For technical support, visit https://support.agilerevel.com or contact +1-800-555-REVEL.

Troubleshooting

Symptom	Possible Cause	Corrective Action
Installer fails to start	Insufficient permissions, missing dependencies	Run as administrator/root. Verify all prerequisites (Java/.NET, libs). Check installer log.
Cannot connect to database	Wrong credentials, network issue, firewall	Verify host/port/credentials. Test telnet to DB port. Check firewall rules.
Web console not accessible	Service not running, port conflict	Check service status. Ensure ports 80/443/8080 are free and not blocked.
High memory/CPU usage	Insufficient resources, memory leak	Allocate more RAM. Check for runaway processes in logs. Restart services.
API calls returning errors	Misconfiguration, invalid tokens	Verify API gateway configuration. Regenerate API keys. Check request format.

Logs: Primary logs are located at `/var/log/agile-revel/` (Linux) or `C:\Program Files\AgileREVEL\logs\` (Windows).

Reset Admin Password: Use the `reset-password.sh` utility in the installation bin directory.

Support: +1-800-555-REVEL; https://support.agilerevel.com