Webgility Database Migration: Common Errors and How to Resolve Them
This article addresses common database-related errors encountered during Webgility Desktop installation or migration, including permission denials, failed SQL connections, and performance issues. It explains typical causes such as SQL Server misconfigurations and permission restrictions, and provides detailed step-by-step solutions to ensure a smooth migration and optimal performance.
Overview
When installing or migrating Webgility Desktop, users may encounter database-related errors such as:
- "CREATE DATABASE permission denied in database 'master'"
- Failed SQL connections
- Performance degradation post-migration
These issues typically arise due to SQL Server misconfigurations, permission restrictions, or missing updates.
This article provides a complete step-by-step solution to resolve such issues and ensure seamless migration and optimized performance.
Common Symptoms
- Webgility Desktop is unable to create a new database.
- SQL Server fails to install during setup.
- Existing database instance cannot be located.
- The application becomes sluggish or unresponsive post-migration.
Root Cause
- Insufficient permissions during SQL Server setup
- SQL Server not properly installed
- Webgility instance or services not configured correctly
- Backup restoration not completed
Resolution Steps
Step 1: Manually Install SQL Server
If automatic installation fails:
- Download SQL Server 2022 Express from Microsoft
- Launch the installer
- Choose Custom Installation
- Set Instance Name as UNIFY (or UNIFYNEW if updating)
- Select Mixed Mode Authentication:
- Username: sa
- Password: Webgility2011
- Ensure services are set to Automatic Start
🔗 Refer to the full SQL Server Installation Guide (Insert actual link)
Step 2: Launch Webgility Desktop
- If prompted with database configuration, proceed to the next step.
Step 3: Connect to an Existing SQL Server
- Choose: Connect Webgility database to an existing SQL Server
- Use dropdown: Browse for More (wait 2–3 minutes)
- Select your new SQL Server instance (e.g., YourPC\UNIFY)
- Enter credentials:
- Username: sa
- Password: Webgility2011
- Click Connect
Step 4: Restore the Database
- When prompted, browse to the .bak backup file from your previous setup
- Click Open and begin restore
- Wait for success confirmation
Step 5: Run the DB Upgrade Utility
- Close Webgility Desktop
- Go to: C:\Webgility\UnifyEnterprise
- Run: UnifyDBUpgrade.exe
- Wait for the success popup
- Reopen Webgility and verify data
Additional Recommendations
- Disable unnecessary Webgility notifications for better speed
- Keep Windows OS up to date
- Restart SQL services if the app hangs:
- Go to Windows Services
- Restart SQL Server (UNIFY) and SQL Server Browser
- Ensure at least 20% free space on the C: drive