In RayPack, there is a dedicated interface for managing IIS web directory properties. It is displayed whenever users try to manipulate the web directory property of another IIS data object. Information stored for web directories can be reviewed directly via accessing the RPIIsWebDirProperties table.
The Web Directory Properties Overview
The IIS web directory property manager is launched with an initial list view of already existing web directory objects. Above the list, there is a button NEW, which allows to define the properties of a new web directory property object within another dialog window.
The list view also offers a context menu for each existing web application, which is displayed whenever a user performs a right-click on one of the web application objects. The context menu allows to trigger the edit and remove procedures for web application objects.
|
Be aware: There may be issues with the edition of RPP projects, which have originally been created with prior RayPack versions. These issues are an outcome of required changes to the database table schema for IIS management. Please refer to the section about custom installer database tables for further details. |
To Add a New Web Directory Property Object
To trigger the dialog for adding web directories, users have to click on the NEW button displayed within the web directory properties overview. From the options menu, Web Directory Property has to be clicked. The displayed dialog is separated into several tabs to provide a structured approach to the complex data object.
At any time and from any tab, users may use the OK button to save the new object and return to the updated web directory properties overview. Clicking the Cancel button discards the object creation.
Tab: AUTHENTICATION
RPUser
Accessing system parts in the name of an explicit user identity usually requires credentials. These have to be given in the form of a user object. To select or create a user object, click on the browse button [...] at the right-hand side of the user input field. The Select User dialog is displayed. Please refer to the Common dialogs section for further details on how to manage user data objects.
|
Be aware: User objects may very likely be used at several places within SQL database, script, and IIS management structures. When the same user item is referred to from different locations, changing the properties of that user item actually takes effect for all related objects. Please double-check the correctness of user profile changes, and make sure all related objects are still valid and operational with the modified set of properties. |
Authentication providers
Comma delimited list, in order of precedence, of Windows authentication providers that IIS will attempt to use: NTLM, Kerberos, Negotiate, and others.
Authorization
Authorization policy to web server (anonymous access, NTLM, etc.)
IIS controlled password
Sets whether IIS should control the password used for the Windows account specified in the AnonymousUser attribute. The defaults state for this checkbox is inactive.
Tab: SSL SETTINGS
Require SSL
An active checkbox indicates that file access requires SSL file permission processing with or without a client certificate. This corresponds to AccessSSL flag for AccessSSLFlags IIS metabase property.
Require 128bit SSL
If this option is set, simple SSL does not suffice to access files since 128-bit SSL is requried.
Tab: OUTPUT CACHING
Cache control custom
Custom HTTP 1.1 cache control directives.
Cache control max. age
Integer value specifying the cache control maximum age value in seconds.
Tab: DOCUMENT
Default doc
The list of default documents to set for this web directory in comma-delimited format.
Http expires
Value to set the HttpExpires attribute to for a Web Dir in the metabase.
Index
Specifies whether IIS searches the directory.
Tab: ERROR PAGES
ASP detailed error
Sets the option for whether to send detailed ASP errors back to the client on script error. Default is inactive.
No custom error
Specifies whether or not IIs will return custom errors for this directory.
Log visits
Sets whether visits to this site should be logged. Default is set to inactive.
To Edit a Web Directory Property Object
When an existing web directory property object has to be edited, users need to define the very same properties they had to define for the initial web directory property object creation itself. Therefore, please refer to the section To add a new web directory property object for further details about these properties.
However, editing a web directory property object means to edit an object that may very well be referenced by several IIS objects at the same time. This means, that changing the unique set of properties of a specific web directory property object may have influence on the settings and behavior of several web sites, web site applications, and web site virtual directories. Therefore, please double-check any change to web directory property object settings and make sure that all referenced objects are still fully functional after the modifications.
To Remove a Web Directory Property Object
The Remove procedure is triggered as outlined above: by a click on any web directory property objects context menu item Remove. Once an item is removed, it is lost from the packaging project.
|
Be aware: If an object has child nodes when it is marked for removal, those child elements are deleted along with their parent. |
Confirm Object Removal
Since an accidental object removal could lead to substantial issues, RayPack displays a Confirm dialog before a web application object is actually removed. Use the REMOVE button within that dialog to confirm the activity. If DO NOT REMOVE or CANCEL are clicked, the object is not deleted and the user returns to the web directory properties manager view without any changes.
The display of the Confirm dialog may manually be abandoned for future remove procedures by activating the "In future do not show this confirmation for delete operations" checkbox and using the REMOVE or DO NOT REMOVE button next. (Using the CANCEL button does not save any changes made to the status of that checkbox.) However, it is not recommended to skip the confirmation step, since it may prevent users from severe data loss.