Chapter 10   Working With Configuration Styles


Configuration styles are an easy way to apply a set of options to specific files or directories that your server maintains. For example, you can create a configuration style that sets up access logging. When you apply that configuration style to the files and directories that you want to log, you don't have to individually configure access logging for all the files and directories.

This chapter includes the following sections:

• Creating a Configuration Style

• Removing a Configuration Style

• Editing a Configuration Style

• Assigning a Configuration Style

• Listing Configuration Style Assignments

Creating a Configuration Style

---

To create a configuration style, perform the following steps:

1. Access the Administration Server and click the Servers tab.

2. In the Manage Servers area, select the desired server and click Manage.

   iPlanet Web Server displays the Server Manager Preferences page, as shown in Figure 1-1.

3. Choose the Styles tab.

4. Click the New Style link.

5. Type the name you want to give the configuration style. Click OK.

   iPlanet Web Server displays the Edit a Style page.

6. From the drop-down list, choose a configuration style to edit and click Edit this Style.

7. From the list of links available, click the category you want to configure for your style.

   You can configure the information listed in Table 10-1.

8. Fill out the form that appears, and click OK.

9. Repeat step 4 and step 5 to make any other configuration changes to the configuration style. Click OK.

10. Click Save and Apply to confirm your changes to the configuration style.

When you choose a style to edit, your Resource Picker lists configuration styles instead of other resources. After you have finished editing a style, click OK and Save and Apply. The Resource Picker exits the styles mode. You can also choose to exit the styles mode by choosing Exit styles mode from the Resource Picker.

Table 10-1 Configuration Style Categories 

Category	Description
CGI file type	Allows you to activate CGI as a file type. For more information about CGIs, see Installing CGI Programs.
Character Set	Allows you to change the character set for a resource. For more information about character sets, see To use the Server Manager for the hardware virtual servers that are uses with ISPs, see the section Setting Up Hardware Virtual Servers for ISPs.Changing the Character Set.
Default Query Handler	Allows you to set a default query handler for a server resource. For more information about query handling, see Using the Query Handler.
Document Footer	Allows you to add a document footer to a server resource.
Dynamic Configuration	Allows you to give people a subset of configuration options without giving them access to the Server Manager. For more information about dynamic configuration, see Working with Dynamic Configuration Files.
Error Responses	Allows you to customize the error responses that clients see when they encounter an error from your server. For more information about error responses, see Customizing Error Responses.
Log preferences	Allows you to set preferences for access logs. For more information about log preferences, see Setting Log Preferences.
Restrict Access	Allows you to restrict access to the entire server or parts of it. For more information about access control, see Controlling Access to Your Server
Server Parsed HTML	Allows you to specify whether the server parses files before they are sent to the client.
Symbolic links (Unix/Linux)	Allows you to limit the use of file system links in your server. For more information about symbolic links, see Restricting Symbolic Links (Unix/Linux).

For more information, see The Create a New Style Page.

Removing a Configuration Style

---

Before removing a configuration style, remove assignments that had the configuration style applied to them.If you do not do this before removing the configuration style, you must manually edit your obj.conf file, searching for the configuration style in the file and replacing it with None. If you don't do this search and replace, anyone who accesses the files or directories that had the deleted configuration style applied will get a server misconfiguration error message.

To remove a configuration style, perform the following steps:

1. Access the Server Manager and choose the Styles tab.

2. Click List Assignments link.

3. Select Edit Style Assignment you want to remove.

4. Click Remove this Assignment.

5. Click the Remove Style link.

6. Select the configuration style you want to remove and click OK.

For more information, see The Remove a Style Page.

Editing a Configuration Style

---

To edit a configuration style, perform the following steps:

1. Access the Server Manager and choose the Styles tab.

2. Click the Edit Style link.

3. Select the configuration style you want to edit and click the Edit this style button.

4. From the list of links available, click the category you want to configure for your style.

   For more information on these categories, see the section Creating a Configuration Style.

5. Fill out the form that appears, and then click OK.

6. Repeat Step 4 and Step 5 to make any other changes to the configuration style. Click OK.

7. Click Save and Apply to confirm your changes to the configuration style.

When you choose a style to edit, your Resource Picker lists configuration styles instead of other resources. After you have finished editing a style, click OK and Save and Apply. The Resource Picker exits the styles mode. You can also choose to exit the styles mode by choosing Exit styles mode from the Resource Picker.

For more information, see The Edit a Style Page.

Assigning a Configuration Style

---

Once you've created a configuration style, you can assign it to files or directories in your server. You can specify either individual files and directories or wildcard patterns (such as *.gif).

To assign a configuration style, perform the following steps:

1. Access the Server Manager and choose the Styles tab.

2. Click the Assign Style link.

3. Enter the prefix of the URL to which you are applying this configuration style.

   If you choose a directory inside the document root, only enter the path after the document root. If you enter /* after the directory, you apply the configuration style to all of the directory's contents.

4. Select the configuration style you want to apply. To remove any configuration style previously applied to the resource, apply the None configuration style. Click OK.

For more information, see The Assign a Style Page.

Listing Configuration Style Assignments

---

After you have created configuration styles and applied them to files or directories, you can get a list of the configuration styles and where you applied them.

To list the configuration style assignments, perform the following steps:

1. Access the Server Manager and choose the Styles tab.

2. Click the List Assignments link.

   iPlanet Web Server displays the List Assignments page, showing the configuration styles you applied to server resources.

3. To edit a configuration style assignment, click the Edit link next to the configuration style name.

For more information, see The List Assignments Page.