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
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]
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
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"
}
}
}
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.
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.