Overview

This guide covers the complete installation process for FrameworX 10.1, from initial setup through licensing activation. Follow these procedures to ensure proper installation, configure licensing, and verify system operation. The installation process varies slightly based on operating system and deployment type.

Installation Steps

Pre-Installation Preparation

System Verification

  1. Check System Requirements
  2. Prepare Environment
  3. Download Installation Files

Windows Installation

Standard Installation

  1. Launch Installer
  2. Installation Wizard
  3. Component Selection (Custom only)
  4. Installation Path
  5. Database Configuration
  6. Service Configuration
  7. Complete Installation

Command Line Installation

Silent installation for automation:

cmd

setup.exe /S /V"/qn INSTALLDIR=\"C:\FrameworX\" ADDLOCAL=ALL"

Parameters:
/S              - Silent mode
/V              - Pass parameters to MSI
/qn             - No UI
INSTALLDIR      - Installation path
ADDLOCAL        - Features to install
DBTYPE          - Database type (SQLITE|SQLSERVER)
DBSERVER        - Database server name
SERVICETYPE     - Service account type

Linux Installation

Ubuntu/Debian Installation

bash

# Update package list
sudo apt-get update

# Install dependencies
sudo apt-get install -y wget apt-transport-https software-properties-common

# Add Microsoft package repository
wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb

# Install .NET Runtime
sudo apt-get update
sudo apt-get install -y dotnet-runtime-6.0 aspnetcore-runtime-6.0

# Download FrameworX package
wget https://download.frameworkx.com/linux/frameworkx-10.1.deb

# Install FrameworX
sudo dpkg -i frameworkx-10.1.deb

# Configure service
sudo systemctl enable frameworkx
sudo systemctl start frameworkx

RHEL/CentOS Installation

bash

# Install dependencies
sudo yum install -y wget

# Add Microsoft repository
sudo rpm -Uvh https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm

# Install .NET Runtime
sudo yum install -y dotnet-runtime-6.0 aspnetcore-runtime-6.0

# Download and install FrameworX
wget https://download.frameworkx.com/linux/frameworkx-10.1.rpm
sudo rpm -ivh frameworkx-10.1.rpm

# Start service
sudo systemctl enable frameworkx
sudo systemctl start frameworkx

Docker Installation

Docker Deployment

dockerfile

# Pull official image
docker pull frameworkx/runtime:10.1

# Run container
docker run -d \
  --name frameworkx \
  -p 9000:9000 \
  -p 80:80 \
  -v /data/solutions:/app/solutions \
  -v /data/licenses:/app/licenses \
  frameworkx/runtime:10.1

# With environment variables
docker run -d \
  --name frameworkx \
  -e LICENSE_KEY=XXXX-XXXX-XXXX-XXXX \
  -e DB_CONNECTION="Server=db;Database=fx" \
  -e ADMIN_PASSWORD="SecurePass123!" \
  frameworkx/runtime:10.1

Docker Compose

yaml

version: '3.8'
services:
  frameworkx:
    image: frameworkx/runtime:10.1
    ports:
      - "9000:9000"
      - "80:80"
    volumes:
      - solutions:/app/solutions
      - licenses:/app/licenses
    environment:
      - LICENSE_KEY=${LICENSE_KEY}
      - DB_TYPE=POSTGRES
      - DB_HOST=database
    depends_on:
      - database
      
  database:
    image: postgres:14
    environment:
      - POSTGRES_DB=frameworkx
      - POSTGRES_USER=fxuser
      - POSTGRES_PASSWORD=${DB_PASSWORD}
    volumes:
      - dbdata:/var/lib/postgresql/data

volumes:
  solutions:
  licenses:
  dbdata:

License Types

Development License

For solution development and testing:

Runtime License

For production deployment:

Combined License

Development and runtime in one:

Trial License

Full-featured evaluation:

Enterprise License

Organization-wide deployment:

Activation Process

Online Activation

Automatic activation with internet connection:

  1. Open License Manager
  2. Enter License Key
  3. Activation Process
  4. Confirmation

Offline Activation

For systems without internet:

  1. Generate Request File
  2. Submit Request
  3. Apply License
  4. Verify Activation

Hardware Dongle

USB-based licensing:

  1. Insert Dongle
  2. Driver Installation
  3. License Detection
  4. Dongle Management

License Server

Centralized license management:

  1. Server Setup
  2. Client Configuration

    xml

    <LicenseSettings>
  <ServerAddress>license.company.com</ServerAddress>
  <Port>27000</Port>
  <Timeout>30</Timeout>
</LicenseSettings>
  3. License Checkout

Troubleshooting Installation

Common Installation Issues

IssueCauseSolution
Installer won't startMissing prerequisitesInstall .NET Framework and VC++ Redistributables
Installation fails at 50%Insufficient disk spaceFree up disk space, need 5GB minimum
Service won't startPermission issueCheck service account permissions
Database connection failsSQL Server configurationEnable TCP/IP, check firewall
Missing componentsPartial installationRun repair installation
Upgrade failsVersion conflictUninstall previous version first

License Issues

IssueCauseSolution
Invalid license keyTyping errorVerify key, check for O/0, I/1 confusion
Activation failsNetwork blockedCheck firewall, use offline activation
License expiredTime-limited licenseRenew license or request extension
Feature not availableWrong license typeUpgrade license to include feature
Dongle not detectedDriver issueReinstall dongle drivers
Too many activationsLicense limit reachedDeactivate unused installations

Post-Installation Issues

IssueCauseSolution
Designer won't openLicense typeVerify development license installed
Can't create solutionPermission issueRun as administrator
Slow performanceWindows DefenderAdd exclusions for FrameworX folders
Missing templatesIncomplete installationRun repair, install samples

Verification Procedures

Installation Verification

  1. Check Services

    cmd

    # Windows
sc query "FrameworX Runtime"

# Linux
systemctl status frameworkx
  2. Verify Files
  3. Test Basic Functions

License Verification

  1. Check License Status
  2. Test Licensed Features
  3. Generate License Report

Upgrade Procedures

Upgrading from Previous Versions

  1. Backup Current System
  2. Check Compatibility
  3. Perform Upgrade

Migration Checklist

AI Assistant Data

<details> <summary>Structured Information for AI Tools</summary>

json

{
  "module": "Installation & Licensing",
  "category": "Reference Guide",
  "purpose": "Complete installation and licensing procedures",
  "installationTypes": {
    "windows": ["Standard", "Command Line", "Server Only"],
    "linux": ["Ubuntu/Debian", "RHEL/CentOS"],
    "container": ["Docker", "Kubernetes"]
  },
  "licenseTypes": {
    "development": "Design and test only",
    "runtime": "Production deployment",
    "combined": "Development and runtime",
    "trial": "30-day evaluation",
    "enterprise": "Organization-wide"
  },
  "activationMethods": [
    "Online activation",
    "Offline activation",
    "Hardware dongle",
    "License server"
  ],
  "commonTasks": [
    "Fresh installation",
    "Upgrade existing",
    "License activation",
    "Troubleshooting",
    "Verification"
  ],
  "supportFiles": {
    "logs": "Installation.log",
    "config": "FrameworX.config",
    "license": "License.lic"
  }
}

</details>