Insurance Agency Management Software

IT Professional FAQ

Technical Support for IT Professionals

This FAQ is designed for IT professionals or computer savvy users supporting ABS Agency Builder installations. Click any question to reveal detailed technical information. Topics include network configuration, database management, security settings, and advanced troubleshooting.

Important Note

While ABS is designed for ease of use, proper network configuration and security settings are critical for multi-user environments. This guide assumes familiarity with Windows networking, file permissions, and basic database concepts.

Network Configuration

What are the network requirements for multi-user setup?

Network Requirements:

  • Server: Windows Server 2012 R2 or later (or Windows 10/11 Pro for small offices)
  • Network: Gigabit Ethernet recommended (100Mbps minimum)
  • File Sharing: SMB 2.0 or later enabled
  • Ports: Standard Windows file sharing ports (TCP 445, UDP 137-138, TCP 139) plus port 6519
  • Latency: Less than 50ms between server and workstations

Not Recommended: VPN connections, wireless-only setups, or WAN connections may cause performance issues.

How should the shared database folder be configured?

Share Permissions:

  • Share-level: Everyone = Full Control
  • NTFS Permissions: Domain Users (or workgroup users) = Modify
  • Disable: Access-based enumeration
  • Enable: Opportunistic locking (OpLocks)

Path Configuration: Use the ABS Datapath Configruation app to create UNC paths (or IP address) rather than mapped drives.

What firewall ports need to be open?

Required Firewall Rules:

  • SMB File Sharing: TCP 445
  • NetBIOS: UDP 137-138, TCP 139
  • Internet Access: HTTPS (443) for updates and license validation
  • Database: TCP 6519

Windows Firewall Configuration:

  1. Enable "File and Printer Sharing" exception
  2. Allow all ABS executable through firewall (both Public and Private networks)
  3. For Server, enable "File Server" role firewall rules

Note: Third-party firewalls may require similar exceptions. Some security software blocks network database access by default.

Can ABS work over VPN or WAN connections?

Not Recommended for Production Use. ABS is designed for LAN environments and requires low-latency, high-bandwidth connections.

Why VPN/WAN Causes Issues:

  • Database file locking requires consistent, low-latency connections
  • Network interruptions can cause data corruption
  • Performance degradation makes the application unusable
  • Document Manager file transfers are extremely slow (unacceptable for production use)

Alternative Solutions:

  • ABS Cloud: Hosted solution designed for remote access
  • Remote Desktop: Use RDP to access server where ABS is installed
  • Terminal Services: Run ABS on Terminal Server with RDP connections

Database Management

Upgrading Windows on the Server (Host computer). What needs to be done?

You will probably need the User Manual for detailed instructions.

Steps:

  1. Use ABS Data Backup to make a removable backup of your data.
  2. Upgrade Windows making sure it is still connected to your network.
  3. After Windows is operating properly, install ABS per the installation instructions (especially step 14).
    • Do a Host installation.
    • Do not attempt to open ABS yet.
  4. Using ABS Data Restore, restore the data from the backup made in step 1. You may now open ABS.

Note: if the new host has a different Computer Name, you will need to reconfigure the path for each workstation.

How can I add a new workstation?

You will probably need the User Manual for detailed instructions.

Steps:

  1. Use ABS Data Backup to make a removable backup of your data.
  2. Upgrade Windows making sure it is still connected to your network.
  3. After Windows is operating properly, install ABS per the installation instructions (especially step 14).
    • Do a Host installation.
    • Do not attempt to open ABS yet.
  4. Using ABS Data Restore, restore the data from the backup made in step 1. You may now open ABS.

Note: if the new host has a different Computer Name, you will need to reconfigure the path for each workstation.

How can I change the Server (Host) to a different computer?

You will need the installation manual during this process. It does not cover changing host computers, so follow these instructions.

