SoftArtisans ImgWriter Guide

Installing ImgWriter

Removing Evaluation Software
Upgrading from Another Version
Automatic Installation
Manual Installation

Removing Evaluation Software

If you installed an evaluation version of SoftArtisans ImgWriter, remove it before installing the retail version. To remove the evaluation version:

Open the Control Panel and select Add/Remove Programs.
From the programs list, select SoftArtisans ImgWriter Vxxx Eval (xxx represents the version number), and click Remove.

ImgWriter files that you modified will be left intact. For example, if you modified a sample ImgWriter script, the file will not be deleted.

Upgrading from Another Version

Before upgrading to a new version of ImgWriter, you must remove the old version. If you ran the automatic installation to install the older version, use Add/Remove Programs to remove ImgWriter:

Open the Control Panel and select Add/Remove Programs.
From the programs list, select SoftArtisans ImgWriter Vxxx (xxx represents the version number), and click Remove.

ImgWriter files that you modified will be left intact. For example, if you modified a sample ImgWriter script, the file will not be deleted.

If you installed ImgWriter manually, unregister the ImgWriter dll files as follows:

Open a Command Prompt window.
To stop the Web server, enter
net stop iisadmin /y

To unregister SAImageGen.dll, enter,
regsvr32 path\SAImageGen.dll /u

To unregister SAImageCollection.dll, enter,
regsvr32 path\SAImageCollection.dll /u

To restart the web server, enter,
net start w3svc

Optional: If you want to restart FTP and SMTP services, use the following commands.
net start msftpsvc
net start smtpsvc

Automatic Installation

Double-click ImgWriter.exe, and follow the InstallShield Wizard instructions. Automatic installation will,

Unpack ImgWriter files to c:\program files\softartisans\ImgWriter, or a location you selected during installation
Register saimagegen.dll and saimagecollection.dll
Create two virtual directories, ImgWriter, containing documentation, and ImgWriterSamples, containing advanced samples.

Manual Installation

To manually install ImgWriter, you must first run the automatic installation (described above) to unpack the files. Once the files are unpacked, if you move ImgWriter to a new server, you can run either the automatic or manual installation.

Copy saimagegen.dll and saimagecollection.dll to any stable directory on your web server. For example, to copy saimagegen.dll and saimagecollection.dll to c:\winnt\system32\inetsrv, at the command prompt, type,

copy saimagegen.dll c:\winnt\system32\inetsrv

and

copy saimagecollection.dll c:\winnt\system32\inetsrv
Manually register the dll files, as follows.
1. Open a Command Prompt window.
2. To stop the web server enter,
  net stop iisadmin /y
3. To register SAImageGen.dll, enter,
  regsvr32 path\SAImageGen.dll
4. To register SAImageCollection.dll, enter,
  regsvr32 path\SAImageCollection.dll
5. To restart the web server, enter,
  net start w3svc
6. Optional: If you want to restart FTP and SMTP services, use the following commands.
  net start msftpsvc
  net start smtpsvc
Create a virtual directory called ImgWriter, and map it to the doc-samples directory, as follows.
1. Open the Internet Services Manager.
2. Right-click Default Web Site.
3. Select New -> Virtual Directory. The Virtual Directory Creation Wizard will open.
4. Click Next.
5. Enter ImgWriter as the alias for your virtual directory, and click Next. Note: You may use a different alias, but you will need to change the contents of the global.asa file. To do this, Open doc-samples\global.asa, and change
```
		Application("vroot") = "/ImgWriter/"
		
```
  to,
```
		Application("vroot") = "/YourAlias/"
		
```
6. Browse to ImgWriter's doc-samples directory and click Next. Unless you selected a different directory during installation, you will find doc-samples in C:\Program Files\SoftArtisans\ImgWriter.
7. Check Read, Run, and Browse, and click next.
8. Click Finish.