Skip to main content

Fund Migration

The Fund Migration feature allows you to restore or import a fund from a backup file, useful for migrating funds from other systems or restoring from backups.

Accessing Fund Migration​

  1. Navigate to Funds from the organization dashboard
  2. Click "Restore Fund" button
  3. The Fund Migration wizard will open

Migration Process Overview​

The migration process involves:

  1. Upload Backup File: Select and upload your fund backup file
  2. Data Validation: System validates the backup data
  3. Review Data: Review imported fund data
  4. Complete Migration: Finalize the migration process

Step 1: Upload Backup File​

Supported Formats​

  • JSON: Structured JSON backup files
  • CSV: Comma-separated value files (for specific data types)
  • Excel: Excel files with specific format

Upload Process​

  1. Click "Choose File" or drag and drop your backup file
  2. Select the backup file from your computer
  3. Wait for file upload and validation
  4. Proceed to next step if validation succeeds

File Requirements​

  • File must be a valid backup format
  • File size limits may apply
  • File must contain complete fund data

Step 2: Data Validation​

The system automatically validates:

  • File Format: Ensures file is in correct format
  • Data Structure: Verifies data structure matches expected format
  • Required Fields: Checks all required fields are present
  • Data Integrity: Validates data relationships and consistency
  • Uniqueness: Ensures fund codes and identifiers are unique

Validation Errors​

If validation fails:

  • Review error messages
  • Fix issues in the source file
  • Re-upload the corrected file
  • Contact support if issues persist

Step 3: Review Imported Data​

Data Preview​

Review the following imported data:

  • Fund Information: Name, code, type, currency, dates
  • Bank Accounts: All bank account details
  • Chart of Accounts: Account structure
  • Portfolio Holdings: Equity and bond positions
  • Investors: Investor information and holdings
  • Transactions: Historical transactions
  • Accounting Data: Journal entries and balances

Verification Checklist​

Before proceeding, verify:

  • ✅ Fund name and code are correct
  • ✅ Bank accounts match your records
  • ✅ Portfolio holdings are accurate
  • ✅ Investor data is complete
  • ✅ Transaction history is intact
  • ✅ Accounting balances are correct

Making Corrections​

  • Some data can be corrected after migration
  • Critical errors should be fixed before proceeding
  • Contact support for assistance with data corrections

Step 4: Complete Migration​

Final Steps​

  1. Review all imported data one final time
  2. Click "Complete Migration" to finalize
  3. Wait for migration processing
  4. You'll receive confirmation when complete

After Migration​

Once migration is complete:

  • Fund appears in your funds list
  • All data is available and accessible
  • Fund is ready for normal operations
  • Historical data is preserved

Verification​

After migration, verify:

  • Fund appears correctly in funds list
  • Portfolio holdings match expectations
  • Investor data is accurate
  • Accounting balances are correct
  • Historical transactions are accessible

Backup File Format​

JSON Format Structure​

{
  "fund": {
    "name": "Fund Name",
    "code": "FUND-CODE",
    "type": "Equity Fund",
    "currency": "BDT",
    "startDate": "2024-01-01"
  },
  "bankAccounts": [...],
  "accounts": [...],
  "holdings": [...],
  "investors": [...],
  "transactions": [...]
}

Required Sections​

  • fund: Basic fund information
  • bankAccounts: Bank account details
  • accounts: Chart of accounts
  • holdings: Portfolio positions
  • investors: Investor information
  • transactions: Transaction history

Best Practices​

  1. Backup First: Always backup current data before migration
  2. Test Migration: Test with a small dataset first if possible
  3. Verify Data: Thoroughly review imported data
  4. Document Changes: Note any data corrections made
  5. Keep Backups: Retain original backup files

Troubleshooting​

Migration Fails​

  • Check file format and structure
  • Verify all required fields are present
  • Review validation error messages
  • Contact support with error details

Data Discrepancies​

  • Compare imported data with source
  • Check for data transformation issues
  • Verify date formats and timezones
  • Review currency conversions

Missing Data​

  • Check if data is in correct format
  • Verify all sections are included
  • Review file for truncation
  • Contact support for assistance