How to Restore Your Webgility Desktop Database and SQL Server 2022 permission issue
This article helps Webgility Desktop users with two key maintenance processes: restoring a database from a backup and manually installing SQL Server 2022. It is essential for those migrating their system, recovering from failures, or troubleshooting database issues.
Part 1: How to Restore a Webgility Database Backup
Restoring your Webgility Desktop database from a backup is a crucial step in several scenarios:
-
When Should You Restore?
- Moving Webgility Desktop to a new machine.
- Recovering from a system failure or data corruption.
- Reverting to a previous configuration of your Webgility Desktop data.
-
Important Note: You must have Webgility Desktop and SQL Server already installed on your computer before attempting to restore a database backup.
-
Steps to Restore the Database:
- Launch Webgility Desktop.
- Navigate to System > Database > Restore.
- A warning pop-up will appear, indicating that proceeding will overwrite existing data. Click Yes to continue.
- Click Browse to locate your
.bak
file (e.g.,UnifyDB.bak
). - Select the file and click Open.
- Wait for the success message to appear, then close Webgility Desktop.
- Relaunch the application to see your restored data.
-
How to Identify the Workstation with SQL Server: The
.bak
file (your database backup) is created on the computer where the SQL database is hosted. To identify this SQL host machine:- Go to the folder:
C:\Webgility\UnifyEnterprise\XML
. - Open the
apiconfig.xml
file using Notepad. - Look for the value next to the
<Instance Name>
tag — this value is the name of your SQL host machine.
- Go to the folder:
-
Using RightNetworks (Now RightWorks)? If your Webgility Desktop is hosted by RightNetworks (now RightWorks), please contact their support directly to request a backup or perform a database upgrade:
- For Backup Requests:
support2@rightnetworks.com
t2vendor@rightnetworks.com
- For Database Upgrades:
support2@rightnetworks.com
provisioning@rightnetworks.com
- For Backup Requests:
Part 2: How to Manually Install SQL Server 2022 for Webgility Desktop
Sometimes, the automatic SQL Server installation during Webgility Desktop setup may fail. This can happen due to:
- System permission restrictions.
- Firewall or antivirus software blocking the installation.
- Conflicts with pre-existing SQL Server installations on your system.
This guide will walk you through a manual installation of SQL Server 2022 Express Edition for Webgility Desktop.
-
Prerequisites:
- Before you begin, confirm that your computer meets the SQL Server 2022 system requirements.
-
Step-by-Step Installation:
-
Download SQL Server 2022 Express:
- Get it directly from Microsoft's official website: Download SQL Server Express
-
Run the Installer:
- Execute the downloaded setup file.
- Choose Custom installation.
- Click Install.
-
SQL Server Installation Center Launches:
- Select: New SQL Server stand-alone installation.
- Accept the license terms, then click Next.
- Skip Microsoft Updates, then proceed.
-
Handle Firewall Warning (if shown):
- If you see a firewall warning, you may need to temporarily disable your Windows Defender Firewall.
- Open Control Panel > System and Security > Windows Defender Firewall.
- Temporarily disable it under both Private and Public network settings. Remember to re-enable it after installation.
-
Feature Selection:
- On the Feature Selection screen, select only the following components:
- Database Engine Services
- SQL Server Replication
- Local DB
- Click Next.
- On the Feature Selection screen, select only the following components:
-
Instance Configuration:
- Change the Named Instance to:
UNIFY
. - (If you are upgrading an existing Webgility Desktop installation, you might use
UNIFYNEW
instead, butUNIFY
is standard for a clean install). - Click Next.
- Change the Named Instance to:
-
Server Configuration:
- Set the Startup Type to Automatic for both:
- SQL Server Database Engine
- SQL Server Browser
- Set the Startup Type to Automatic for both:
-
Authentication Mode:
- Choose Mixed Mode.
- Enter the following:
- Username:
sa
- Password:
Webgility2011
(Note: The 'W' in Webgility must be capitalized).
- Username:
- Click Next.
-
Finish Installation:
- Once the installation process completes, click OK on the success prompt.
- Close the setup wizard.
-
-
Final Steps:
- Open Webgility Desktop and proceed with its setup.
- If you plan to restore a database backup, follow the steps outlined in Part 1 of this article.