Steps:

  1. Use ABS Data Backup to make a removable backup of your data.
  2. Upgrade Windows on the new host computer if necessary.
  3. Make sure the new host computer is connected to your network.
  4. On the new host, uninstall ABS if installed.
  5. On the new host, install ABS as a Host Computer according to the installation instructions (especially step 14)
    • Do a Host installation.
    • Do not attempt to open ABS yet.
  6. Using ABS Data Restore, restore the data from the backup made in step 1. You may now open ABS.
  7. On each workstation, update the ABS configuration to point to the new host.
  8. On each workstation, verify that the ABS services are running and accessible.
  9. If the old server is to be retaind as a workstation, uninstal ABS and reinstall as a Client Workstation.

Note: if the new host has a different Computer Name, you will need to reconfigure the path for each workstation.

What database engine does ABS use?

ABS uses Firebird SQL a proprietary database engine optimized for insurance agency data. The database consists of a single file stored in the ABS3 folder. Document Manager files are located in the ABS3/DocMan subfolder.

Database Characteristics:

  • SQL Server: Open source Firebird SQL
  • Multi-User: Supports concurrent access
  • Self-Maintaining: Automatic index optimization
  • Robust: Transaction logging prevents corruption
  • Lightweight: Minimal resource usage
  • Convenient: Live backups using the ABS Data Backup tool

Important:

  • Do not modify database directly with any 3rd party tools. Use ABS's built-in tools for all database operations.
  • Perform backups using the ABS Data Backup tool. It can be scheduled via Windows Task Scheduler (see user manual).
How should database files be backed up?

Backup Methods (in order of preference):

  1. ABS Built-in Backup (Recommended):
    • Use Admin > Backup Database within ABS
    • This ensures proper file locking and consistency
    • Can be scheduled for automatic daily backups (see user manual)
  2. Volume Shadow Copy (VSS):
    • Use Windows Server Backup or compatible backup software
    • Ensures file consistency at the block level
    • Good for disaster recovery scenarios
  3. File Copy (Not Recommended While ABS Running):
    • Only safe when ABS is completely closed on all workstations
    • Risk of corruption if files are copied while in use

Backup Frequency: Daily minimum, hourly for high-volume agencies. Keep at least 30 days of backups.

CAUTION: If using a 3rd party backup tool, do not backup the database file directly. Instead, use ABS's built-in tool, then use the 3rd party tool to backup the resulting backup file.

What's the expected database size and growth rate?

Typical Database Sizes:

  • Small Agency (500-1000 policies): 200-500 MB
  • Medium Agency (2000-5000 policies): 1-3 GB
  • Large Agency (10,000+ policies): 5-15 GB

Document Manager Storage: Varies widely based on usage. Expect 50-100 MB per 1000 client documents.

Growth Rate: Approximately 10-20% annually for established agencies, more for rapidly growing agencies.

Disk Space Planning: Allocate 10x current database size for server storage to accommodate growth and backups.

Note: The above estimates are for initial planning purposes only. Actual usage may vary based on specific agency needs and document management practices.

How do I compact or optimize the database?

Database Maintenance:

The most complete way to reclaim disk space and fully optimize the database structure (including indexes) is to perform a backup and restore. This creates a new, compact database file.

When to perform this:

  • Performance degradation
  • After importing large amounts of data
  • After deleting significant records
  • Quarterly as preventive maintenance

Security Configuration

What are the password requirements and security settings?

Password Configuration:

  • Passwords are optional by default but strongly recommended
  • Initially assigned in the ABS Administration application
  • Change under Tools & Settings > Program Preferences > Personal Preferences
  • Minimum 8 characters recommended
  • Passwords are encrypted in the database
  • No automatic expiration (set organizational policies separately)

User Permissions:

  • Admin users have full access
  • Users can change their password at will
  • Users can be restricted to specific functions by the Administrator
  • Document Manager access can be controlled separately
  • Report and ACORD form access can be restricted by the Administrator

