Installing and Configuring ColdFusion Server
Basic ColdFusion Server Administration

Mappings

You use the Mappings page of the ColdFusion Administrator to add, update, and delete logical aliases for paths to directories on your server and to change the root

"/" mapping. This alias usually points to the Web root.

ColdFusion mappings apply only to pages processed by the ColdFusion Server with the cfinclude and cfmodule tags. If you save CFML pages outside of the Web root (or whatever directory is mapped to "/"), you must add a mapping to the location of those files on your server.

For example, let's assume that the "/" mapping on your server points to c:\wwwroot, but all CFML pages associated with your online store reside in e:\store. For the CFML pages that sit in the c:\wwwroot, you want to reference the online store pages using /store in your cfinclude and cfmodule tags. In order for ColdFusion Server to find those pages, you must add a mapping for /store that points to e:\store.

To add a mapping:

1. In the Logical Path text box, enter an alias to assign to a directory, such as /store.
2. In the Directory Path text box, enter the directory for which to create the alias, such as e:\store. To locate the directory name, click Browse Server or enter the directory name.
3. Click Add Mapping.

The Active ColdFusion Mappings table shows the new mapping.

To update a mapping:

1. In the Active ColdFusion Mappings table, click on a logical or directory path.
2. To update a logical or directory path, edit the information in the appropriate field, then click Update Mapping.

The Active ColdFusion Mappings table shows the updated mapping and the original mapping.

To delete a mapping:

In the Active ColdFusion Mappings table, select a mapping to delete. Click Delete Mapping. The mapping disappears immediately.

Copyright © 2001, Macromedia Inc. All rights reserved.

---