Debugging a remote application

You debug
a remote application the same way you debug a local application. Before
you debug a remote application, however, you must configure both
the local PC and remote system (that runs the PowerDyanmo Web server)
to run a remote debugging session.

To debug a Web application that you deploy to a remote server,
your development environment must have the following:

• The network must be running TCP/IP. Other protocols
  are not supported.
• DCOM98 is required on both the development and PowerDynamo
  server machines. You also need DCOMCNFG.EXE to
  configure remote access to client and server machines. The DCOM
  package is installed by default on supported Windows platforms and
  can be downloaded from the Microsoft Web site.
• If the remote server is not a Windows NT machine,
  the PowerDynamo Web server must be running before you start the
  debugging session.
  This restriction does not apply when you are debugging locally
  or when the remote server is a Windows NT machine. In these cases,
  the PowerDynamo server launches automatically as soon as you begin debugging.

After deploying your Web target to a remote machine and after
configuring DCOM permissions on both the local and remote machines,
you are ready to start a remote debugging session.

For information about configuring remote deployment, see “Configuring deployment to
a remote PowerDynamo server”.

Configuring your local system

Before debugging an application that runs on a remote PowerDynamo
server, you must set up local system permissions to allow the server
to send information to the local development environment (during
a remote debugging session).

To configure a client to run a remote debugging
session:

1. In Windows NT:
   Log
   in to your Windows NT domain.

   or

   In other supported Windows versions using
   an NT domain:
   In the Control Panel, click the
   Network icon, and:

   • On the Access Control tab,
     select the User-Level Access Control radio button and type the name
     of your domain in the Obtain List Of Users And Groups From text
     box.
   • On the Configuration tab, double-click Client For
     Microsoft Networks in the list box. Then check the Log On To Windows
     NT Domain check box and type the same NT domain name specified on the
     Access Control tab in the Windows NT Domain box.
2. Run the DCOMCNFG.EXE program,
   which is located in the SYSTEM or the SYSTEM32 subdirectory of your
   main Windows directory.
   • In non-NT
     Windows versions:
     On the Default Security tab, check
     the Enable Remote Connection box.
   • In all Windows and Windows NT versions:
     On
     the Default Properties tab, check the Enable Distributed COM On
     This Computer box.
   • In all Windows and Windows NT versions:
     On
     the Applications tab, double-click PowerBuilder Dynamo Debugger
     to open the Web Target Document Properties dialog box.
3. In the PowerBuilder Dynamo Debugger Properties
   dialog box for DCOM, do the following:
   • On the
     Security tab, select the Use Custom Access Permissions radio button.
   • Click the Edit button.
   • Grant access to the user logged in to the remote
     server.

Configuring the server

On the server system that runs your Web application, you need
to ensure that you have the correct permissions set up on the server
and that PowerDynamo is running.

To configure a server to run a remote debugging
session:

1. In Windows NT:
   Log
   in to your Windows NT domain.

   or

   In other supported Windows versions using
   an NT domain:
   In the Control Panel, click the
   Network icon, and

   • On the Access Control tab,
     select the User-level Access Control radio button and type the name
     of your domain in the Obtain List Of Users And Groups From text
     box.
   • On the Configuration tab, double-click Client For
     Microsoft Networks in the list box. Then check the Log On To Windows
     NT Domain check box and type the same NT domain name specified on the
     Access Control tab in the Windows NT Domain box.
2. Run the DCOMCNFG.EXE program, which is located
   in the SYSTEM or the SYSTEM32 subdirectory of your main Windows
   directory.
   • In non-NT Windows versions:
     On
     the Default Security tab, check the Enable Remote Connection box.
   • In all Windows and Windows NT versions:
     On
     the Default Properties tab, check the Enable Distributed COM On
     This Computer box.
   • In all Windows and Windows NT versions:
     On
     the Applications tab, double-click PowerDynamo to open the PowerDynamo
     Properties dialog box for DCOM.
3. In the PowerDynamo Properties dialog box for DCOM,
   do the following:
   • On the Security tab, select
     the Use Custom Access Permissions radio button.
   • Click the Edit button.
   • Grant access to all users who need to access this
     server.
4. In Windows NT:
   Select the
   Use Custom Launch Permissions radio button on the Security tab and
   grant launch permission to all users who will need to start the
   PowerDynamo Web server.

   or

   In any Windows or Windows NT version:
   Start
   the PowerDynamo Web server.

---