License registration

Registration of Visual Assist takes the software out of trial mode, or extends software maintenance when Visual Assist is already out of trial mode.

Registration requires Visual Assist build 2318 or newer, and one of:

• a serial number that did not accompany a license file (reg*.txt or .slip). (A serial "number" is a set of alphanumeric characters in the format XXXX-XXXXXX-XXXXXX-XXXX).
   
• a license file (reg*.txt or .slip), obtained after a serial number is registered, or after a local license server is installed and configured.

Confirm you have Visual Assist build 2318 or newer by examining your build number in VAssistX | Help | About.

Registration for Multiple Users

If you purchased a multi-user license of Visual Assist and hold multiple serial numbers, you can:

1. Distribute the serial numbers to users for individual registration. Each user will require an account on the Embarcadero Developer Network (EDN). Each user can install Visual Assist to three hosts before requesting to licenses@wholetomato.com that a host be deactivated, or count increased. (Whole Tomato Software and Embarcadero are both Idera, Inc. companies).
    
2. Request an expanded (shared) serial number. Each user will require an account on the Embarcadero Developer Network (EDN). Each user can install Visual Assist to three hosts before requesting to licenses@wholetomato.com that a host be deactivated, or count increased. (The advantage of an expanded serial number over multiple serial numbers is that one need not track the assignment of serial numbers to users.) Send your request for an expanded serial number to licenses@wholetomato.com.
    
3. Obtain a Network Named User (NNU) license, and install a local license server. Users will not require accounts on the EDN, nor will users need access to the internet. Each user can install Visual Assist to three hosts before requesting to licenses@wholetomato.com that a host be deactivated, or count increased. Send your request for an NNU to licenses@wholetomato.com.

Requirement for an account on the Embarcadero Developer Network

In order to register Visual Assist using one serial number for yourself, a different serial number for each developer, or one shared serial number for all developers, each user must have an account on the Embarcadero Developer Network (EDN). (Whole Tomato Software and Embarcadero are both Idera, Inc. companies).

In order to register Visual Assist using a license file, you do not need an account on the EDN. You need an account only to access the license portal.

In order to install a local license server, an account on the EDN will be created for the license administrator.

Follow these steps if you need an account on the EDN:

1. If the PC with Visual Assist has internet access, if the Visual Assist Registration Dialog is not open, open it (Alt+X, H, E). Then, click "Create account" in the dialog to visit the create-an-account page at IDERA. (IDERA is also an Idera, Inc. company.)
   
   

2. If the PC with Visual Assist does not have internet access, create an account on a PC with access by visiting:
   https://www.wholetomato.com/account
   
   

3. Click the "Create account" link and follow the instructions. In the subsequent dialog, if the "CREATE ACCOUNT" button is irresponsive, 1) an EDN account exists with your email address, or 2) an EDN account exists with your Login. If you might have an EDN account, try retrieving its password. If you are certain your email address is not affiliated with an EDN account, try a different username, e.g. your email address.

4. Wait for a verification email from IDERA-Licensing. If the email does not arrive in a timely manner, and the email is not in your spam folder, contact licenses@wholetomato.com to have your account verified manually. After verification, proceed to register.
   
   

5. Click the verification link within the email. If the link fails, contact licenses@wholetomato.com to have your account verified manually. After verification, proceed to register.
   
   

6. Proceed to register.

Register

1. Register with a serial number, with internet access
    
2. Register with a serial number, without internet access
    
3. Register with a license file (.slip or reg.txt)

Register with a serial number, with internet access

1. If you do not have an account on the EDN, return to "Requirement for an account on the Embarcadero Developer Network".

2. If you created an account on the EDN but did not receive a verification email in a timely manner, and the email is not in your spam folder, contact licenses@wholetomato.com to have your account verified manually. Wait for verification before continuing.

3. Start Visual Studio.

4. If the Visual Assist Trial dialog appears, press the Register button. If the dialog does not appear, open it via VAssistX | Help | Register.
   
   

5. Enter your serial number.

6. Enter the name or email, and password, associated with your EDN account.

7. Click Register. If product registration fails with an SR-2 error, proceed to Error Codes to determine your next step.
   
   

8. Restart Visual Studio. If Visual Assist loads successfully, enjoy the software. If the registration dialog reappears, contact licenses@wholetomato.com for assistance.

Register with a serial number, without internet access

1. If you do not have an account on the EDN, return to "Requirement for an account on the Embarcadero Developer Network".

2. If you created an account on the EDN but did not receive a verification link, look in your spam folder or contact licenses@wholetomato.com to verify your account before continuing.

3. Start Visual Studio.
    

4. If the Visual Assist Trial dialog appears, press the Register button. If the dialog does not appear, open it via VAssistX | Help | Register.
   
   

5. Enter your serial number.

6. Click "Use web registration if you have trouble connecting" near the bottom of the dialog.
   
   

7. Click "Copy URL". (The URL will contain your serial number and PC-specific registration code.) 
   
   

8. Close the dialog.

9. Transfer the URL to a PC with internet access.

10. On the PC with internet access, open the URL.

11. Login to the Embarcadero Developer Network.
    
    
    
    Once logged in, the serial number passed via URL will be associated automatically with your EDN account.
    
    

12. Obtain a copy of your license (activation) file via download or email.
    
    

13. Transfer the license file to the PC with Visual Assist, i.e. the PC on which you clicked "Copy URL". Do not rename the file. (The license file will not work on any other PC because the file contains a PC-specific registration code.) 

14. Proceed to Register with a license file.

Register with a license file (.slip or reg*.txt)

1. Transfer the license file to a directory accessible to your development environment(s). Do not rename the file. If the license file is for multiple users, transfer it to a shared directory understanding that the file can be used by only its licensed number of users. (The license file will not work for additional users.)

2. Start Visual Studio.

3. If the Visual Assist Trial dialog appears, press the Register button. If the dialog does not appear, execute VAssistX | Help | Register.
   
   

4. Disregard the serial number that accompanied, or is contained within, your license file. (Do not copy the number into the Visual Assist Registration dialog.)

5. Click "Import license file".
   
   

6. In the Visual Assist License Importer dialog, navigate to your license file (.slip or reg*.txt).
   
   

7. Click Import. If product registration fails with code SR-2, proceed to Error codes to determine your next step.
   
   
   
   If any other error occurs, get assistance by sending your license file and request to licenses@wholetomato.com. 

8. Restart Visual Studio. If Visual Assist loads successfully, enjoy the software. If the registration dialog reappears and you renamed the file, restore the original name and then repeat the import. If the registration dialog reappears, contact licenses@wholetomato.com for assistance. If Visual Studio is responsive but Visual Assist is not, and one thread is 100% busy, move the *.txt files out of your home directory (%USERPROFILE%) and restart Visual Studio.

Trouble connecting, with internet access

1. Proceed only if the Visual Assist Registration dialog is open, and the dialog contains your serial number.
   
   
2. Click "Use web registration if you have trouble connecting" near the bottom of the dialog.
   
   
    
3. Click "Yes" to launch your web browser. (The URL will contain your serial number and PC-specific registration code.)
   
   
    
4. Login to the Embarcadero Developer Network.
   
   
   
   Once logged in, the serial number passed via URL will be associated automatically with your EDN account.
   
   
    
5. Obtain a copy of your registration (activation) file via download or email.
   
   
   
   If you obtain a copy via email, it will be sent from Embarcadero-licensing, activation@embarcadero.com.
    
6. Proceed to Register with a license file.

Error codes

If an error appears during the registration, the error's code and message determine the corrective action.

Code	Message	Action
SR-2	suggests your EDN account has not been verified.	Check your inbox or spam folder for a verification email. If you find the email, return to instructions to verify your account. If you cannot find a verification email, send a request to licenses@wholetomato.com to have your account verified manually. After verification of your account, revisit the registration dialog in Visual Assist.
SR-2	contains 'connect', 'ssl' or 'certificate'.	Proceed to "Trouble connecting, with internet access".
SR-2	suggests host not found.	Proceed to "Register a serial number, without internet access".
SR-2	explains that your serial number is registered to a different user.	1) Locate your own serial number, 2) Contact licenses@wholetomato.com to determine the current user of your serial number, and if no longer used, have it transferred to your EDN account, or 3) Purchase a new license.
SR-2	suggests you try a different registration method.	Exit Visual Studio, delete the following directory, and retry registration: %APPDATA%\Roaming\Embarcadero Note: If you have other Idera products that use the Embarcadero licensing system, those products will be affected by the deletion of the directory.
SR-2	is blank.	Contact licenses@wholetomato.com for assistance. (For internal use: ref 137727.)
SR-4	suggests product license error.	Exit Visual Studio, delete the following directory, and retry registration: %APPDATA%\Roaming\Embarcadero Note: If you have other Idera products that use the Embarcadero licensing system, those products will be affected by the deletion of the directory.
IL-4 (not visible in builds 2331 and older)	suggests license file is invalid.	Revisit the source of your license file. Ensure original is identical to imported. If you have a serial number, proceed to "Register a serial number, without internet access". Do not create a license file manually, e.g. by embedding a legacy activation key into it. Contact licenses@wholetomato.com if you still have trouble. (For internal use: ref 139937.)
IL-5	import failed, and your development environment is behind a firewall that 1) blocks external connections, or 2) has a proxy that requires authentication.	Contact licenses@wholetomato.com for your licensing options. (For internal use: ref 138160.)
IL-5	import failed.	Contact licenses@wholetomato.com for licensing support. (For internal use: check registration history.)
IL-6	you are not qualified for current build.	Revert to a previous build or renew software maintenance.

If your code is not in the table, send a screenshot of the error dialog to licenses@wholetomato.com and request assistance.

Reset Registration

Reset registration to it initial state, perhaps to register by a different method, by exiting Visual Studio and deleting the following directory:

c:\users\<user>\AppData\Roaming\Embarcadero