RightFax ImpUser.exe: Export and Import Users for Bulk Updates | Routing Codes & UNC Paths

Bulk User Management in RightFax Using ImpUser.exe

Overview

ImpUser.exe is a command-line utility included with RightFax that allows administrators to export user information to a comma-delimited file, make bulk modifications, and import the changes back into the RightFax system. This is particularly useful for updating routing codes, UNC paths for inbound fax routing, or other user properties across multiple users without making individual changes through the Enterprise Fax Manager interface.

ImpUser.exe is located in the RightFax\AdminUtils folder on the RightFax server and is available in all versions from RightFax 9.4 through OpenText Fax (RightFax) 24.4.

Prerequisites

Before using ImpUser.exe, ensure you have:

  • Physical or remote desktop access to the RightFax server
  • Windows login credentials for the RightFax service account
  • A RightFax administrator account with a password
  • A text editor capable of handling CSV files (Excel, Notepad++, or similar)

Critical Requirements

ImpUser.exe must be run directly on the RightFax server itself. You must be logged into Windows using the RightFax service account credentials. Running the utility from a remote workstation or under a different Windows account will not work correctly.

The RightFax administrator account used in the command line must have a password configured. The utility will fail if attempting to use an admin account without a password.

Best Practice Tip: Consider creating a dedicated local RightFax administrator account specifically for command-line utilities. This account should have full administrative rights in RightFax and can be used consistently for ImpUser.exe operations without affecting your primary admin accounts. Create this account through Enterprise Fax Manager before running ImpUser.exe.

Exporting the User List

Log into the RightFax server using the RightFax service account credentials.

Open a Command Prompt and navigate to the AdminUtils folder (typically C:\Program Files (x86)\RightFax\AdminUtils or C:\Program Files\RightFax\AdminUtils).

Run the export command using this syntax:

impuser -f<servername> -u<adminuser> -p<password> -o<filepath>

Command Parameters

  • -f = RightFax server name
  • -u = RightFax administrator username
  • -p = Administrator password
  • -o = Output file path (CSV format)

Example

C:\Program Files (x86)\RightFax\AdminUtils\IMPUSER -fRFSERVER01 -uadministrator -pMyP@ssw0rd -oc:\temp\users.csv

This exports all users to C:\temp\users.csv.

Understanding the Export File Format

The exported file is a comma-delimited ASCII file with one user record per line. Each record contains 22 fields in a specific order. Key fields include:

  1. User ID (21 characters max) - Unique RightFax user ID
  2. User name (29 characters max) - Descriptive user name
  3. Password (11 characters max) - User password
  4. Group (21 characters max) - User's group ID
  5. Routing code (7 characters max) - Unique routing code for inbound faxes
  6. Cover sheet (12 characters max) - Default cover sheet filename
  7. Routing type - Format for routing (e.g., FILE, EMAIL, UNC)
  8. Routing format (7 characters max) - File format when routing
  9. Routing address (100 characters max) - Destination for routed faxes (UNC path or email)
  10. Subscriber ID (7 characters max) - Voice mail subscriber ID
  11. 11-22. Additional fields including FROM information, DID numbers, operator numbers, permissions, pager settings, and email addresses

Important: Any field containing a comma must be enclosed in quotation marks.

Making Bulk Modifications

Open the exported CSV file in Excel or a text editor that preserves CSV formatting.

Common Modifications

Updating Routing Codes

Locate the Routing Code column (field 5) and update values as needed. Routing codes must be unique per user.

Changing UNC Paths for Inbound Routing

Locate the Routing Address column (field 9) and update with the new UNC path. Ensure the path format is correct (e.g., \\server\share\folder).

Example:

\\FILESERVER\Faxes\Accounting

Modifying Routing Types

The Routing Type field specifies how faxes are routed. Common values include:

  • FILE - Route to file system
  • UNC - Route to UNC path
  • EMAIL - Route to email address

Updating User Permissions

User permission flags use a plus (+) or minus (−) sign after each character to add or remove permissions. Common flags include:

  • d+ - Allow fax deleting
  • h+ - Allow high priority
  • m+ - User has password

Save your changes in CSV format, preserving the comma-delimited structure.

Importing Modified User Data

After making changes, log back into the RightFax server as the RightFax service account if you are not already logged in.

Open Command Prompt and navigate to the AdminUtils folder.

Run the import command:

impuser -f<servername> -u<adminuser> -p<password> -i<filepath>

Command Parameters

  • -f = RightFax server name
  • -u = RightFax administrator username
  • -p = Administrator password
  • -i = Input file path (CSV format)

Example

C:\Program Files (x86)\RightFax\AdminUtils\IMPUSER -fRFSERVER01 -uadministrator -pMyP@ssw0rd -ic:\temp\users_modified.csv

Important Notes

  • If a user ID in the import file already exists, ImpUser.exe will update that existing user with the new values
  • If a user ID does not exist, ImpUser.exe will create a new user
  • All 22 fields must be present in each row of the import file
  • The group specified for each user must already exist in RightFax

Verification

After importing:

Open Enterprise Fax Manager and verify the changes were applied correctly to the affected users.

Check several user accounts to confirm:

  • Routing codes updated correctly
  • UNC paths are properly formatted and accessible
  • Other modified fields reflect the intended changes

Test inbound fax routing for at least one modified user to ensure faxes route to the correct location.

Troubleshooting

Import Fails with "Error 22 attempting to route to path"

This error typically occurs when the RightFax WorkServer service account does not have permissions to access the specified UNC path. The service account must be a domain account with appropriate network share permissions.

Solution: Configure the RightFax WorkServer modules to use a domain service account with permissions to the UNC paths. In Enterprise Fax Manager, double-click each WorkServer module, click "Select Service Account," and enter domain account credentials.

Import File Format Errors

Ensure the CSV file has exactly 22 fields per line. Missing or extra fields will cause import failures. Verify no line breaks exist within individual fields.

User Not Updated After Import

Verify the User ID matches exactly (including case) between the import file and existing users. Check that the specified group exists in RightFax.

UNC Path Not Working

Confirm the UNC path is accessible from the RightFax server using Windows Explorer or File Explorer. Test with the same domain account used by the RightFax services.

Command Fails to Execute

Verify you are logged into Windows as the RightFax service account. Verify you are running the command directly on the RightFax server, not from a remote workstation.

Best Practices

Always create a backup export before importing changes. Keep a copy of the original exported file in case you need to revert changes.

Test your modifications on a small subset of users before applying to all users. Export a few test users, make changes, import, and verify before proceeding with bulk updates.

Document your changes. Keep a log of what fields were modified and why, especially when updating routing codes or UNC paths across many users.

Validate UNC paths before importing. Ensure all destination paths exist and are accessible to the RightFax service account.

Schedule imports during off-peak hours to minimize impact on production fax operations.

Use a dedicated local RightFax admin account for ImpUser.exe operations to maintain consistency and simplify troubleshooting.

Version Compatibility

This procedure applies to:

  • RightFax 9.4 through 10.6
  • OpenText RightFax 16.x through 20.2
  • OpenText Fax (RightFax) 21.2 through 24.4

Command syntax and the 22-field format remain consistent across all these versions.

  • RightFax Administrative Utilities Guide (specific to your version)
  • Enterprise Fax Manager Administrator Guide
  • RightFax User Management documentation

For additional assistance, contact Ingenium Software Support.

Document Information:

  • Applies to: RightFax 9.4 through OpenText Fax 24.4
  • Article Type: How-To Guide
  • Created: October 15, 2025
  • Last Updated: October 15, 2025