BackUp LevelNext

Creating RDS Mappings

Because the interactive debugger runs in ColdFusion Studio, against the ColdFusion Server and displaying to a Web browser, you must specify file mappings for the directory where the application lives.

Before you start debugging an application, you need to know the following mappings:

An important part of setting up the debugger is creating mappings that inform the debugger how the local paths you use in ColdFusion Studio translate into server paths and URLs.

File mapping examples

The following scenarios show how file mappings work when you have local or remote files matched with either local or remote servers:

ColdFusion Server and Studio on the same machine

Debugging against a local ColdFusion Server is the most common scenario. In most cases, this arrangement allows both the Server and Studio to see the directories in the same way.

For example, the local path c:\inetpub\wwwroot translates to an identical server path C:\inetpub\wwwroot, and a URL path of http://215.180.21.1/. The use of mappings in such a scenario is mainly for URL resolutions. The URL part of the mapping instructs ColdFusion Studio how a physical file can be viewed in a browser.

In this example, you would create a mapping as follows:

ColdFusion Server and Studio on same machine
Studio Path
C:\inetpub\wwwroot\
Server Path
C:\inetpub\wwwroot\
Browser/URL Path
http://215.180.21.1/

Studio accesses files on a remote ColdFusion server using drive mappings

Developers often debug against a remote ColdFusion server across an internal network. In many cases, they use a network drive mapping.

For example, a user may have a remote drive X:\ mapped to a network shared directory \\MYSERVER\WEBPROJECTS\ where WEBPROJECTS is the name of the shared directory in the network server MYSERVER.

In such a scenario, a file that appears to Studio as

X:\App1\Index.cfm

May be viewed by the CF server as

C:\webprojects\App1\index.cfm

The browser may view it using the URL path

http://215.180.21.1/App1/index.cfm

In order to resolve the communication between ColdFusion Studio and the Server, you need to create a mapping for the App1 directory as follows:

Studio accesses files on remote ColdFusion server using drive mappings
Studio Path
X:\App1\
Server Path
C:\webprojects\App1\
Browser/URL Path
http://215.180.21.1/App1/

Studio accesses files on a remote ColdFusion server using UNC paths/Network Neighborhood

Developers can debug code against remote ColdFusion servers across an internal network. They often use the Network Neighborhood to access a file on a remote Cold Fusion server. For example, a developer may be accessing a file on \\myserver\webprojects\ where webprojects is the name of the shared directory in the network server myserver.

In such a scenario, a file that appears to Studio as

\\myserver\webprojects\App1\Index.cfm

May be viewed by the ColdFusion server as

c:\webprojects\App1\index.cfm

The browser may view it using the URL path

http://215.180.21.1/App1/index.cfm

ColdFusion Studio and the Server need to understand how a file location appears to the parties involved. You therefore need to create a mapping for the App1 directory as follows:

Studio accesses files on remote CF server using UNC paths/Network Neighborhood
Studio Path
\\MYSERVER\WEBPROJECTS\App1\
Server Path
C:\webprojects\App1\
Browser/URL Path
http://215.180.21.1/App1/

Studio accesses files on a remote ColdFusion server using RDS-based remote file access

When developing outside local area networks, many developers access files on a ColdFusion Server across the Internet using the RDS-based remote file access available from the Remote tab in ColdFusion Studio.

In such a scenario, a file that appears to Studio as

RDS://MY_RDS_SERVER/C:/webprojects/App1/index.cfm

May be viewed by the ColdFusion server as

C:\webprojects\App1\index.cfm

The browser may view it using the URL path

http://215.180.21.1/App1/index.cfm

Although the server path can be inferred from the local RDS path, you still need to create a mapping. In special scenarios, ColdFusion Server to Studio path resolution could become ambiguous. You therefore need to create a mapping for the App1 directory as follows:

Studio accesses files on remote CF server using RDS remote file access
Studio Path
RDS://MY_RDS_SERVER/C:/WEBPROJECTS/App1/
Server Path
C:\webprojects\App1\
Browser/URL Path
http://215.180.21.1/App1/

Specifying server mappings

The debugger in ColdFusion Studio relies on these mappings to communicate to the ColdFusion server the correct file paths of all files with breakpoints. You create these mappings in the Mappings pane of the Remote Development Settings dialog box.

To specify server and file mappings for debugging:

  1. Choose Debug > Development Mappings to open the Mappings pane of the Remote Development Settings dialog box.
  2. In the ColdFusion Server list box at the top of the dialog box, choose the ColdFusion server against which you'll run the debugging session.
  3. In the Studio Path box, enter the file path ColdFusion Studio uses for the page you're debugging. Click Add.

    If you're debugging against a local server, the Studio and ColdFusion Server paths are the same. So if you chose localhost, for example, in the ColdFusion Server list box above, the CF Server Path is the same as the Studio path you just entered.

  4. If you're debugging against a remote server, enter the CF Server Path.

    The CF Server path needs to be the same as the alias or virtual mapping your web server uses to access the file.

  5. Specify the Browser Path, or URL, of the application and click Add.
  6. Click OK.

BackUp LevelNext

allaire

AllaireDoc@allaire.com
Copyright © 1998, Allaire Corporation. All rights reserved.