Security Best Practices:

  • Require ABS passwords for all users
  • Require Windows passwords for all users
  • Implement Windows Active Directory for authentication
  • Regular security audits of user permissions
How should antivirus be configured for ABS?

Critical Antivirus Exclusions:

Files/Folders to Exclude:

  • C:\ABS3\ (or installation directory) -- include subfolders
  • \\ServerName\ABS3\ (database folder and sub-folders)

Processes to Exclude:

  • ABS3.exe
  • ABS3Backup.exe
  • ABSAcord.exe
  • ABSAdmin.exe
  • ABSIMG.exe
  • ABSRestore.exe
  • ABSUpdate.exe

Why Exclusions Are Critical:

  • Antivirus scanning can lock database files, preventing multi-user access
  • Real-time scanning causes significant performance degradation
  • False positives may quarantine critical program files
  • Database corruption can occur if AV interrupts file operations

Alternative Security: Use Windows Defender exclusions or ensure third-party AV respects file locking.

Is the data encrypted?

Encryption Status:

  • Passwords: Encrypted in database
  • Database: Critical data is encrypted to protect against unauthorized access
  • Network Transmission: Standard SMB encryption available
  • Documents: Stored as-is (PDF, Word, etc.)

Compliance Note: For HIPAA, PCI, or other compliance requirements, use Windows-level encryption rather than relying on application-level encryption.

Performance Optimization

What causes performance issues?

Common Performance Bottlenecks:

  1. Network Latency (Most Common):
    • Wireless connections
    • Network congestion
    • VPN or WAN connections
    • Faulty network hardware
  2. Server Storage:
    • Traditional hard drives (use SSD for database)
    • Network-attached storage with high latency
    • Disk fragmentation
  3. Antivirus Interference:
    • Real-time scanning of database files
    • Missing AV exclusions
  4. Database Issues:
    • Database needs compacting (backup and restore)
    • Corrupted indexes (extremely rare with ABS)
    • Extremely large document repository
What are the optimal server specifications?

Recommended Server Specifications:

Small Office (1-5 users):

  • Intel Core i5 or equivalent
  • 8GB RAM
  • 250GB SSD for database storage
  • Gigabit network interface

Medium Office (6-15 users):

  • Intel Xeon or Core i7
  • 16GB RAM
  • 500GB SSD for database storage
  • Dual gigabit network interfaces (teaming)
  • RAID 1 for redundancy

Large Office (16+ users):

  • Multi-core Xeon processor
  • 32GB+ RAM
  • 1TB+ NVMe SSD
  • Redundant network connections
  • RAID 10 for performance and redundancy
  • UPS for power protection

Critical: SSD storage makes a dramatic difference in database performance. Traditional hard drives are no longer recommended for database storage.

Backup & Disaster Recovery

What's the recommended backup strategy?

IMPORTANT: Use the ABS Backup application!

3-2-1 Backup Rule:

  • 3 copies of data (1 primary + 2 backups)
  • 2 different storage types (disk + cloud/tape)
  • 1 offsite copy

Recommended Implementation:

  1. Daily ABS Backup: Use built-in backup to local disk
  2. Hourly VSS Snapshots: Windows Server Backup or backup software
  3. Nightly Offsite: Sync backups to cloud storage (Dropbox, OneDrive, Backblaze)
  4. Weekly Verification: Test restore from backup

Retention Policy:

  • Daily backups: 30 days
  • Weekly backups: 3 months
  • Monthly backups: 1 year
  • Year-end backups: 7 years (regulatory requirement)
How do I restore from backup?

Restoration Procedure:

  1. Stop ABS: Ensure all users close ABS completely
  2. Locate Backup: Find the most recent good backup
  3. Make Backup Available: Insert backup media (USB, external drive)
  4. Restore Files: Run the ABS Data Restore application
  5. Test: Launch ABS and verify data integrity
  6. Verify: Check critical data (recent transactions, client records)
  7. Clean Up: After confirming success, return the backup media to its original location

Important: Never delete the old data until you've verified the restore was successful. Keep the old data for at least 30 days.

Partial Restore: If only Document Manager files are corrupted, you can restore just the Documents folder without affecting database.

What should be included in a disaster recovery plan?

Disaster Recovery Checklist:

Documentation to Maintain:

  • Server location and login credentials
  • Network configuration (IP addresses, paths)
  • Backup locations and schedules
  • License information and support contacts
  • List of installed software and versions

Recovery Time Objectives:

  • Minor Issues: 1-2 hours (restore from daily backup)
  • Server Failure: 4-8 hours (rebuild server, restore data)
  • Total Loss: 24-48 hours (new hardware, complete restoration)

Test Your Plan: Perform quarterly disaster recovery drills. Restore to a test environment and verify operation.

Advanced Troubleshooting

Users can't connect to database

Systematic Troubleshooting:

  1. Verify Network Connectivity:
    ping ServerName Test-Path \\ServerName\ABSData

    If ping fails, it's a network/DNS issue, not ABS.

  2. Check Port & File Sharing:
    • Verify Port 6519 is open (database access)
    • Verify ABS3 folder (and subfolders) are shared and are accessible (document access)
    • Check NTFS permissions (not just share permissions)
    • Ensure SMB is enabled (SMB 1.0 not required)
  3. Verify Database Files:
    • Make sure ABS3DATA.FDB exists
    • Make sure its location agrees with ABS configuration
    • Verify no antivirus quarantine
  4. Verify Firebird Service is running:
    • Check Services for Firebird Server - ABS FB214
    • Make sure Status = Running
    • Startup Type = Automatic
  5. Check ABS Configuration:
    • Verify path configuration matches actual database location
    • Use UNC paths. Do not use mapped drives
    • Check for typos in server name or path
  6. Security Software:
    • Temporarily disable antivirus to test
    • Check Windows Firewall rules
    • Verify no endpoint protection blocking file access
ABS runs slowly - performance optimization steps

Performance Optimization Checklist:

  1. Measure Network Performance:
    • Test throughput to server (should be 50+ MB/s)
    • Check latency (should be under 10ms)
    • Look for packet loss (should be zero)
  2. Move Database to SSD:
    • Single biggest performance improvement
    • 10-50x faster than traditional hard drives
    • Necessary for offices with 5+ concurrent users
  3. Compact Database:
    • Backup and Restore using ABS backup and restore tools
    • Can improve performance by 20-50%
    • Do quarterly as preventive maintenance
  4. Configure Antivirus Exclusions:
    • Exclude ABS3 folder from real-time scanning
    • Exclude ABS3.exe from monitoring
    • Can improve performance by 30-60%
  5. Check for Network Issues:
    • Replace any wireless connections with wired
    • Update network drivers
    • Check for network congestion
Windows updates broke ABS - rollback procedures

Most common cause:

  1. Firebird Service is stopped:
    • Restart Firebird service: Firebird Server - ABS FB214
    • Make sure Firebird is set to start automatically
  2. ABS Firewall rules are blocking traffic:
    • Update Firewall or reinstall ABS on the host computer

If the above didn't work:

  1. Identify the Update:
    • Settings > Update & Security > View update history
    • Note the KB number of recent updates
  2. Check Known Issues:
    • Contact ABS support first
    • May be a known issue with workaround
  3. Uninstall Problematic Update:
    • Settings > Update & Security > View update history > Uninstall updates
    • Select problem update and uninstall
    • Restart computer
  4. Pause Updates Temporarily:
    • Settings > Update & Security > Pause updates for 7 days
    • Gives time to coordinate with support

Prevention: Test Windows updates on non-critical workstation before deploying to server or all workstations.

Need Direct Technical Support?

For complex technical issues or emergency support, contact our technical team directly.