Updating ACEweb

These are instructions for updating ACEweb. Before updating, you will need to know the version you are currently running, the database type, and web connector.

Path/Database Type/Web Connector

• Path - the default install path for ACEweb is c:\inetpub. If you installed ACEweb in a different location, you will need to adjust the instruction paths accordingly.
• Database Type - if you are running the default database type, the executable is named aw3.exe; if you are running the SQL or Postgres database type, the executable is named aw4.exe. If you are running the SQL or Postgress database type, you will need to adjust the instruction exe name accordingly.
• Web Connection Handler - if you are running the ISAPI Handler or an earlier version of ACEweb(3.5.076/4.0.076 or earlier), you will need to manually apply the update files.
• Web Connection Version - if you are running a 7.x version, you will need updated DLLs. Replacing DLLs requires stopping IIS.

Find your ACEweb Information

The ACEweb About page will tell you the Web Connector and ACEweb version you are running.

• Executable - check this attribute to determine which database type you are running (i.e. aw3.exe is the default database type; aw4.exe uses SQL or Postgres database).
• Version - this attribute states the ACEweb version you are running.
• Web Connection - this attribute states the web connector you are running (.NET or ISAPI Handler).
• Web Connection Version - the Web Connection attribute also states the handler version you are currently running. E.g. Web Connection Handler 8.1.2 in the above image example.

One-time Setup

If your ACEweb server is already set up for easy updates, you can skip to the next step. Otherwise, complete this one-time setup.

1. In your web.config file in the inetpub\wwwroot\wconnect folder, verify that the UpdateFile key points to the correct path/file:

<add key="UpdateFile" value="C:\inetpub\aceweb\updates\aw3.exe" />

Executable

Don't forget, if you are running the SQL or Postgres database type, you will need to change the exe name in the add key value to aw4.exe (instead of aw3.exe).

Copy Files to Updates Folder

1. Download the update zip to your ACEweb server's desktop:

• aw3.zip for the default database type.
• aw4.zip for the SQL or Postgres database type.

2. Unblock the zip file if necessary.

1. Right-click the zip file.
2. Choose Properties from the menu.
3. Check the Unblock box.
4. Click the OK button.

3. Open File Explorer and navigate to the \inetpub\Aceweb\updates\ folder.
4. Go to the desktop and open the zip file. You should have 2 File Explorer windows open now. E.g.:

5. If the zipped files already exist in \inetpub\Aceweb\updates\, back up the installed version first. This lets you roll back the changes if needed.

1. Get the installed version of aw3.exe by right-clicking the \inetpub\Aceweb\Updates\aw3.exe file, choosing Properties, then the Details tab.
2. Create a new folder named for that version number in the \updates\ folder (e.g. updates\3.251.0\).
3. Move the existing aw3.exe, aw3.tlb, awfiles.dbf, and awfiles.fpt from the \updates\ folder into the new folder (created in step b).

No Previous Updates

If this is the first time you have used these instructions to update ACEweb, you may not have any previous versions in the \updates\ folder.
To create the current version backup, follow steps a and b above, then make a backup of the aw3.exe and aw3.tlb that are in inetpub\aceweb folder (these are your current version files) and copy them into the updates\[version #] folder.

6. Copy the zip's contents to the \inetpub\Aceweb\updates\ folder.

Update the Exe

How you update the Exe depends on what Web Connection Handler you are using (.NET or ISAPI).

.NET Handler

1. Open the Web Connection Server Maintenance page.

2. In the Module Administration section, click the Web Connection Module Administration link to open the Web Connection Handler Status Page.

3. Scroll down to Version and Updates section of the page.

4. Click the Update Server Exe button. You will see the Exe File Updated message if the update was successful.

ISAPI

1. Open the Web Connection Server Maintenance page.

2. In the Module Administration section, click the Web Connection Module Administration link to open the Web Connection Handler Status Page.

3. Click the Unload Servers link.

4. Copy the aw3.exe and aw3.tlb files (aw4.exe and aw4.tlb if running the SQL/Postgres database) from the \inetpub\Aceweb\updates\ folder into the \inetpub\Aceweb\ folder.

5. Go back to the Web Connection Handler Status Page and click the Load Servers link.

Updating DLLs

If your Web Connection Handler is earlier than 8.1.2 (e.g. 8.0 or earlier), you will need updated DLLs. Updating DLLs requires you to stop IIS first.

1. Stop IIS by opening a Command Prompt window and entering the following at the prompt:

IISRESET /Stop

2. The DLLs are in the wc8.1.2 folder in the \inetpub\Aceweb\updates\ folder. Copy the DLLs to the following locations:

• wc.dll - goes into \inetpub\wconnect\ folder
• webconnectionmodlue.dll - goes into \inetpub\wconnect\bin folder
• wwdotnetbridge.dll - goes into \inetpub\aceweb\ folder
• wwipstuff.dll - goes into \inetpub\aceweb\ folder

3. Restart IIS by entering the following at the Command Prompt window:

IISRESET /Start

Update Other Files using FileManager.awp

The aw3.exe file contains most of the changes made to ACEweb. Occasionally, other system files and template files outside the exe change and need to be applied also.

These files might have small customizations on your site that can be hard to detect and are easily overwritten. To manage them, open the FileManager.awp page. E.g.

http://localhost/wconnect/FileManager.awp e shows information about System Files and Templates, including:

• Which files are missing (if any).
• Files that match the defaults.
• Files that match the previous version of the defaults.
• Files that don't match (these have either been customized, or are more than one version behind).

The File Manager pag

Review Before Updating

Review the Site Notes at the top of the page for any customizations on your site. You can review changes to a file by clicking the diff link to make sure you're not overwriting anything custom.

If you need updated System Files:

1. Click the create all link (if files > 0).
2. Click the update all link (if files > 0).
3. Click the other update all link (if files > 0).

Template Files

Most customization happens in template files, so use caution when updating them. If you're not sure, skip these. Otherwise, updating or creating them works the same as System Files.

Compile Templates

Click the Compile link (at the top of the File Manager page) to open the AWP Compiler page to compile .awp type templates.

Backed Up Files/Templates

When you use the File Manager, updating files makes copies of the overwritten versions in the Aceweb\updates\[previous version]\ folder you created in step 5.b above. So you will also have backups of the updated files/templates.

About aw3.tlb

The .tlb file is the Type Library of the COM server. It might change when the WC version changes, but it doesn't need regular updating otherwise. Keep it with its aw3.exe when you can, but don't worry if the .tlb has an older date than the .exe in the \inetpub\Aceweb\ folder.

Alternate Interfaces

If you have any alternate interfaces, you will see links for them at the top of the File Manager page:

Click the appropriate link to switch to that interface and see if any files need to updated for it.

Quick Pick

If you have the Quick Pick module, you can also use the File Manager apply template update, if necessary.