On-Premises Deployment Tutorial

This tutorial guides you through the process of deploying our application on your own infrastructure. Ensure you meet the system requirements before proceeding.

Prerequisites

  • A server environment (physical or virtual) meeting the minimum specifications.
  • Administrator privileges on the target server.
  • A stable network connection.
  • Database server instance (e.g., SQL Server, PostgreSQL) installed and accessible.
  • Necessary firewall rules configured.

Deployment Steps

1

Download the Deployment Package

Obtain the latest on-premises deployment package from the official download portal. This package contains all necessary binaries, configuration files, and scripts.

Download Link: [Download On-Premises Package v1.2.0]

2

Prepare the Database

Create a new database for the application or use an existing one. Execute the provided SQL scripts to set up the necessary schema and initial data.

Database scripts are located in the /sql directory within the deployment package.

Example SQL Command (using PostgreSQL):

-- Connect to your database server
psql -U your_admin_user -d your_database_name -f /path/to/deployment-package/sql/schema.sql
3

Configure Application Settings

Edit the appsettings.json file to configure database connection strings, API keys, logging levels, and other environment-specific settings.

Ensure the database connection string is correctly formatted:

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=your_db_host;Database=your_db_name;User ID=your_db_user;Password=your_db_password;"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  }
}
4

Deploy the Application

Place the application binaries in your chosen deployment directory. If you are using IIS, configure a new website or application pointing to the application's entry point.

For command-line deployment, navigate to the application directory and run:

dotnet YourApplication.dll

Ensure appropriate permissions are set for the application directory.

5

Verify the Installation

Access the application through its designated URL or IP address. Check the application logs for any errors or warnings.

It is recommended to run a diagnostic test available through the administration interface if available.

Troubleshooting Common Issues

  • Database Connection Errors: Verify connection string, firewall rules, and ensure the database server is running.
  • Application Crashes: Check logs for detailed error messages, ensure all prerequisites are met, and consult the FAQ.
  • Performance Issues: Monitor server resources (CPU, RAM, Disk I/O) and review application configuration for optimization.

For more detailed troubleshooting information, please refer to the FAQ or contact support.