Installing SoftArtisans WordWriter

Automatic Installation

To run the automatic installation, double-click WordWriter.exe and follow the instructions. By default, the automatic installation will save WordWriter's assemblies, samples, and documentation in the directory C:\Program Files\SoftArtisans\WordWriter. You can select a different directory during the installation process.

WordWriter includes the two .Net assemblies WordWriter.dll and Collections.dll. WordWriter also provides WordWriterCOM.dll, a COM callable wrapper (CCW) that allows you to use WordWriter from ASP. The .Net assemblies are installed in:

1. The Global Assembly Cache (GAC)
   The assemblies must be installed in the GAC to allow the CCW to work. If you do not plan to use WordWriter in ASP, you can remove the assemblies from the GAC.



2. WordWriter\doc-samples\bin
   This is the bin directory for WordWriters samples. If you remove the assemblies from the GAC, the WordWriter samples will still run, because they use the assemblies in the bin directory.

Installing WordWriter at the Application Level

If you removed the WordWriter assemblies from the GAC, the assemblies will only be available to the WordWriter samples. To make WordWriter available to another application, include a directory called bin at the application's top level, and save copies of the assembly files in this directory:

1. At the top level of your application, create a directory called bin.
   
   
2. Copy WordWriter.dll and Collections.dll from WordWriter\doc-samples\bin to your application's bin directory.

Installing WordWriter in the Global Assembly Cache (GAC)

By default, WordWriter's assemblies are installed in the Global Assembly Cache (GAC), and are therefore available to all .NET applications on your machine. If you remove the assemblies from the GAC, and would like to reinstall them globally:

1. Open a command prompt window and move to the directory WordWriter\doc-samples\bin.
   
   
2. Enter gacutil /i WordWriter.dll.



3. Enter gacutil /i Collections.dll.



4. Open the file machine.config (in C:\WINNT\Microsoft.NET\Framework\Vx.x.xxxx\CONFIG).



5. Add the following line to the assemblies node of machine.config:
   
   

   <add assembly="WordWriter, Version=x.x.x.x, Culture=neutral, PublicKeyToken=d7b935349d058188"/>

   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="WordWriter, Version=x.x.x.x, Culture=neutral, PublicKeyToken=d7b935349d058188"/>
   <add assembly="*" />
   </assemblies>
   </compilation>          
   </system.web>
   </configuration>

Top

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.

Top

Copyright © 2003, SoftArtisans, Inc.