6Dynamic List server-side installation instructions(38) Modified:
•Install Dynamic List on your own web serverDynamic 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.
•Unzip the web application files into a new directoryCreate 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 applicationStart 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" subdirectoryUsing 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 startedIn 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.
•Determine a safe location for your databaseThe 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 directoryYour 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.
•connDbMain.ConnectionStringModify 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.FromDefaultSpecify the e-mail address that will appear in the from field of automated e-mail messages generated by your web site.
•EmailMessages.SiteAdministratorSpecify 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.NewUserNotificationSpecify 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.SmtpServerLeave this parameter blank. Can be used to define an alternative SMTP server, other than the Default SMTP Virtual Server.
•Visit the web application home pageUsing 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 accountUsing 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.
•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 receivedCheck 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.