How to Install a Hotfix
Description
Instructions for installing a hotfix.
What is a Hotfix?
A hotfix is a custom patch for Alpha Anywhere. Hotfixes are issued on a case-by-case basis to address issues found in Alpha Anywhere. If you have been provided a hotfix by Alpha Software, it can be installed using the A5Hotfix.exe executable found in the installation directory for Alpha Anywhere.
How to Install a Hotfix
Stop all running instances of Alpha Anywhere:
Stopping the Developer Edition or Classic Application Server
If you are installing a hotfix for the Alpha Anywhere Developer Edition or the Alpha Anywhere Classic Application Server, stop all running instances of Alpha Anywhere. This includes any instance of Alpha5.exe or A5ApplicationServer.exe. You may need to use Windows Task Manager to confirm the process has stopped.
Stopping the Application Server for IIS
If you are installing a hotfix for the Alpha Anywhere Application Server for IIS, stop any application pools that are running.
Open Windows Explorer and navigate to the [program folder]. The [program folder] is the directory that the Alpha Anywhere executable was installed and is typically found in the following location:
- Alpha Anywhere Product
- [program folder]
- Alpha Anywhere Developer Edition
C:\Program Files (x86)\a5V12
- Alpha Anywhere Classic Application Server
C:\Program Files (x86)\a5V12 ApplicationServer
- Alpha Anywhere Application Server for IIS
C:\Program Files (x86)\A5V12 Application Server for IIS
If you did not install Alpha Anywhere in the default installation directory, the [program folder] will be the directory on your system that contains the executable for Alpha Anywhere. For the Alpha Anywhere Developer edition, this is the directory that contains the alpha5.exe executable. For the Alpha Anywhere Classic Application Server, it is the directory containing A5ApplicationServer.exe. For the Alpha Anywhere Application Server for IIS, it is the directory containing A5IISInstallServer.exe.Create a new sub-folder under the [program folder] called hotfix. If the hotfix folder already exists, delete any files in the folder.
Unzip or copy all hotfix files into the hotfix folder.
Multiple hotfixes can be installed at the same time unless otherwise noted.Install the hotfix. In Windows Explorer, locate the A5Hotfix.exe executable file in the [program folder]. Right-click A5Hotfix.exe to bring up the context menu and select Run as administrator to install the hotfix.
Do not double-click A5Hotfix.exe to install a hotfix.Verify the hotfix has been applied. Open the [program folder] and find the file System.aex. The timestamp on the file should be the current time after the hotfix is installed.
Restart Alpha Anywhere.
Installing a5hotfix.exe if it is Missing
The a5hotfix.exe file is installed with the full install of Alpha Anywhere. If you cannot find the executable on your system, you can download it directly here
How to Apply a Hotfix to a Remote Server (including Alpha Cloud)
If the Application Server is running on Alpha Cloud or a remote ISP, you may not have access to the physical machine. Without access to the machine, you cannot use the steps described above to apply a hotfix to the Application Server.
In this situation, the hotfix must added to and published with your web project in order to apply the hotfix to the server.
Add the hotfix file(s) to your web project. To do this, click the folder icon on the Web Projects Control Panel to open the project folder in Windows Explorer. Add the hotfix file into the folder.
Next, go to Web Project Control Panel > Project Properties. In the Project Properties dialog, add the hotfix file (e.g. hotfix1.aex) to the list of AEX files.
If you are applying the hotfix on a server running the Standalone Application Server, create an .a5w page with the code below. If you have the security framework turned on, be sure to set the permission on this page to "Always allowed".
If you are applying the hotfix on IIS or Alpha Cloud, you do not need to create an .a5w page.
<%a5 Server.ClearAEXCache() ?"AEX cache has been cleared" %>
Republish your application.
If you created an .a5w page, call the .a5w page you created (open it in a web browser). This is only needed if the hotfix is being applied to the Standalone Application Server.
The hotfix should now be active for this web project. If you have other web projects you will need to apply the hotfix to those projects.
Videos
For more information on how to apply a hotfix, please watch this video: