Installing dox42 Server on a Windows Server

You can install dox42 Server on a Windows Server or a Windows Server on Azure. The following steps describe the installation on Windows Server.

Steps

1. Copy the directory dox42ServerPack\dox42ServerVXXXX\dox42Server to a different physical path, e.g. C:\dox42Server.

2. Set up a site in the IIS Manager (inetmgr):

   1. Start the IIS Manager.

   2. In the Connections pane, right-click the Sites node in the tree view, and then select Add Website.
      The Add Website dialog opens.

   3. Enter dox42Server in the Site name text field.

   4. If you want to select a different application pool than the one listed in the Application pool box: In the Select Application Pool dialog box, select dox42Server from the Application pool list, and then select OK.

   5. In the Physical path box, enter the physical path of the chosen folder in step 1, or select the browse button (...) to browse the file system to find the folder.

   6. Select the protocol for the site from the Type list.

   7. The default value in the IP address box is All Unassigned. If you must specify a static IP address for the website, enter the IP address in the IP address box.

   8. Enter 4242 in the Port text field.

      Note

      You may use any other port, but bear in mind that the standard port (80) is often already in use by other applications, e.g. SharePoint.

   9. If you do not have to make any changes to the site, and you want the website to be immediately available, select the Start Website immediately checkbox.

   10. Select the OK button.

       

3. Copy your Aspose.Total.Lic file to the bin folder in your dox42Server folder.

   Important

   This step is not applicable for trial installations.

4. Install the NET 4.5.2 framework.

5. Use Server Manager to activate ASP.NET (inclusive HTTP activation).

6. If you want to enable access to SharePoint Online (Office 365) for your dox42 Server, install the Microsoft SharePoint Server 2013 Client Components SDK.

7. Run iisreset.

8. Configure the dox42 Server application pool as follows:

   

   1. In the Identity text field, you can use Service-User instead of ApplicationPoolIdentity.

   2. In case you want to generate a dox42 sample template which occasionally uses Microsoft Access (32-Bit needed), you might to set the Enable 32-Bit applications list to True.

   3. Select the OK button.

9. In IIS Manager, right-select your site in the Sites node in the tree view, and then select IIS Manager permissions.

10. Look for the user entry IIS AppPool\dox42Server or a dox42 Service account.

    Note

    Use the local computer as search path.

11. Give this user read and write permissions to C:\dox42Server.

12. Configure web.config (key, license-dir, mail server) and NLog.config (log-dir) files.

13. Activate the port on your firewall:

    

14. Try to reach your dox42 web service via browser: http://localhost:4242/dox42Service.asmx

    

15. Test generating a document with the dox42 Service Designer.

    Note

    The dox42 Service Designer can be used for the easy configuration of your dox42 web service calls. Please watch the #dox42class Video Tutorial for more information on how to use it.

    1. Install dox42 Service Designer and open it. You can find it at C:\dox42ServerPackVXXX\dox42ServiceDesigner_*.

    2. Open the HelloWorld_ServiceDesigner.config file from C:\dox42Server\templates\HelloWorldTest.

    3. Select Call Service to test your dox42 Service document generation.

16. Use adequate access control to protect your dox42 service against unauthorized use.

Result

You have installed the dox42 Server.