---
source_files:
  - DataPRO/Modules/InstallerCustomActions/LocalSQLDB/LocalDBPreparation.cs
  - DataPRO/Modules/InstallerCustomActions/LocalSQLDB/LocalDBPrepare.cs
generated_at: "2026-04-17T16:45:09.055203+00:00"
model: "zai-org/GLM-5-FP8"
schema_version: 1
sha256: "23d0d5081a0df6ea"
---

# Documentation: LocalSQLDB Module

## 1. Purpose

This module provides installer custom actions for preparing LocalDB database files during DataPRO installation. It determines whether the application will use a local or centralized database configuration, and if local, copies database files (`.mdf` and `.ldf`) from a previous installation to the new installation directory. This enables database migration during upgrades while preserving existing data.

---

## 2. Public Interface

### `LocalDBPreparation` (Class)
Entry point class invoked by the installer.

**Method: `Main(string[] args)`**
- **Signature:** `static void Main(string[] args)`
- **Behavior:** Parses command-line arguments, creates a `LocalDBPrepare` instance, and invokes `PrepareDB()`. On exception, displays a message box with the error message and rethrows an empty `Exception`.

**Arguments:**
- `args[0]` — Target installation directory path (`targetDir`)
- `args[1]` — Product version string (parsed into `Version`)

---

### `LocalDBPrepare` (Class)
Core logic class for database preparation.

**Constructor: `LocalDBPrepare(string targetDir, Version productVersion)`**
- Initializes the instance with the target directory and installing version.

**Method: `PrepareDB()`**
- **Signature:** `public bool PrepareDB()`
- **Behavior:**
  1. Loads configuration from the newly installed executable via `GetNewConfig()`
  2. Determines `DbType` from configuration (defaults to `DbType.Local` on parse failure)
  3. Returns `false` if `DbType.Centralized`
  4. Retrieves `dbName` from configuration (defaults to `Settings.Default.DataPRO`)
  5. Returns `true` if `dbName` matches `Settings.Default.DataPRO` (case-insensitive)
  6. Otherwise, copies `.mdf` and `.ldf` files from the most recent previous installation to the new location