Installation > Installing WordWriter

Installing WordWriter

• Upgrading to a New Version of WordWriter
• Automatic Installation
• Installing WordWriter at the Application Level
• Installing WordWriter in the Global Assembly Cache (GAC)
• Using WordWriter with Windows 2003
• ASP Installation

Upgrading to a New Version of WordWriter

If you are upgrading to a new version of WordWriter before installing the new version, remove the old version.

Automatic Installation

To run the automatic installation, double-click OfficeWriter-3.x.x-Win.exe and follow the instructions. By default, the automatic installation will save WordWriter in the directory C:\Program Files\SoftArtisans\OfficeWriter. You can select a different directory during the installation process.

WordWriter includes the .Net assembly SAWW3NET.dll and SAWW3CCW.dll, a COM callable wrapper (CCW) that allows you to use WordWriter from ASP. The .Net assembly is installed in:

1. The Global Assembly Cache (GAC)
   SAWW3NET.dll must be installed in the GAC to allow the CCW to work. If you do not plan to use WordWriter in ASP, and you do not want to provide global access to the assembly, you can remove SAWW3NET.dll from the GAC.
   
   
2. OfficeWriter\WordWriter\doc-samples\samples\bin
   This is the bin directory for WordWriters samples. If you remove SAWW3NET.dll from the GAC, the WordWriter samples will still run, because they use SAWW3NET.dll in the bin directory.

During the automatic installation process you will be asked to enter the WordWriter license key that you received with your order confirmation. To see all OfficeWriter license keys installed in the registry, or to add or remove a key (for example, when upgrading) run LicenseManager.exe (included with WordWriter).

There is one installer for OfficeWriter. Depending on which license key is entered during installation (or updated later with the license utility), different functionality will be unlocked for WordWriter. For information on the different WordWriter versions, see WordWriter Editions.

If you leave the key field blank during installation you will get WordWriterFree, an evaluation edition of WordWriter. If you enter a key for an evaluation edition, you will get an evaluation edition of WordWriterEE.

When you install WordWriter, you will also be given the option to install ExcelWriter. If your license key is only for WordWriter, and you choose to install ExcelWriter as well, a free limited version of ExcelWriter will be installed. If you ordered an evaluation or full version of the whole OfficeWriter suite, you will receive one OfficeWriter key which will unlock both products.

When you update a license key, IIS must be reset before the new license will take effect.

Installing WordWriter at the Application Level

If you removed the SAWW3NET.dll from the GAC, it will only be available to the WordWriter samples. To make WordWriter available to another ASP.NET application, place the assembly in the bin directory at the top level of the application:

1. At the top level of your application, create a directory called bin.
   
   
2. Copy SAWW3NET.dll from OfficeWriter\WordWriter to your application's bin directory.

Installing WordWriter in the Global Assembly Cache (GAC)

By default, SAWW3NET.dll is installed in the Global Assembly Cache (GAC), and is therefore available to all .NET applications on your machine. If you removed SAWW3NET.dll from the GAC, and would like to reinstall it globally:

1. Open a command prompt window and move to the directory OfficeWriter\WordWriter.
   
   
2. Enter gacutil /i SAWW3NET.dll.
   
   
3. Open the file machine.config (in [Windows directory]\Microsoft.NET\Framework\[.NET version directory]\CONFIG).
   
   
4. Add the following line to the assemblies node of machine.config:
   
   

   <add assembly="SAWW3NET, Version=x.x.x.x, Culture=neutral, 
   		PublicKeyToken=f593502af6ee46ae"/>

   OR

   Create a text file containing the following lines, and save it as web.config. Save web.config at the top level of your application.

   <?xml version="1.0" encoding="utf-8" ?>
   <configuration>
   <system.web>
   <compilation>
   <compilers>
   </compilers>
   <assemblies>
   <add assembly="SAWW3NET, Version=x.x.x.x, Culture=neutral, 
   	PublicKeyToken=f593502af6ee46ae"/> < 
   <add assembly="*" />
   </assemblies>
   </compilation>          
   </system.web>
   </configuration>

Using WordWriter with Windows 2003

To use WordWriter on Windows 2003, you must enable the following Web Service extensions in IIS:

• Active Server Pages
• ASP.NET

To enable these extensions:

1. Open the Internet Information Services (IIS) Manager.
2. Open local computer.
3. Select Web Service Extensions.
4. From the list of Web Service Extensions, select Active Server Pages.
5. Click the Allow button.
6. From the list of Web Service Extensions, select ASP.NET.
7. Click the Allow button.

Copyright 2007 © SoftArtisans, Inc. All Rights Reserved.