My Home   |   Read   |   Edit   |   Export   | |   New User   |   Login     
Read
  • 6 Dynamic List server-side installation instructions (38)
    Modified:
    Created:
    • Install Dynamic List on your own web server   Dynamic List allows multiple users to create and store outlines and lists on a web server. This is the first fully-functional application to use a web browser for editing outlines.
    • 6 System requirements (10) Verify that your computer system meets the minimum requirements for running Dynamic List.
      • 6 Windows NT/2000/XP with IIS version 5 or greater (3)
        • Web server   Used to host the ASP.NET web application.
        • SMTP server   Required by the application for sending automated e-mail messages.
        • Administrative permissions   Security level required for installing a new web application.
      • Microsoft .NET Framework »   Please ensure that you have a recent version of the .NET Framework.
      • A valid e-mail address   Used for administrative correspondence between you and your users. Also used for receiving some automated notifications generated by the application.
      • 4 MS Access database drivers (usually included with MS Windows OS) (2) There are two components to these drivers, the MDAC and the Jet (MS Access) drivers. These are usually included with your MS Windows operating system.
        • MDAC »   The Micrsoft Data Access Components allow application to use databases. This is usually included with your MS Windows operating system.
        • Jet version 4.0 or greater »   Jet is included in MDAC 2.5 and earlier. It is usually included with your MS Windows operating system.
      • Disk space   Several MB of space will be required by the application and the database.
    • 6 Installation process (19) Carefully follow these steps in order to get Dynamic List running on your web server.
      • 4 Install the web application (4)
        • Unzip the web application files into a new directory   Create a new directory for your web application under the defaut web site(usually located at C:\Inetpub\wwwroot\). Some suggested names for your new web application directory are dl or dynamiclist.
        • Create a new IIS Virtual Directory for your web application   Start the Windows administrative tool called the Internet Information Services console. Using the console, create a new Virtual Directory under the Default Web Site. Suggestion: use dl or dynamiclist as the alias. Point the virtual directory to the directory that contains your unzipped application files. Enable the access permissions Read and Run scripts for this virtual directory.
        • Disable anonymous access to the "administration" subdirectory   Using the Internet Information Services console, display the properties for the administration application subdirectory. Select the Directory Security tab, and press the Edit button. Disable anonymous access to this directory.

          Security note: Examine the authentication access for this directory to ensure that the chosen authentication method is suitable for your network. The default method, Integrated Windows authentication, is a good choice for most installations.
        • Ensure the IIS services are started   In the Internet Information Services console, verify that the Default Web Site and Default SMTP Virtual Server are both started.

          Security note: Be aware that your SMTP Virtual Server can be abused by users or robot applications accessing your computer over the network. For example, someone initiating an e-mail spam campaign could use your computer to send their messages. Verify that your network security configuration does not expose you to such risks. For more information, see the Access tab of the Properties form for the Default SMTP Virtual Server. Check the Relay restrictions settings.
      • 4 Install the database (2)
        • Determine a safe location for your database   The directory where you unzipped the application files should include a subdirectory named setup. In there you'll find an MS Access database named dynamiclist.mdb. For security reasons, it's advisable to store the database where it cannot be accessed by web users.

          For example, create a new directory named C:\Inetpub\databases\, and move the database file dynamiclist.mdb into this new directory.
        • Enable file permissions on the database directory   Your web application requires read/write permission on the directory where you've stored the database.

          Using the Windows Explorer, display the Properties page for this directory. Select the Security tab. Click on Add..., then Advanced..., and then Find Now. Select the user named IUSR_computername, and press OK twice. You should now be back at the Security tab. Enable Full Control for the user IUSR_computername, and press OK.

          Configuration note: On computers with the original release of the .NET Framework, select the user ASPNET rather than IUSR_computername.
      • 4 Set the configuration parameters (7)
        • Install the Web.config file   Move the configuration file Web.config from the setup subdirectory down one level to the root directory for your web application.
        • 6 Modify the application parameters in Web.config (5) Open this file using Notepad or some other text editor. Scroll to the bottom on the file.

          Find the section named <appSettings>. Modify the following parameters as described below.
          • connDbMain.ConnectionString   Modify the value for the "Data Source=" portion of the database connection string. Provide the full path and file name of the dynamiclist.mdb file you've installed. For example, use C:\Inetpub\databases\dynamiclist.mdb if this is where you've installed your MS Access database.
          • EmailMessages.FromDefault   Specify the e-mail address that will appear in the from field of automated e-mail messages generated by your web site.
          • EmailMessages.SiteAdministrator   Specify the e-mail address of the web site administrator for your installation. The address will be embedded in automated e-mail messages sent to users of your web application.
          • EmailMessages.NewUserNotification   Specify what e-mail address to use for receiving new-user notifications. The message sent to this address is small enough to be received on devices that support SMS text messaging.
          • EmailMessages.SmtpServer   Leave this parameter blank. Can be used to define an alternative SMTP server, other than the Default SMTP Virtual Server.
      • 4 Test the web application (2)
        • Visit the web application home page   Using IE or another web browser, visit the web application you've installed on your web server. For example: http://localhost/dynamiclist/

          Ensure that the application home page is displayed. Error conditions should be obvious.
        • Create a new user account   Using the web application, create a new user account.

          During this process the database will be modified and an e-mail message will be sent. Should either of these actions fail, you probably have a system configuration error that needs to be diagnosed. Carefully verify the installation and configuration steps that you followed. Consult the next section for help in diagnosing configuration problems.
    • 4 Fixing common configuration problems (5) How to diagnose and repair incorrect system configuration settings.
      • 6 Error message: Server Error in '/' Application (2) Examine the detailed error message that appears on this web page. Here are explanations for a few common error messages.
        • Parser Error Message: Could not load type 'DynamicList.Default'.   Ensure that a Web.config file exists in your application directory, and that the settings in this file have been adjusted for your particular server installation.
        • Parser Error Message: It is an error to use a section registered as allowDefinition='MachineToApplication' beyond application level. This error can be caused by a virtual directory not being configured as an application in IIS.   Using the Internet Information Services console, create a new Virtual Directory under the Default Web Site. Suggestion: use dl or dynamiclist as the alias. Point the virtual directory to the directory containing your application files.
      • Error message: The Microsoft Jet database engine cannot open the file 'C:\Inetpub\databases\dynamiclist.mdb'. It is already opened exclusively by another user, or you need permission to view its data.   First, ensure that you've specified the correct location of your MS Access database in the Web.config file.

        Second, ensure that the following file permissions are enabled for the Windows user IUSR_computername on the directory containing your dynamiclist.mdb database: read, write, modify.
      • Automated e-mail messages generated by the application are never received   Check the directory containing outgoing e-mail messages for your Default SMTP Virtual Server. By default, outgoing messages are stored in C:\Inetpub\mailroot\Queue\. If the outgoing mail directory contains files, then your SMTP server is unable to relay them. Check your SMTP configuration.

        Tip: A web page exists for generating test e-mail messages. It's located in the administration subdirectory, at administration/email_test.aspx.