This documentation is for the old version. Go to the latest Upload Suite docs

Upgrading Minor Versions

From time to time new versions of Image Uploader with new features and bug fixes are released. This topic discusses how to update Image Uploader properly.

The way to upgrade Image Uploader depends on the way in which it is embedded:

Using Image Uploader Embedding Scripts Library

If you just replace and ImageUploader37.jar files you will find out that old version is still used. It happens because the browser caches ActiveX controls and Java applets. It allows avoiding re-downloading them every time the user reloads the page. Therefore, it reduces traffic and increases response time. However, it requires some additional efforts to update Image Uploader.

In a common way, you should update Image Uploader-related files, set new version numbers as values of the corresponded properties, and update Image Uploader on the client side.

It works in the following way:

  1. The browser stores the version of Image Uploader when it is installed for the first time.
  2. When the page is reloaded, the browser compares the version of installed Image Uploader with the version specified on this page.
  3. If the version specified in the page is higher than the version of the installed Image Uploader, the browser automatically downloads the new version. Otherwise, it uses the version from the browser cache.

Let us see how to update ActiveX and Java version using iuembed.js.


To update ActiveX version of Image Uploader:

  1. Copy new to the server instead of the old one.
  2. Insert new version number to the activeXControlVersion property of the ImageUploaderWriter.

To get a version number of ActiveX control, you can:

  1. Unpack You can do it in the same manner as you unpack common ZIP or RAR archives.
  2. Click the OCX file from with a right mouse button.
  3. Select Properties menu item.
  4. Click the Version tab.

Also, the version number is specified on the Image Uploader SDK download page.


Numbers inside the version string should be separated with comma. For example, 6,0,10,0.

Here is an example of the activeXControlVersion usage:

<script language="javascript">
var iu = new ImageUploaderWriter("ImageUploader1", 610, 500);

iu.activeXControlEnabled = true;
iu.activeXControlCodeBase = "";
iu.activeXControlVersion = "6,0,10,0";



To update Java version of Image Uploader

  1. Copy new ImageUploader37.jar to the server instead of the old one.
  2. Insert the new version number to the javaAppletVersion property of the ImageUploaderWriter.

Additionally, there is a javaAppletCached property which specifies whether Java applet caching feature is enabled. If it is false, the applet is always re-downloaded from the server regardless to the version number.


The applet caching may be disabled by the user. So if you set the javaAppletCached to true, and the caching still does not work, make sure the Enable Caching checkbox is not cleared in the Java control panel (see screenshots in the Updating Image Uploader on the Client Side topic).

This code snippet demonstrates how to use these properties properly:

<script language="javascript">
var iu = new ImageUploaderWriter("ImageUploader", 610, 500);



Using Image Uploader ASP.NET Control

If Image Uploader is embedded using the ASP.NET control, all what you need to update Image Uploader is copying new Aurigma.ImageUploader.dll to the server instead of the old one.

Using Image Uploader PHP Library

By analogy with Image Uploader ASP.NET control, to update Image Uploader embedded PHP library just replace the ImageUploaderPHP with a new one.

See Also