Follow

How do I migrate AuthAnvil 2FA to another site in IIS?

In order to move AuthAnvil 2FA to a new site, export the applications/virtual directories from one site and import them in another, then update the AAWebConfigEditor to the new domain/port. See this Article for assistance.

Alternatively, backing up the AuthAnvil 2FA server and choosing “New Install and Restore Data” will allow you to select which site to restore the server to.


For IIS 6:

  1. Expand the site that AuthAnvil is currently installed to (usually Default Web Site).
  2. Right-click on the “AuthAnvil” virtual directory, go to “All Tasks” and Save Configuration to a File…
  3. Right-click on the new site where you want to install AuthAnvil, go to “New”, click Virtual Directory (from file)… and select the AuthAnvil virtual directory XML file you just exported.  Click “Read File”, select the “AuthAnvil” configuration, and click OK.
  4. Repeat these steps for the AnvilManager, AuthAnvilAdmin, AuthAnvilSAS, and ManageToken directories.
  5. Open the Web Config Editor (C:\Program Files\Scorpion Software\AuthAnvil\AuthAnvilTools\AAWebConfigEditor.exe)
  6. Update the values for the Admin and SAS URL so they point to the new domain or port configurations.
  7. Test the new configuration using the new address (domain / port).  Once everything is working properly, remove the old AuthAnvil directories on the old site.


 
For IIS 7 (migrating entire IIS site):

  1. Open the command prompt.
  2. Run “cd C:\Windows\System32\inetsrv” to change directory to the IIS files.
  3. Run “appcmd list site \name:OldSiteName \config \xml > FILEPATH\OldSiteName.xml”, replacing OldSiteName with the name of the Site in IIS you are going to migrate, and FILEPATH with a valid folder you can write the XML configuration file to.
  4. Open the created XML file in notepad or WordPad and locate the following lines near the top: <SITE SITE.NAME=“OldSiteName” SITE.ID=”1” bindings=”http/*:80:” state=”Started”>  <site name=“OldSiteName” id=”1” serverAutoStart=”true”>
  5. Update the SITE.NAME= and name= so that “OldSiteName” matches your destination site name
  6. Update the SITE.ID= and id= so they are set to the destination site ID (Right Click on site -> Manage Web Site -> Advanced Settings to view ID number).  If you provide a new ID and Site Name, it will be automatically created when importing to IIS.
  7. Run “appcmd add sites /in < FILEPATH\OldSiteName.xml” to import the site back in to IIS with the new settings.
  8. Open the Web Config Editor (C:\Program Files\Scorpion Software\AuthAnvil\AuthAnvilTools\AAWebConfigEditor.exe)
  9. Update the values for the Admin and SAS URL so they point to the new domain or port configurations.
  10. Test the new configuration using the new address (domain / port).  Once everything is working properly, remove the old AuthAnvil directories on the old site.

Note: Make sure it has a unique port configured or the site will not be able to start. If you are using HTTPS, make sure the new site has the same SSL certificate binding.

 

For IIS 7 (migrating only AuthAnvil directories):

To migrate specifically the AuthAnvil directories, we will need to manually recreate the applications in the new site.  This method takes a bit longer than IIS 6 so the simpler solution is often to backup and restore to another IIS site. 

  1. Expand the site that AuthAnvil 2FA is currently installed to (usually Default Web Site).
  2. Right-click on the “AuthAnvil” virtual directory and go to Manage Application -> Advanced Settings.  Take note of the Virtual Path (alias), Physical Path, and Application Pool.
  3. On the new site, right-click, "Add Application" and set the Alias, Application Pool, and Physical Path to the same values as the other application in the old web site (see Step 2).
  4. Repeat Step 3 for the other applications in the site: AnvilManager, AuthAnvilAdmin, AuthAnvilSAS, and ManageToken.
  5. Inside the AuthAnvil application on the new site, right-click on the “Admin” directory and “Convert to Application”, adding it to the AuthAnvilAdmin Application Pool.
  6. Repeat Step 5 for the other directories, putting ADUS in the AuthAnvilADUS app pool, Manager in the AuthAnvilManager app pool, and SelfService in the AuthAnvilSelfService app pool.
  7. Open the Web Config Editor (C:\Program Files\Scorpion Software\AuthAnvil\AuthAnvilTools\AAWebConfigEditor.exe)
  8. Update the values for the Admin and SAS URL so they point to the new domain or port configurations.
  9. Test the new configuration using the new address (domain / port).  Once everything is working properly, remove the old AuthAnvil directories on the old site.

Note: If you created a new site in IIS that will assume the same domain name as the current AuthAnvil site, make sure it has a unique port configured or the site will not be able to start.  If you are using HTTPS, make sure the new site has the same SSL certificate binding.

Note: Now that you have configured AuthAnvil on a new site, make sure to update all the agents to point to the new URL, whether that includes specifying a different port or changing the domain name.

 

Questions?

If you have any questions or need some help, we would be happy to assist. Open a case at help.scorpionsoft.com or send an email to support@scorpionsoft.com.

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments

Powered by Zendesk