WO2012050723A1 - Debugger launch and attach on compute clusters - Google Patents

Debugger launch and attach on compute clusters Download PDF

Info

Publication number
WO2012050723A1
WO2012050723A1 PCT/US2011/051661 US2011051661W WO2012050723A1 WO 2012050723 A1 WO2012050723 A1 WO 2012050723A1 US 2011051661 W US2011051661 W US 2011051661W WO 2012050723 A1 WO2012050723 A1 WO 2012050723A1
Authority
WO
WIPO (PCT)
Prior art keywords
client
debugger
cluster
job
compute node
Prior art date
Application number
PCT/US2011/051661
Other languages
French (fr)
Inventor
Paul E. Maybee
Daniel Moth
Gregg Bernard Miskelly
Original Assignee
Microsoft Corporation
Priority date (The priority date is an assumption and is not a legal conclusion. Google has not performed a legal analysis and makes no representation as to the accuracy of the date listed.)
Filing date
Publication date
Application filed by Microsoft Corporation filed Critical Microsoft Corporation
Priority to EP11832947.3A priority Critical patent/EP2622484B1/en
Priority to CA2811002A priority patent/CA2811002A1/en
Priority to JP2013531628A priority patent/JP5906246B2/en
Priority to KR1020137008236A priority patent/KR101855541B1/en
Publication of WO2012050723A1 publication Critical patent/WO2012050723A1/en

Links

Classifications

    • GPHYSICS
    • G06COMPUTING; CALCULATING OR COUNTING
    • G06FELECTRIC DIGITAL DATA PROCESSING
    • G06F15/00Digital computers in general; Data processing equipment in general
    • G06F15/16Combinations of two or more digital computers each having at least an arithmetic unit, a program unit and a register, e.g. for a simultaneous processing of several programs
    • GPHYSICS
    • G06COMPUTING; CALCULATING OR COUNTING
    • G06FELECTRIC DIGITAL DATA PROCESSING
    • G06F11/00Error detection; Error correction; Monitoring
    • G06F11/36Preventing errors by testing or debugging software
    • G06F11/362Software debugging
    • GPHYSICS
    • G06COMPUTING; CALCULATING OR COUNTING
    • G06FELECTRIC DIGITAL DATA PROCESSING
    • G06F11/00Error detection; Error correction; Monitoring
    • G06F11/36Preventing errors by testing or debugging software

Definitions

  • Computers and computing systems have affected nearly every aspect of modern living. Computers are generally involved in work, recreation, healthcare, transportation, entertainment, household management, etc.
  • computing system functionality can be enhanced by a computing system's ability to be interconnected to other computing systems via network connections.
  • Network connections may include, but are not limited to, connections via wired or wireless Ethernet, cellular connections, or even computer to computer connections through serial, parallel, USB, or other connections.
  • the connections allow a computing system to access services at other computing systems and to quickly and efficiently receive application data from other computing system.
  • Cluster computing involves the use of multiple computers to perform jobs that may be too large for a single computer to perform. Instead, the jobs are subdivided, and subdivisions sent to individual computer systems in the cluster.
  • the cluster is implemented with a head node that accepts jobs and assigns the jobs or portions of the jobs to compute nodes in the cluster.
  • the compute nodes are typically implemented in a private network not accessible publically by computer systems external to the private network.
  • the head node may be a member of both the private network and one or more public networks such that the head node can accept jobs from external clients that may wish to submit jobs to the cluster.
  • Debuggers may be software applications that run alongside, or underneath executing code. Debuggers can be used to step through code (i.e. execute a discrete number of instructions and then wait for user input before executing a next discrete number of instruction), set break points in code to stop execution at certain points in executing code, etc.
  • step through code i.e. execute a discrete number of instructions and then wait for user input before executing a next discrete number of instruction
  • set break points in code to stop execution at certain points in executing code, etc.
  • starting a debugger may be more difficult in view of the fact that the system that a developer would like to debug may be on a network external to the system directly accessible by the developer.
  • the developer may be using a developer application on a client on the public network, while the application to be debugged may be running as jobs on a cluster that is on a private network not directly accessible by the client computer on the public network.
  • the system that one would like to debug may not be able to directly provide a debugger.
  • connecting a debugger to a job executing on a compute cluster may require that the nodes of the cluster be on the same network as the client and/or that the user have administrative access to the compute cluster.
  • the embodiment includes a method with acts for launching a debugging process.
  • the method includes at a compute node on a cluster private network, receiving a debug job via a scheduler of a head node from a client on a public network.
  • the head node is connected to both the cluster private network and the public network.
  • the public network is external to the cluster private network.
  • the method further includes beginning processing the debug job, and as a result initiating debugging by starting one or more debugger remote agents at the compute node.
  • the method further includes beginning processing a user job in the presence of the started debugger remote agents at the compute node.
  • the client is informed that the one or more debugger remote agents are ready to debug the user job.
  • a debugger client at the client is connected to the one or more debugger remote agents.
  • Another embodiment is practiced in a computing environment including a cluster computing system.
  • This embodiment includes a method with acts for attaching a debugging process.
  • the method includes at a compute node on a cluster private network that is executing a user job, receiving a message to start a debug job from a client on a public network via a system that is connected to both the cluster private network and the public network.
  • the public network is external to the cluster private network.
  • the method further includes beginning processing the debug job, and as a result initiating debugging of the user job, by starting one or more debugger remote agents at the compute node.
  • the client is informed that the one or more debugger remote agents are ready to debug the user job.
  • a debugger client at the client is connected to the one or more debugger remote agents.
  • Figure 1 illustrates a debugger launch scenario using a proxy
  • Figure 2 illustrates a debugger attach scenario using a proxy
  • Figure 3 illustrates a debugger launch scenario using NAT forwarding
  • Figure 4 illustrates a debugger attach scenario using NAT forwarding
  • Figure 5 illustrates a method of launching a debugger
  • Figure 6 illustrates a method of attaching a debugger.
  • Embodiments may include functionality for launching a job under debugger control.
  • embodiments may include functionality for attaching a debugger to an existing job. As illustrated, some of these embodiments may implement this without direct client access to the compute nodes or administrative privileges on the cluster.
  • Figure 1 is illustrative.
  • Figure 1 illustrates a client 102 on a public network 104.
  • the client may wish to provide jobs to a cluster.
  • the cluster may have compute nodes, such as compute node 106, which perform work associated with the jobs.
  • Figure 1 illustrates that embodiments will typically include a plurality of compute nodes 106 to which jobs can be assigned by the head node 110.
  • the compute nodes may be on a private network 108 that is separate from the public network 104.
  • the private network 108 is partitioned from the public network 104 such that systems on the public network 104 cannot directly communicate with systems on the private network 108.
  • the networks may have different domains.
  • the client 102 provides jobs and other communication through an intermediary which may be implemented using one or more systems such as the head node 110 and/or the routing node 112.
  • a client 102 may submit a job to an intermediary which then the forwards the job to one or more compute nodes 106.
  • the job submitted by the client 102 may cause an error while being performed by the compute node 106.
  • Embodiments described herein may include functionality for initiating debugging by the client 102 on the cluster to debug the errors. This may be done, in one example, by launching a remote agent debugger, after which code is run on top of the debugger remote agent.
  • launching a debugging process may be performed by a client 102 on the public network 104 external to the cluster private network 106, sending a user job with debugger tasks to an intermediary, such as the head node 110.
  • the head node 110 may create jobs for one or more compute nodes 106 to execute debugger tasks.
  • Executing a debugger task at the compute node 106 initiates remote debugging of a previously sent user job from the client 102 (or some other system) by starting one or more debugger remote agents 114 at one or more compute nodes 106 on the cluster private network 108.
  • the client 102 can then be informed that remote agents 114 are ready for debugging.
  • this may be accomplished by using a routing node 112 that includes a proxy that allows public network systems 104 to call into private network 108 systems.
  • the client 102 may have a debugger client.
  • the debugger client at the client 102 can be connected to debugger remote agents, such as for example, through the routing node 112.
  • an integrated development environment including a developer application 116 can be used.
  • the developer application can be used by a developer to develop applications, and in particular applications intended for cluster computing.
  • the developer application 116 may be implemented using Visual Studio®, available from Microsoft Corporation of Redmond Washington.
  • developer application 116 creates a listener 118.
  • the listener 118 opens a port Dl to facilitate communications.
  • the port assigned (as well as other ports described herein) may be a port in the range of 13225 to 13719 inasmuch as these ports are generally unassigned.
  • the listener 118 opens link, P, to a well known proxy service 120 on the routing node 112 running as a local administrator.
  • the proxy may be selected, in some embodiments, based on configuration data or project settings.
  • the listener 118 sends an initialize message to the proxy service, 120, the message illustrated herein as InitProxy(Dl, U), via P where U is the user's cluster credentials.
  • the proxy service 120 forks a proxy instance with users credentials (U) passing it Dl and the reply context for the InitProxy message. Note that in some embodiments, the messages sent and received described herein may be encrypted.
  • the proxy 122 opens Dl p to the proxy 112 for Dl and opens a port PI for new proxy requests and sends a reply InitProxyReply(Pl, Dl p ) back to the listener 118.
  • the listener 118 sends the scheduler 124 at the head node 110 a new job message: NewJob(DebugStart, PI, Dl p ). This message specifies a new debugger job.
  • the head node 110 and scheduler 124 information for routing by the listener may be included in configuration data and/or development project settings.
  • the scheduler 124 creates the job at each compute node 106 running DebugStart(P 1 , D 1 p ) .
  • Debug Start 126 selects an address D2 and starts the appropriate remote agents 114, in this example by calling msvsmon(D2, E), and waits for an event E.
  • the remote agent 114 starts up and opens D2 for connections.
  • the remote agent 114 sets an event E when it is ready to receive on D2.
  • Debug Start 126 sends a routing message, RouteTo(D2), to the proxy 122 (PI).
  • the proxy 122 creates proxied port D2 P .
  • the proxy responds to Debug Start 126 with a routing reply message, RouteToReply( D2 P ).
  • Debug Start 126 sends a message indicating that the debug agent is started, DebugAgentStarted( D2 P ), to the proxy 122 at Dl p .
  • the proxy 122 forwards the DebugAgentStarted message to the listener 118 at Dl .
  • the listener 118 invokes the developer application 116 debugger instructing it to connect to the remote agent at D2 P .
  • the developer application debugger opens a remote debugging session with the proxy 122 at D2 P .
  • the proxy 122 opens a session with the remote agent 114 at D2.
  • the proxy 122 routes debugging messages in both directions.
  • the developer application debugger through the proxy 122 instructs the remote agent 114 to launch a user process 128.
  • the user process 128 may be the process to be debugged.
  • the remote agent 114 launches and returns a process identifier identifying the user process 128.
  • the developer application debugger informs the listener 118 that the launch is complete and gives the listener 118 the process identifier pid.
  • the listener 118 sends a DebugAgentStartedReply(pid) message to the proxy 122 at D2 P .
  • the proxy 122 forwards the reply to debug start 126.
  • Debug start 126 opens a handle to the user process 128 and waits for its termination.
  • the listener 118 in the example illustrated, is a developer application 116 component that is created at debugging startup and continues in existence until the debugging session has terminated.
  • the purpose of the listener 118 is to initiate developer application 116 debugging for remote processes that want to join the debugging session.
  • the listener 118 is a service (in one example, a Windows Communication Foundation® service available from Microsoft® corporation of Redmond Washington) that responds to requests to initiate remote debugging sessions.
  • a service in one example, a Windows Communication Foundation® service available from Microsoft® corporation of Redmond Washington
  • the following illustrates an example of a request to initiate remote debugging sessions:
  • the listener 118 will invoke the developer application 116 debuggers remote launch/attach code and provide it the RemoteAgentAddress and optionally a ProxyAddress and user credentials.
  • the developer application 116 launch code will open a connection to the RemoteAgentAddress (via the proxy 122) and request that the launch (or as illustrated below attach) take place.
  • pid process identifier
  • the listener 118 replies to the message with the pid. Multiple messages may be expected. In some embodiments, the listener 118 will respond to all messages that it receives.
  • the proxy service 120 is a service running under local system credentials on the routing node 112.
  • the proxy service 102 may be a Windows Communication Foundation® service.
  • the proxy service 120 starts proxies 122 for debugging sessions.
  • the proxy service 120 publishes a well-known address and listens on it for proxy requests. The following illustrates an example publish message:
  • the proxy service 120 validates the user credentials, allocates an endpoint port, and starts a proxy 122 process under the user's credentials.
  • the proxy service 120 waits for the proxy 122 to open the endpoint and then responds to the NewProxySession request with the proxy's 122 endpoint description.
  • the proxy 122 is a service, that in some embodiments may be a Windows Communication Foundation® service, running under user credentials.
  • the proxy 122 is responsible for routing messages between the debugger (e.g. at the developer application 116) on a public network 104 and its remote agents 114 on a private network 108. At startup it opens an endpoint for routing requests.
  • the following illustrates an example of a message to open an endpoint for routing requests:
  • the request comes from a process on network A (B) then the Router opens a new Endpoint on B (A), the proxyEndpoint, and returns a description in the reply.
  • Debug start 126 runs under user credentials and is responsible for starting the remote agent 114 debugger process on the machine with a process (e.g. user process 128) to be debugged. Debug start 126 may be invoked by a cluster manager directly, or by a cluster sub-scheduler that is scheduling tasks for a dynamic computation. Debug start 126 initiates communications to the listener 118 and informs the listener of the dynamic address of the remote agent 114 it has created.
  • developer application 116 creates a listener 118.
  • the listener 118 opens Dl .
  • Listener 118 opens a link to well known proxy service 120 (P) on routing node (for example, form configuration data and/or developer project settings) running as local admin.
  • P well known proxy service 120
  • routing node for example, form configuration data and/or developer project settings
  • the proxy service 120 forks a proxy 122 instance with users credentials (U) passing it Dl and the reply context for the InitProxy message.
  • the proxy 122 opens Dl p to the proxy 122 for Dl and opens PI (and P2) for new proxy requests from private and public networks 104 and 106 respectively and sends a proxy initialization reply message InitProxyReply(Pl, P2, Dl p ) back to the listener 118.
  • the listener 118 requests job details from the scheduler 124.
  • listener 118 receives a list of compute nodes 106 and process id's in return.
  • the listener 118 sends a ForwardMessage(NodeName, A, DebugStart(Pl, Dl p ), U) to P2.
  • the proxy 122 forwards the DebugStart message to the attach service 130 at well known address A on node "NodeName”.
  • the attach service 130 selects an address D2 and starts the user agent 114, such as by calling msvsmon(D2, E) under user credentials U and waits for an event E.
  • Remote agent 114 starts up and opens D2 for connections.
  • Remote agent 114 sets an event E when it is ready to receive on D2.
  • attach service 130 sends a RouteTo(D2) message to the proxy 122 (PI).
  • the proxy 122 creates proxied port D2 P .
  • the proxy 122 responds to attach service 130 with a RouteToReply( D2 P ).
  • attach service 130 sends a DebugAgentStarted(D2 p ) message to the proxy at Di p .
  • the proxy 122 forwards the DebugAgentStarted message to the listener 118 at Dl .
  • the listener 118 invokes the developer application 116 debugger instructing it to connect to the remote agent at D2 P .
  • the developer application 116 debugger opens a remote debugging session with the proxy 122 at D2 P .
  • the proxy 122 opens a session with remote agent 114 at D2. It routes debugging messages in both directions.
  • the debugger instructs remote agent 114 to attach to a user process 128 identified by a process identifier (pid).
  • Remote agent 114 attaches to the process.
  • the developer application 116 debugger informs the listener 118 that the attach is complete.
  • the attach service 130 runs under local system credentials and is responsible for starting the remote debugger process remote agent 114 on the machine with a process (e.g. user process 128) to be debugged.
  • the attach service 130 is a system service running on any node that supports remote cluster attach.
  • the attach service 130 listens for a DebugStart message from the listener 118 and then creates a remote agent 114 process under the user credentials contained in the message. It informs the listener 118 of the dynamic address of the remote agent 114 it has created.
  • FIGS. 3 and 4 illustrate interaction diagrams showing launch and attach examples using a directory service and NAT port forwarding.
  • Figure 3 illustrates the launch scenario.
  • Figure 4 illustrates the attach scenario.
  • a cluster contains two kinds of nodes, a head node 110 and a set of compute nodes 106.
  • the head node 110 is connected to two networks, a public network and a private network.
  • the compute nodes 106 are each connected only to the private network.
  • Client machines, such as host machines 102 are on the public network. Routing is not enabled between the public and private networks except, in this particular example, via explicit NAT port mapping at the head node 110.
  • a number of actors are involved in cluster attach and launch implementations.
  • One such actor is the developer application 116 which may include a debugger user interface host.
  • a directory service 132 which may be an application running as a service (such as for example a Windows® service) that provides a directory of forwarding ports for a cluster job.
  • the directory service may runs on the cluster's head node 110.
  • NAT port forwarding 134 may be a network address translation service running on the cluster's head node 110.
  • the server scheduler 124 running on the head node 110, schedules user jobs to execute on the cluster's compute nodes 106.
  • a diagnostics service 136 is an application executing as a service (such as a Windows® service) on each compute node 106.
  • the diagnostics service 136 handles debugger requests to attach to a process as shown in the attach example of Figure 4.
  • the diagnostic service 136 is started automatically at boot time and listens on a well know port, DS, for the debugger requests.
  • the diagnostic service 136 creates an instance of a remote agent 114 to satisfy the request.
  • Debug start 126 is a task injected by the debugger into a user job.
  • Debug start 126 creates an instance of a remote agent 114 to launch the user process 128 under debugger control.
  • the remote agent 114 is the developer application 116 debugger's remote helper process.
  • the remote agent 114 is started on a compute node 106 by the diagnostic service 136 in response to an attach request.
  • the user process 128 is the process to be debugged.
  • FIG. 3 an example of launching debugging on a cluster and debugging a user process is shown.
  • the developer application 116 user requests via the scheduler 124 that his job is queued for execution on a cluster.
  • the scheduler 124 assigns a set of compute nodes 106 to the job and starts the job running on each node 106.
  • the first task in the job is the debug start task 126.
  • the debug start task 126 creates a remote agent 114 process on each compute node 106 in the set of compute notes, which each opens port Dr and listens for debugger connections.
  • debug start 126 registers the Dr ports for each of the compute nodes 106 with the directory service 132.
  • the developer application 116 polls the directory service 132 for all the ports registered for the user's job until it receives one mapped port, Drp, for each remote agent 114.
  • the directory service 132 will create the port mappings via NAT as needed to fulfill the requests.
  • the directory service 132 periodically polls the scheduler 124 to verify that the job has not terminated.
  • the developer application 116 connects to the remote agent 114 on that compute node 106, via Drp, and creates and debugs the user process 128. Messages continue back and forth between the developer application 116 and the remote agent 114 until the debugging session is complete. Either immediately following the completion of the debugging session, or sometime later, the user processes 128 end and the job is finished.
  • the directory service 132 discovers job completion via the scheduler 124 and deletes all the Drp forwarding ports.
  • the following illustrates a cluster attach scenario.
  • the user queues a job to the scheduler 124.
  • the scheduler 124 gives it a Jobld.
  • the scheduler 124 at some time later starts the user job (comprised of user processes 128) executing on a set, S, of compute nodes 106.
  • the user decides to debug his executing job. He starts the developer application 116 and beings the cluster attach process. He identifies his cluster's head node 110 and Jobld. The developer application 116 queries the scheduler 124 for a list of compute node names and process ids for the user processes 128 of the job.
  • the developer application 116 registers its diagnostic service's 136 port, DS, with the directory service 132.
  • the directory service 132 requests NAT port mapping for DS.
  • the directory service 132 returns the mapped port, DSp. This process results in one DSp created for each compute node 106. Messages sent to a DSp will be routed through the head node 110 to the matching DS.
  • the developer application 116 sends an attach request to DSp.
  • the message is forwarded to the compute node's 106 diagnostic service 136 on port DS.
  • the diagnostic service 136 creates an instance of the remote agent 114 on the compute node 106.
  • the remote agent 114 opens a port, Dr, and listens for debugger connection requests from a debugger at the client 102 associated with the developer application 116. After the remote agent 114 is started the diagnostic service 136 registers Dr with the directory service 132. The attach request is then complete.
  • the developer application 116 polls the directory service 132 for all the ports registered for the user's job until it receives one mapped port, Drp, for each compute node 106.
  • the directory service 132 will create the port mappings via NAT as needed to fulfill the requests.
  • the directory service 132 periodically polls the scheduler 124 to verify that the job has not terminated.
  • the developer application 116 connects to the remote agent 114 on that compute node 106, via Drp, and begins a debugging session for the user process 128. Messages continue back and forth between the developer application 116 (and in particular the debugger module of the developer application) and the remote agent 114 until the debugging session is complete. Either immediately following the completion of the debugging session, or sometime later, the user processes 128 end and the job is finished.
  • the directory service 132 discovers job completion via the scheduler 124 and deletes all the Drp forwarding ports. [0079] At 409, the directory service 132 also deletes all the DSp ports associated with the job.
  • the method 500 may be practiced in a computing environment including a cluster computing system.
  • the method 500 includes acts for launching a debugging process.
  • the method 500 includes at a compute node on a cluster private network, receiving a debug job via a scheduler of a head node from a client on a public network (act 502).
  • the head node is connected to both the private network and the public network.
  • the public network is external to the cluster private network.
  • a compute node 106 may receive a debug job from the client 102 routed through the head node 110, and in particular through the scheduler 124 of the head node 110.
  • the method 500 further includes beginning processing the debug job, and as a result initiating debugging by starting one or more debugger remote agents at the compute node (act 504).
  • the remote agent 114 may be started.
  • the method 500 further includes beginning processing a user job in the presence of the started debugger remote agents at the compute node (act 506).
  • the compute node 106 may begin processing the user process 128 in the presence of the running remote agent 114.
  • the method 500 further includes informing the client that the one or more debugger remote agents are ready to debug the user job.
  • Figure 1 illustrates that a message may be sent to the proxy 122, which is then forwarded to the listener 118 of the developer application 116.
  • the method 500 further include connecting a debugger client at the client to the one or more debugger remote agents.
  • a debugger included in the developer application 116 may be connected to one or more remote agents 114 as described above.
  • the method 600 may be practiced in a computing environment including a cluster computing system.
  • the method 600 includes acts for attaching a debugging process.
  • the method 600 includes at a compute node on a cluster private network that is executing a user job, receiving a debug job from a client on a public network via a system that is connected to both the cluster private network and the public network (act 602).
  • the public network is external to the cluster private network.
  • a public network 104 and cluster private network 108 are illustrated.
  • a client 102 is on the public network 104
  • a compute node 106 is on the cluster private network 108.
  • the compute node may receive a message to start a debug job from the routing node 112.
  • the method 600 further includes beginning processing the debug job, and as a result initiating debugging of the user job, by starting one or more debugger remote agents at the compute node (act 604).
  • the attach service 130 may start the user agent 114.
  • the method 600 further includes informing the client that the one or more debugger remote agents are ready to debug the user job (act 606).
  • the method 600 further includes as a result connecting a debugger client at the client to the one or more debugger remote agents (act 608).
  • the methods may be practiced by a computer system including one or more processors and computer readable media such as computer memory.
  • the computer memory may store computer executable instructions that when executed by one or more processors cause various functions to be performed, such as the acts recited in the embodiments.
  • Embodiments of the present invention may comprise or utilize a special purpose or general-purpose computer including computer hardware, as discussed in greater detail below.
  • Embodiments within the scope of the present invention also include physical and other computer-readable media for carrying or storing computer-executable instructions and/or data structures.
  • Such computer-readable media can be any available media that can be accessed by a general purpose or special purpose computer system.
  • Computer-readable media that store computer-executable instructions are physical storage media.
  • Computer- readable media that carry computer-executable instructions are transmission media.
  • embodiments of the invention can comprise at least two distinctly different kinds of computer-readable media: physical computer readable storage media and transmission computer readable media.
  • Physical computer readable storage media includes RAM, ROM, EEPROM, CD- ROM or other optical disk storage (such as CDs, DVDs, etc), magnetic disk storage or other magnetic storage devices, or any other medium which can be used to store desired program code means in the form of computer-executable instructions or data structures and which can be accessed by a general purpose or special purpose computer.
  • a "network” is defined as one or more data links that enable the transport of electronic data between computer systems and/or modules and/or other electronic devices.
  • a network or another communications connection either hardwired, wireless, or a combination of hardwired or wireless
  • the computer properly views the connection as a transmission medium.
  • Transmissions media can include a network and/or data links which can be used to carry or desired program code means in the form of computer-executable instructions or data structures and which can be accessed by a general purpose or special purpose computer. Combinations of the above are also included within the scope of computer-readable media.
  • program code means in the form of computer-executable instructions or data structures can be transferred automatically from transmission computer readable media to physical computer readable storage media (or vice versa).
  • program code means in the form of computer-executable instructions or data structures received over a network or data link can be buffered in RAM within a network interface module (e.g., a "NIC"), and then eventually transferred to computer system RAM and/or to less volatile computer readable physical storage media at a computer system.
  • NIC network interface module
  • computer readable physical storage media can be included in computer system components that also (or even primarily) utilize transmission media.
  • Computer-executable instructions comprise, for example, instructions and data which cause a general purpose computer, special purpose computer, or special purpose processing device to perform a certain function or group of functions.
  • the computer executable instructions may be, for example, binaries, intermediate format instructions such as assembly language, or even source code.
  • the invention may be practiced in network computing environments with many types of computer system configurations, including, personal computers, desktop computers, laptop computers, message processors, hand-held devices, multi-processor systems, microprocessor-based or programmable consumer electronics, network PCs, minicomputers, mainframe computers, mobile telephones, PDAs, pagers, routers, switches, and the like.
  • the invention may also be practiced in distributed system environments where local and remote computer systems, which are linked (either by hardwired data links, wireless data links, or by a combination of hardwired and wireless data links) through a network, both perform tasks.
  • program modules may be located in both local and remote memory storage devices.

Landscapes

  • Engineering & Computer Science (AREA)
  • Theoretical Computer Science (AREA)
  • Computer Hardware Design (AREA)
  • Physics & Mathematics (AREA)
  • General Engineering & Computer Science (AREA)
  • General Physics & Mathematics (AREA)
  • Quality & Reliability (AREA)
  • Software Systems (AREA)
  • Debugging And Monitoring (AREA)

Abstract

Launching a debugging process. A method includes at a compute node on a cluster private network, receiving a debug job via a scheduler of a head node from a client on a public network. The head node is connected to both the cluster private network and the public network. The public network is external to the cluster private network. The method further includes beginning processing the debug job, and as a result initiating debugging by starting one or more debugger remote agents at the compute node. The method further includes beginning processing a user job in the presence of the started debugger remote agents at the compute node. The client is informed that the one or more debugger remote agents are ready to debug the user job. A debugger client at the client is connected to the one or more debugger remote agents.

Description

DEBUGGER LAUNCH AND ATTACH ON COMPUTE CLUSTERS
BACKGROUND
[0001] Computers and computing systems have affected nearly every aspect of modern living. Computers are generally involved in work, recreation, healthcare, transportation, entertainment, household management, etc.
[0002] Further, computing system functionality can be enhanced by a computing system's ability to be interconnected to other computing systems via network connections. Network connections may include, but are not limited to, connections via wired or wireless Ethernet, cellular connections, or even computer to computer connections through serial, parallel, USB, or other connections. The connections allow a computing system to access services at other computing systems and to quickly and efficiently receive application data from other computing system.
[0003] Interconnected computers can be used to implement cluster computing. Cluster computing involves the use of multiple computers to perform jobs that may be too large for a single computer to perform. Instead, the jobs are subdivided, and subdivisions sent to individual computer systems in the cluster. Typically, the cluster is implemented with a head node that accepts jobs and assigns the jobs or portions of the jobs to compute nodes in the cluster. The compute nodes are typically implemented in a private network not accessible publically by computer systems external to the private network. The head node may be a member of both the private network and one or more public networks such that the head node can accept jobs from external clients that may wish to submit jobs to the cluster.
[0004] In computing systems, there are often problems that arise with respect to systems crashing or returning unexpected results. To determine the causes of systems crashing or unexpected results, various debugging techniques are used. Some techniques involve the use of debuggers. Debuggers may be software applications that run alongside, or underneath executing code. Debuggers can be used to step through code (i.e. execute a discrete number of instructions and then wait for user input before executing a next discrete number of instruction), set break points in code to stop execution at certain points in executing code, etc. However, in cluster systems, starting a debugger may be more difficult in view of the fact that the system that a developer would like to debug may be on a network external to the system directly accessible by the developer. That is, the developer may be using a developer application on a client on the public network, while the application to be debugged may be running as jobs on a cluster that is on a private network not directly accessible by the client computer on the public network. Thus, the system that one would like to debug may not be able to directly provide a debugger.
Rather, connecting a debugger to a job executing on a compute cluster may require that the nodes of the cluster be on the same network as the client and/or that the user have administrative access to the compute cluster.
[0005] The subject matter claimed herein is not limited to embodiments that solve any disadvantages or that operate only in environments such as those described above. Rather, this background is only provided to illustrate one exemplary technology area where some embodiments described herein may be practiced.
BRIEF SUMMARY
[0006] One embodiment illustrated herein may be practiced in a computing environment including a cluster computing system. The embodiment includes a method with acts for launching a debugging process. The method includes at a compute node on a cluster private network, receiving a debug job via a scheduler of a head node from a client on a public network. The head node is connected to both the cluster private network and the public network. The public network is external to the cluster private network. The method further includes beginning processing the debug job, and as a result initiating debugging by starting one or more debugger remote agents at the compute node. The method further includes beginning processing a user job in the presence of the started debugger remote agents at the compute node. The client is informed that the one or more debugger remote agents are ready to debug the user job. A debugger client at the client is connected to the one or more debugger remote agents.
[0007] Another embodiment is practiced in a computing environment including a cluster computing system. This embodiment includes a method with acts for attaching a debugging process. The method includes at a compute node on a cluster private network that is executing a user job, receiving a message to start a debug job from a client on a public network via a system that is connected to both the cluster private network and the public network. The public network is external to the cluster private network. The method further includes beginning processing the debug job, and as a result initiating debugging of the user job, by starting one or more debugger remote agents at the compute node. The client is informed that the one or more debugger remote agents are ready to debug the user job. A debugger client at the client is connected to the one or more debugger remote agents. [0008] This Summary is provided to introduce a selection of concepts in a simplified form that are further described below in the Detailed Description. This Summary is not intended to identify key features or essential features of the claimed subject matter, nor is it intended to be used as an aid in determining the scope of the claimed subject matter.
[0009] Additional features and advantages will be set forth in the description which follows, and in part will be obvious from the description, or may be learned by the practice of the teachings herein. Features and advantages of the invention may be realized and obtained by means of the instruments and combinations particularly pointed out in the appended claims. Features of the present invention will become more fully apparent from the following description and appended claims, or may be learned by the practice of the invention as set forth hereinafter.
BRIEF DESCRIPTION OF THE DRAWINGS
[0010] In order to describe the manner in which the above-recited and other advantages and features can be obtained, a more particular description of the subject matter briefly described above will be rendered by reference to specific embodiments which are illustrated in the appended drawings. Understanding that these drawings depict only typical embodiments and are not therefore to be considered to be limiting in scope, embodiments will be described and explained with additional specificity and detail through the use of the accompanying drawings in which:
[0011] Figure 1 illustrates a debugger launch scenario using a proxy;
[0012] Figure 2 illustrates a debugger attach scenario using a proxy;
[0013] Figure 3 illustrates a debugger launch scenario using NAT forwarding;
[0014] Figure 4 illustrates a debugger attach scenario using NAT forwarding;
[0015] Figure 5 illustrates a method of launching a debugger; and
[0016] Figure 6 illustrates a method of attaching a debugger.
DETAILED DESCRIPTION
[0017] Disclosed herein are various embodiments including debugging functionality for a cluster. Embodiments may include functionality for launching a job under debugger control. Alternatively, embodiments may include functionality for attaching a debugger to an existing job. As illustrated, some of these embodiments may implement this without direct client access to the compute nodes or administrative privileges on the cluster.
[0018] Figure 1 is illustrative. Figure 1 illustrates a client 102 on a public network 104. The client may wish to provide jobs to a cluster. The cluster may have compute nodes, such as compute node 106, which perform work associated with the jobs. Figure 1 illustrates that embodiments will typically include a plurality of compute nodes 106 to which jobs can be assigned by the head node 110. The compute nodes may be on a private network 108 that is separate from the public network 104. In particular, the private network 108 is partitioned from the public network 104 such that systems on the public network 104 cannot directly communicate with systems on the private network 108. For example, the networks may have different domains.
[0019] Rather, the client 102 provides jobs and other communication through an intermediary which may be implemented using one or more systems such as the head node 110 and/or the routing node 112. A client 102 may submit a job to an intermediary which then the forwards the job to one or more compute nodes 106. The job submitted by the client 102 may cause an error while being performed by the compute node 106.
Embodiments described herein may include functionality for initiating debugging by the client 102 on the cluster to debug the errors. This may be done, in one example, by launching a remote agent debugger, after which code is run on top of the debugger remote agent.
[0020] In an illustrative example, launching a debugging process may be performed by a client 102 on the public network 104 external to the cluster private network 106, sending a user job with debugger tasks to an intermediary, such as the head node 110. The head node 110 may create jobs for one or more compute nodes 106 to execute debugger tasks. Executing a debugger task at the compute node 106 initiates remote debugging of a previously sent user job from the client 102 (or some other system) by starting one or more debugger remote agents 114 at one or more compute nodes 106 on the cluster private network 108. The client 102 can then be informed that remote agents 114 are ready for debugging. In some embodiments this may be accomplished by using a routing node 112 that includes a proxy that allows public network systems 104 to call into private network 108 systems. Further, the client 102 may have a debugger client. The debugger client at the client 102 can be connected to debugger remote agents, such as for example, through the routing node 112.
[0021] The following illustrates additional details of one example. In particular, in the following example, made with continued reference to Figure 1, an embodiment is illustrated where an integrated development environment including a developer application 116 can be used. The developer application can be used by a developer to develop applications, and in particular applications intended for cluster computing. In the particular example illustrated, the developer application 116 may be implemented using Visual Studio®, available from Microsoft Corporation of Redmond Washington.
[0022] As illustrated at 1, developer application 116 creates a listener 118. The listener 118 opens a port Dl to facilitate communications. In some embodiments, the port assigned (as well as other ports described herein) may be a port in the range of 13225 to 13719 inasmuch as these ports are generally unassigned. The listener 118 opens link, P, to a well known proxy service 120 on the routing node 112 running as a local administrator. The proxy may be selected, in some embodiments, based on configuration data or project settings. The listener 118 sends an initialize message to the proxy service, 120, the message illustrated herein as InitProxy(Dl, U), via P where U is the user's cluster credentials. The proxy service 120 forks a proxy instance with users credentials (U) passing it Dl and the reply context for the InitProxy message. Note that in some embodiments, the messages sent and received described herein may be encrypted.
[0023] As illustrated at 2, the proxy 122 opens Dlp to the proxy 112 for Dl and opens a port PI for new proxy requests and sends a reply InitProxyReply(Pl, Dlp) back to the listener 118.
[0024] As illustrated at 3, the listener 118 sends the scheduler 124 at the head node 110 a new job message: NewJob(DebugStart, PI, Dlp). This message specifies a new debugger job. In some embodiment, the head node 110 and scheduler 124 information for routing by the listener, may be included in configuration data and/or development project settings.
[0025] As illustrated at 4, the scheduler 124 creates the job at each compute node 106 running DebugStart(P 1 , D 1 p) .
[0026] As illustrated at 5, Debug Start 126 selects an address D2 and starts the appropriate remote agents 114, in this example by calling msvsmon(D2, E), and waits for an event E. The remote agent 114 starts up and opens D2 for connections. The remote agent 114 sets an event E when it is ready to receive on D2.
[0027] As illustrated at 6, Debug Start 126 sends a routing message, RouteTo(D2), to the proxy 122 (PI). The proxy 122 creates proxied port D2P.
[0028] As illustrated at 7, the proxy responds to Debug Start 126 with a routing reply message, RouteToReply( D2P).
[0029] As illustrated at 8, Debug Start 126 sends a message indicating that the debug agent is started, DebugAgentStarted( D2P), to the proxy 122 at Dlp. [0030] At 9, the proxy 122 forwards the DebugAgentStarted message to the listener 118 at Dl . The listener 118 invokes the developer application 116 debugger instructing it to connect to the remote agent at D2P.
[0031] As illustrated at 10, the developer application debugger opens a remote debugging session with the proxy 122 at D2P.
[0032] As illustrated at 11, the proxy 122 opens a session with the remote agent 114 at D2. The proxy 122 routes debugging messages in both directions. The developer application debugger, through the proxy 122 instructs the remote agent 114 to launch a user process 128. The user process 128 may be the process to be debugged. The remote agent 114 launches and returns a process identifier identifying the user process 128. The developer application debugger informs the listener 118 that the launch is complete and gives the listener 118 the process identifier pid.
[0033] As illustrated at 12, the listener 118 sends a DebugAgentStartedReply(pid) message to the proxy 122 at D2P.
[0034] As illustrated at 13, the proxy 122 forwards the reply to debug start 126. Debug start 126 opens a handle to the user process 128 and waits for its termination.
[0035] In the example illustrated above, various components are illustrated. The following discussion illustrates additional details of some of these components.
[0036] The listener 118, in the example illustrated, is a developer application 116 component that is created at debugging startup and continues in existence until the debugging session has terminated. The purpose of the listener 118 is to initiate developer application 116 debugging for remote processes that want to join the debugging session.
The listener 118 is a service (in one example, a Windows Communication Foundation® service available from Microsoft® corporation of Redmond Washington) that responds to requests to initiate remote debugging sessions. The following illustrates an example of a request to initiate remote debugging sessions:
PID InitiateRemoteDebugSession(Endpoint RemoteAgentAddress, Endpoint ProxyAddress)
[0037] In response to this message the listener 118 will invoke the developer application 116 debuggers remote launch/attach code and provide it the RemoteAgentAddress and optionally a ProxyAddress and user credentials. The developer application 116 launch code will open a connection to the RemoteAgentAddress (via the proxy 122) and request that the launch (or as illustrated below attach) take place. On successful completion a process identifier (pid) is returned to the listener 118. The listener 118 replies to the message with the pid. Multiple messages may be expected. In some embodiments, the listener 118 will respond to all messages that it receives.
[0038] The proxy service 120 is a service running under local system credentials on the routing node 112. In some embodiments, the proxy service 102 may be a Windows Communication Foundation® service. The proxy service 120 starts proxies 122 for debugging sessions. The proxy service 120 publishes a well-known address and listens on it for proxy requests. The following illustrates an example publish message:
Endpoint NewProxySession( Credentials userCredentials )
[0039] When a request comes in, the proxy service 120 validates the user credentials, allocates an endpoint port, and starts a proxy 122 process under the user's credentials. The proxy service 120 waits for the proxy 122 to open the endpoint and then responds to the NewProxySession request with the proxy's 122 endpoint description.
[0040] The proxy 122 is a service, that in some embodiments may be a Windows Communication Foundation® service, running under user credentials. The proxy 122 is responsible for routing messages between the debugger (e.g. at the developer application 116) on a public network 104 and its remote agents 114 on a private network 108. At startup it opens an endpoint for routing requests. The following illustrates an example of a message to open an endpoint for routing requests:
Endpoint RouteTo( Endpoint endpoint)
[0041] The request comes from a process on network A (B) then the Router opens a new Endpoint on B (A), the proxyEndpoint, and returns a description in the reply.
[0042] Debug start 126 runs under user credentials and is responsible for starting the remote agent 114 debugger process on the machine with a process (e.g. user process 128) to be debugged. Debug start 126 may be invoked by a cluster manager directly, or by a cluster sub-scheduler that is scheduling tasks for a dynamic computation. Debug start 126 initiates communications to the listener 118 and informs the listener of the dynamic address of the remote agent 114 it has created.
[0043] While the preceding example shown in Figure 1 has illustrated an example of debugging a user process 128 by starting debugging capabilities and then starting the user process 128, other embodiments may attach debugging functionality to an already executing process. The following and Figure 2 illustrates an example of debugger attach.
[0044] As illustrated at 201, developer application 116 creates a listener 118. The listener 118 opens Dl . Listener 118 opens a link to well known proxy service 120 (P) on routing node (for example, form configuration data and/or developer project settings) running as local admin. The listener 118 sends a proxy initialization message
InitProxy(Dl, U) to P where U is the user's cluster credentials. The proxy service 120 forks a proxy 122 instance with users credentials (U) passing it Dl and the reply context for the InitProxy message.
[0045] As illustrated at 202, the proxy 122 opens Dlp to the proxy 122 for Dl and opens PI (and P2) for new proxy requests from private and public networks 104 and 106 respectively and sends a proxy initialization reply message InitProxyReply(Pl, P2, Dlp) back to the listener 118.
[0046] As illustrated at 203, the listener 118 requests job details from the scheduler 124.
[0047] As illustrated at 204, listener 118 receives a list of compute nodes 106 and process id's in return.
[0048] As illustrated at 205, for each compute node 106 in the list, the listener 118 sends a ForwardMessage(NodeName, A, DebugStart(Pl, Dlp), U) to P2.
[0049] As illustrated at 206, the proxy 122 forwards the DebugStart message to the attach service 130 at well known address A on node "NodeName".
[0050] As illustrated at 207, the attach service 130 selects an address D2 and starts the user agent 114, such as by calling msvsmon(D2, E) under user credentials U and waits for an event E. Remote agent 114 starts up and opens D2 for connections. Remote agent 114 sets an event E when it is ready to receive on D2.
[0051] As illustrated at 208, attach service 130 sends a RouteTo(D2) message to the proxy 122 (PI). The proxy 122 creates proxied port D2P.
[0052] As illustrated at 209, The proxy 122 responds to attach service 130 with a RouteToReply( D2P).
[0053] As illustrated at 210, attach service 130 sends a DebugAgentStarted(D2p) message to the proxy at Dip.
[0054] As illustrated at 211, the proxy 122 forwards the DebugAgentStarted message to the listener 118 at Dl . The listener 118 invokes the developer application 116 debugger instructing it to connect to the remote agent at D2P.
[0055] As illustrated at 212, the developer application 116 debugger opens a remote debugging session with the proxy 122 at D2P.
[0056] As illustrated at 213, the proxy 122 opens a session with remote agent 114 at D2. It routes debugging messages in both directions. The debugger instructs remote agent 114 to attach to a user process 128 identified by a process identifier (pid). Remote agent 114 attaches to the process. The developer application 116 debugger informs the listener 118 that the attach is complete.
[0057] The following illustrates details of the attach service 130 in some embodiments. The attach service 130 runs under local system credentials and is responsible for starting the remote debugger process remote agent 114 on the machine with a process (e.g. user process 128) to be debugged. The attach service 130 is a system service running on any node that supports remote cluster attach. The attach service 130 listens for a DebugStart message from the listener 118 and then creates a remote agent 114 process under the user credentials contained in the message. It informs the listener 118 of the dynamic address of the remote agent 114 it has created.
[0058] While the embodiments illustrated above use a proxy to communicate between the public and private networks, other embodiments may use a directory service and NAT port forwarding. For example Figures 3 and 4 illustrate interaction diagrams showing launch and attach examples using a directory service and NAT port forwarding. In particular, Figure 3 illustrates the launch scenario. Figure 4 illustrates the attach scenario.
[0059] As with the examples previously discussed, a cluster contains two kinds of nodes, a head node 110 and a set of compute nodes 106. The head node 110 is connected to two networks, a public network and a private network. The compute nodes 106 are each connected only to the private network. Client machines, such as host machines 102 are on the public network. Routing is not enabled between the public and private networks except, in this particular example, via explicit NAT port mapping at the head node 110.
[0060] A number of actors are involved in cluster attach and launch implementations. One such actor is the developer application 116 which may include a debugger user interface host.
[0061] Another actor is a directory service 132, which may be an application running as a service (such as for example a Windows® service) that provides a directory of forwarding ports for a cluster job. The directory service may runs on the cluster's head node 110. NAT port forwarding 134, may be a network address translation service running on the cluster's head node 110. The server scheduler 124, running on the head node 110, schedules user jobs to execute on the cluster's compute nodes 106.
[0062] A diagnostics service 136 is an application executing as a service (such as a Windows® service) on each compute node 106. The diagnostics service 136 handles debugger requests to attach to a process as shown in the attach example of Figure 4. The diagnostic service 136 is started automatically at boot time and listens on a well know port, DS, for the debugger requests. The diagnostic service 136 creates an instance of a remote agent 114 to satisfy the request. Debug start 126 is a task injected by the debugger into a user job. Debug start 126 creates an instance of a remote agent 114 to launch the user process 128 under debugger control. The remote agent 114 is the developer application 116 debugger's remote helper process. The remote agent 114 is started on a compute node 106 by the diagnostic service 136 in response to an attach request. The user process 128 is the process to be debugged.
[0063] Referring now to Figure 3, an example of launching debugging on a cluster and debugging a user process is shown. At 301, the developer application 116 user requests via the scheduler 124 that his job is queued for execution on a cluster.
[0064] At 302, the scheduler 124 assigns a set of compute nodes 106 to the job and starts the job running on each node 106.
[0065] At 303, the first task in the job is the debug start task 126. The debug start task 126 creates a remote agent 114 process on each compute node 106 in the set of compute notes, which each opens port Dr and listens for debugger connections.
[0066] At 304, after the remote agent 114 is started, debug start 126 registers the Dr ports for each of the compute nodes 106 with the directory service 132.
[0067] At 305, the developer application 116 polls the directory service 132 for all the ports registered for the user's job until it receives one mapped port, Drp, for each remote agent 114. The directory service 132 will create the port mappings via NAT as needed to fulfill the requests.
[0068] At 306, once ports have been created for a job, the directory service 132 periodically polls the scheduler 124 to verify that the job has not terminated.
[0069] At 307, for each registered port, the developer application 116 connects to the remote agent 114 on that compute node 106, via Drp, and creates and debugs the user process 128. Messages continue back and forth between the developer application 116 and the remote agent 114 until the debugging session is complete. Either immediately following the completion of the debugging session, or sometime later, the user processes 128 end and the job is finished.
[0070] At 308, the directory service 132 discovers job completion via the scheduler 124 and deletes all the Drp forwarding ports.
[0071] The following illustrates a cluster attach scenario. At 401, the user queues a job to the scheduler 124. The scheduler 124 gives it a Jobld. The scheduler 124 at some time later starts the user job (comprised of user processes 128) executing on a set, S, of compute nodes 106.
[0072] At 402, the user decides to debug his executing job. He starts the developer application 116 and beings the cluster attach process. He identifies his cluster's head node 110 and Jobld. The developer application 116 queries the scheduler 124 for a list of compute node names and process ids for the user processes 128 of the job.
[0073] At 403, for each compute node 106 in the list returned by the scheduler 124, the developer application 116 registers its diagnostic service's 136 port, DS, with the directory service 132. The directory service 132, in turn, requests NAT port mapping for DS. The directory service 132 returns the mapped port, DSp. This process results in one DSp created for each compute node 106. Messages sent to a DSp will be routed through the head node 110 to the matching DS.
[0074] At 404, for each compute node 106, the developer application 116 sends an attach request to DSp. The message is forwarded to the compute node's 106 diagnostic service 136 on port DS. The diagnostic service 136 creates an instance of the remote agent 114 on the compute node 106. The remote agent 114 opens a port, Dr, and listens for debugger connection requests from a debugger at the client 102 associated with the developer application 116. After the remote agent 114 is started the diagnostic service 136 registers Dr with the directory service 132. The attach request is then complete.
[0075] At 405, the developer application 116 polls the directory service 132 for all the ports registered for the user's job until it receives one mapped port, Drp, for each compute node 106. The directory service 132 will create the port mappings via NAT as needed to fulfill the requests.
[0076] At 406, once ports have been created for a job, the directory service 132 periodically polls the scheduler 124 to verify that the job has not terminated.
[0077] At 407, for each user process 128 on each compute node 106, the developer application 116 connects to the remote agent 114 on that compute node 106, via Drp, and begins a debugging session for the user process 128. Messages continue back and forth between the developer application 116 (and in particular the debugger module of the developer application) and the remote agent 114 until the debugging session is complete. Either immediately following the completion of the debugging session, or sometime later, the user processes 128 end and the job is finished.
[0078] At 408, the directory service 132 discovers job completion via the scheduler 124 and deletes all the Drp forwarding ports. [0079] At 409, the directory service 132 also deletes all the DSp ports associated with the job.
[0080] The following discussion now refers to a number of methods and method acts that may be performed. Although the method acts may be discussed in a certain order or illustrated in a flow chart as occurring in a particular order, no particular ordering is required unless specifically stated, or required because an act is dependent on another act being completed prior to the act being performed.
[0081] Referring now to Figure 5, a method 500 is illustrated. The method 500 may be practiced in a computing environment including a cluster computing system. The method 500 includes acts for launching a debugging process. The method 500 includes at a compute node on a cluster private network, receiving a debug job via a scheduler of a head node from a client on a public network (act 502). The head node is connected to both the private network and the public network. The public network is external to the cluster private network. For example, as illustrated in Figure 1, a compute node 106 may receive a debug job from the client 102 routed through the head node 110, and in particular through the scheduler 124 of the head node 110.
[0082] The method 500 further includes beginning processing the debug job, and as a result initiating debugging by starting one or more debugger remote agents at the compute node (act 504). For example, with reference to Figure 1, the remote agent 114 may be started.
[0083] The method 500 further includes beginning processing a user job in the presence of the started debugger remote agents at the compute node (act 506). For example, the compute node 106 may begin processing the user process 128 in the presence of the running remote agent 114.
[0084] The method 500 further includes informing the client that the one or more debugger remote agents are ready to debug the user job. For example, Figure 1 illustrates that a message may be sent to the proxy 122, which is then forwarded to the listener 118 of the developer application 116.
[0085] The method 500 further include connecting a debugger client at the client to the one or more debugger remote agents. For example, a debugger included in the developer application 116 may be connected to one or more remote agents 114 as described above.
[0086] Referring now to Figure 6, another method 600 is illustrated. The method 600 may be practiced in a computing environment including a cluster computing system. The method 600 includes acts for attaching a debugging process. The method 600 includes at a compute node on a cluster private network that is executing a user job, receiving a debug job from a client on a public network via a system that is connected to both the cluster private network and the public network (act 602). The public network is external to the cluster private network. For example, as illustrated in Figure 2, a public network 104 and cluster private network 108 are illustrated. A client 102 is on the public network 104, and a compute node 106 is on the cluster private network 108. The compute node may receive a message to start a debug job from the routing node 112.
[0087] The method 600 further includes beginning processing the debug job, and as a result initiating debugging of the user job, by starting one or more debugger remote agents at the compute node (act 604). In particular, the attach service 130 may start the user agent 114.
[0088] The method 600 further includes informing the client that the one or more debugger remote agents are ready to debug the user job (act 606).
[0089] The method 600 further includes as a result connecting a debugger client at the client to the one or more debugger remote agents (act 608).
[0090] Further, the methods may be practiced by a computer system including one or more processors and computer readable media such as computer memory. In particular, the computer memory may store computer executable instructions that when executed by one or more processors cause various functions to be performed, such as the acts recited in the embodiments.
[0091] Embodiments of the present invention may comprise or utilize a special purpose or general-purpose computer including computer hardware, as discussed in greater detail below. Embodiments within the scope of the present invention also include physical and other computer-readable media for carrying or storing computer-executable instructions and/or data structures. Such computer-readable media can be any available media that can be accessed by a general purpose or special purpose computer system. Computer-readable media that store computer-executable instructions are physical storage media. Computer- readable media that carry computer-executable instructions are transmission media. Thus, by way of example, and not limitation, embodiments of the invention can comprise at least two distinctly different kinds of computer-readable media: physical computer readable storage media and transmission computer readable media.
[0092] Physical computer readable storage media includes RAM, ROM, EEPROM, CD- ROM or other optical disk storage (such as CDs, DVDs, etc), magnetic disk storage or other magnetic storage devices, or any other medium which can be used to store desired program code means in the form of computer-executable instructions or data structures and which can be accessed by a general purpose or special purpose computer.
[0093] A "network" is defined as one or more data links that enable the transport of electronic data between computer systems and/or modules and/or other electronic devices. When information is transferred or provided over a network or another communications connection (either hardwired, wireless, or a combination of hardwired or wireless) to a computer, the computer properly views the connection as a transmission medium.
Transmissions media can include a network and/or data links which can be used to carry or desired program code means in the form of computer-executable instructions or data structures and which can be accessed by a general purpose or special purpose computer. Combinations of the above are also included within the scope of computer-readable media.
[0094] Further, upon reaching various computer system components, program code means in the form of computer-executable instructions or data structures can be transferred automatically from transmission computer readable media to physical computer readable storage media (or vice versa). For example, computer-executable instructions or data structures received over a network or data link can be buffered in RAM within a network interface module (e.g., a "NIC"), and then eventually transferred to computer system RAM and/or to less volatile computer readable physical storage media at a computer system. Thus, computer readable physical storage media can be included in computer system components that also (or even primarily) utilize transmission media.
[0095] Computer-executable instructions comprise, for example, instructions and data which cause a general purpose computer, special purpose computer, or special purpose processing device to perform a certain function or group of functions. The computer executable instructions may be, for example, binaries, intermediate format instructions such as assembly language, or even source code. Although the subject matter has been described in language specific to structural features and/or methodological acts, it is to be understood that the subject matter defined in the appended claims is not necessarily limited to the described features or acts described above. Rather, the described features and acts are disclosed as example forms of implementing the claims.
[0096] Those skilled in the art will appreciate that the invention may be practiced in network computing environments with many types of computer system configurations, including, personal computers, desktop computers, laptop computers, message processors, hand-held devices, multi-processor systems, microprocessor-based or programmable consumer electronics, network PCs, minicomputers, mainframe computers, mobile telephones, PDAs, pagers, routers, switches, and the like. The invention may also be practiced in distributed system environments where local and remote computer systems, which are linked (either by hardwired data links, wireless data links, or by a combination of hardwired and wireless data links) through a network, both perform tasks. In a distributed system environment, program modules may be located in both local and remote memory storage devices.
[0097] The present invention may be embodied in other specific forms without departing from its spirit or characteristics. The described embodiments are to be considered in all respects only as illustrative and not restrictive. The scope of the invention is, therefore, indicated by the appended claims rather than by the foregoing description. All changes which come within the meaning and range of equivalency of the claims are to be embraced within their scope.

Claims

1. In a computing environment comprising a cluster computing system, a method of launching a debugging process, the method comprising:
at a compute node on a cluster private network, receiving a debug job via a scheduler of a head node from a client on a public network, wherein the head node is connected to both the cluster private network and the public network, and wherein the public network is external to the cluster private network;
beginning processing the debug job, and as a result initiating debugging by starting one or more debugger remote agents at the compute node;
beginning processing a user job in the presence of the started debugger remote agents 114 at the compute node;
informing the client that the one or more debugger remote agents are ready to debug the user job; and
as a result connecting a debugger client at the client to the one or more debugger remote agents.
2. The method of claim 1 wherein the client comprises a listener and wherein communication from the client to the compute node via one or more intermediaries is from the listener.
3. The method of claim 2, wherein communications are pulled from the client.
4. The method of claim 2, wherein communications are pushed from the client.
5. The method of claim 1, wherein communications between the client and the compute node are through a proxy on a system coupled to both the public network and the cluster private network.
6. The method of claim 1, wherein communications between the client and the compute node are through a NAT service on a system coupled to both the public network and the cluster private network.
7. The method of claim 1 further comprising receiving the user job via the scheduler of the head node from the client on the public network.
8. The method of claim 1 further comprising opening one or more proxy ports to facilitate communications between the client and the compute node, and wherein the one or more proxy ports are selected from the range of 13225 to 13719.
9. The method of claim 1, wherein the client comprises a developer application used by a developer to develop application for cluster computing, and wherein messages from the client are received from the developer application.
10. In a computing environment comprising a cluster computing system, a method of attaching a debugging process, the method comprising:
at a compute node on a cluster private network that is executing a user job, receiving a message to start a debug job from a client on a public network, via a system that is connected to both the cluster private network and the public network, and wherein the public network is external to the cluster private network.
beginning processing the debug job, and as a result initiating debugging of the user job, by starting one or more debugger remote agents at the compute node;
informing the client that the one or more debugger remote agents are ready to debug the user job; and
as a result connecting a debugger client at the client to the one or more debugger remote agents.
11. The method of claim 10 wherein the client comprises a listener and wherein communication from the client to the compute node via one or more intermediaries is from the listener.
12. The method of claim 11, wherein communications are pulled from the client.
13. The method of claim 11, wherein communications are pushed from the client.
14. The method of claim 10, wherein communications between the client and the compute node are through a proxy on a system coupled to both the public network and the cluster private network.
15. The method of claim 10, wherein communications between the client and the compute node are through a NAT service on a system coupled to both the public network and the cluster private network.
PCT/US2011/051661 2010-09-30 2011-09-14 Debugger launch and attach on compute clusters WO2012050723A1 (en)

Priority Applications (4)

Application Number Priority Date Filing Date Title
EP11832947.3A EP2622484B1 (en) 2010-09-30 2011-09-14 Debugger launch and attach on compute clusters
CA2811002A CA2811002A1 (en) 2010-09-30 2011-09-14 Debugger launch and attach on compute clusters
JP2013531628A JP5906246B2 (en) 2010-09-30 2011-09-14 Launching and attaching a debugger on a compute cluster
KR1020137008236A KR101855541B1 (en) 2010-09-30 2011-09-14 Debugger launch and attach on compute clusters

Applications Claiming Priority (2)

Application Number Priority Date Filing Date Title
US12/894,590 US8589885B2 (en) 2010-09-30 2010-09-30 Debugger launch and attach on compute clusters
US12/894,590 2010-09-30

Publications (1)

Publication Number Publication Date
WO2012050723A1 true WO2012050723A1 (en) 2012-04-19

Family

ID=45890926

Family Applications (1)

Application Number Title Priority Date Filing Date
PCT/US2011/051661 WO2012050723A1 (en) 2010-09-30 2011-09-14 Debugger launch and attach on compute clusters

Country Status (8)

Country Link
US (1) US8589885B2 (en)
EP (1) EP2622484B1 (en)
JP (1) JP5906246B2 (en)
KR (1) KR101855541B1 (en)
CN (1) CN102523100B (en)
CA (1) CA2811002A1 (en)
HK (1) HK1170609A1 (en)
WO (1) WO2012050723A1 (en)

Families Citing this family (32)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
US10169199B2 (en) 2008-06-10 2019-01-01 Microsoft Technology Licensing, Llc Automatic model-specific debugger extensions
US8402465B2 (en) * 2009-11-24 2013-03-19 Cray Inc. System tool placement in a multiprocessor computer
US8589885B2 (en) * 2010-09-30 2013-11-19 Microsoft Corporation Debugger launch and attach on compute clusters
JP2012079130A (en) * 2010-10-01 2012-04-19 Fujitsu Ltd Debug support program, debug support device and debug support method
US8904356B2 (en) 2010-10-20 2014-12-02 International Business Machines Corporation Collaborative software debugging in a distributed system with multi-member variable expansion
US9009673B2 (en) 2010-10-21 2015-04-14 International Business Machines Corporation Collaborative software debugging in a distributed system with collaborative step over operation
US8972945B2 (en) 2010-10-21 2015-03-03 International Business Machines Corporation Collaborative software debugging in a distributed system with client-specific access control
US8671393B2 (en) 2010-10-21 2014-03-11 International Business Machines Corporation Collaborative software debugging in a distributed system with client-specific dynamic breakpoints
US9411709B2 (en) 2010-11-10 2016-08-09 International Business Machines Corporation Collaborative software debugging in a distributed system with client-specific event alerts
US8850397B2 (en) 2010-11-10 2014-09-30 International Business Machines Corporation Collaborative software debugging in a distributed system with client-specific display of local variables
US8990775B2 (en) 2010-11-10 2015-03-24 International Business Machines Corporation Collaborative software debugging in a distributed system with dynamically displayed chat sessions
US8739127B2 (en) 2011-04-20 2014-05-27 International Business Machines Corporation Collaborative software debugging in a distributed system with symbol locking
US8806438B2 (en) 2011-04-20 2014-08-12 International Business Machines Corporation Collaborative software debugging in a distributed system with variable-specific messages
US8656360B2 (en) * 2011-04-20 2014-02-18 International Business Machines Corporation Collaborative software debugging in a distributed system with execution resumption on consensus
US8756577B2 (en) 2011-06-28 2014-06-17 International Business Machines Corporation Collaborative software debugging in a distributed system with private debug sessions
US9720809B2 (en) 2012-02-17 2017-08-01 Microsoft Technology Licensing, Llc Dynamically enabling debugging over the internet
US8990778B1 (en) * 2012-09-14 2015-03-24 Amazon Technologies, Inc. Shadow test replay service
CN103856361B (en) * 2012-11-29 2017-10-10 腾讯科技(深圳)有限公司 Realize the method and system of remote debugging
US10182128B1 (en) 2013-02-07 2019-01-15 Amazon Technologies, Inc. Optimization of production systems
US9836388B1 (en) 2013-09-26 2017-12-05 Amazon Technologies, Inc. Software testing environment that includes a duplicating proxy service
US10389697B1 (en) 2014-08-27 2019-08-20 Amazon Technologies, Inc. Software container activation and throttling
CN104184823B (en) * 2014-09-05 2017-11-14 北京京东尚科信息技术有限公司 A kind of method and system for automating task scheduling
CN104375938B (en) * 2014-11-20 2017-09-05 工业和信息化部电信研究院 The dynamic behaviour monitoring method and system of Android application program
US10592295B2 (en) 2017-02-28 2020-03-17 International Business Machines Corporation Injection method of monitoring and controlling task execution in a distributed computer system
US10545740B2 (en) * 2017-10-25 2020-01-28 Saudi Arabian Oil Company Distributed agent to collect input and output data along with source code for scientific kernels of single-process and distributed systems
US10762234B2 (en) * 2018-03-08 2020-09-01 International Business Machines Corporation Data processing in a hybrid cluster environment
US11392482B2 (en) 2019-01-03 2022-07-19 Microsoft Technology Licensing, Llc Data breakpoints on certain kinds of functions
GB201905835D0 (en) 2019-04-26 2019-06-12 Ibm On-premise and off-premise debugging
WO2021003870A1 (en) * 2019-10-14 2021-01-14 深圳晶泰科技有限公司 Distributed high-performance computing cluster-facing debugging system
CN113722204A (en) * 2020-05-26 2021-11-30 华为技术有限公司 Application debugging method, system, device and medium
US11922195B2 (en) 2021-04-07 2024-03-05 Microsoft Technology Licensing, Llc Embeddable notebook access support
US20240289252A1 (en) * 2023-02-27 2024-08-29 Gm Cruise Holdings Llc Deferred creation of remote debugging sessions

Citations (6)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
US6357019B1 (en) 1999-01-29 2002-03-12 International Business Machines Corporation Method and apparatus for employing network loadable debugging agents, capable of first failure support on retail versions of software products
US20040123271A1 (en) * 2002-09-26 2004-06-24 Jutta Bindewald Remote debugging through firewalls
US20060195894A1 (en) * 2005-02-25 2006-08-31 Microsoft Corporation Windows remote debugger service
US20090276482A1 (en) 2008-05-01 2009-11-05 Microsoft Corporation Automated offloading of user-defined functions to a high performance computing system
US7660412B1 (en) * 2005-12-09 2010-02-09 Trend Micro Incorporated Generation of debug information for debugging a network security appliance
US20100057865A1 (en) * 2008-09-04 2010-03-04 International Business Machines Corporation Transferable Debug Session in a Team Environment

Family Cites Families (46)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
US6058393A (en) * 1996-02-23 2000-05-02 International Business Machines Corporation Dynamic connection to a remote tool in a distributed processing system environment used for debugging
US5933639A (en) * 1996-05-17 1999-08-03 International Business Machines Corporation System and method for debugging distributed programs
US6986124B1 (en) * 1999-07-21 2006-01-10 Sun Microsystems, Inc. Debugger protocol generator
US6598067B1 (en) * 1999-07-26 2003-07-22 American Management Systems, Inc. Application server framework
JP2001051871A (en) * 1999-08-09 2001-02-23 Ricoh Co Ltd Remote debugging device
US20030204838A1 (en) * 2002-04-30 2003-10-30 Eric Caspole Debugging platform-independent software applications and related code components
US7185319B2 (en) * 2002-07-09 2007-02-27 Microsoft Corporation Debugging distributed applications
US7124320B1 (en) 2002-08-06 2006-10-17 Novell, Inc. Cluster failover via distributed configuration repository
US7530053B2 (en) * 2003-02-27 2009-05-05 Bea Systems, Inc. Methods utilizing a debugging proxy
US7441036B2 (en) * 2003-04-01 2008-10-21 International Business Machines Corporation Method and system for a debugging utility based on a TCP tunnel
JP4119295B2 (en) * 2003-04-07 2008-07-16 東京エレクトロン株式会社 Maintenance / diagnosis data storage server, maintenance / diagnosis data storage / acquisition system, maintenance / diagnosis data storage / provision system
US7197745B2 (en) * 2003-05-02 2007-03-27 Microsoft Corporation User debugger for use on processes running in a high assurance kernel in an operating system
US7814463B2 (en) * 2003-05-16 2010-10-12 Oracle International Corporation User interface debugger for software applications
US7412625B2 (en) * 2003-05-27 2008-08-12 American Megatrends, Inc. Method and system for remote software debugging
US20050050159A1 (en) * 2003-09-03 2005-03-03 Zeev Suraski Remote debugging of web applications
US8180845B2 (en) * 2003-12-17 2012-05-15 Sap Ag Remote debugging of software
US20050216895A1 (en) * 2004-03-23 2005-09-29 Tran Hieu T Method and apparatus for remote debugging of kernel and application software
US7512934B2 (en) * 2004-08-25 2009-03-31 Microsoft Corporation Parallel debugger
US20060161896A1 (en) * 2005-01-14 2006-07-20 International Business Machines Corporation Performing debug requests that are within the debug domain of a class loader
US20060174225A1 (en) * 2005-02-01 2006-08-03 International Business Machines Corporation Debugging a High Level Language Program Operating Through a Runtime Engine
US7673180B1 (en) * 2005-05-05 2010-03-02 Sun Microsystems, Inc. Method and apparatus for dispatching a remote debugging agent in a distributed computing environment
US7634760B1 (en) * 2005-05-23 2009-12-15 Netapp, Inc. System and method for remote execution of a debugging utility using a remote management module
US20070055957A1 (en) * 2005-09-07 2007-03-08 Richard Birenheide Remote debugging proxy
US7818623B2 (en) 2005-10-25 2010-10-19 Hewlett-Packard Development Company, L.P. Kernel debugging in a cluster computing system
JP4388518B2 (en) * 2005-11-01 2009-12-24 株式会社ソニー・コンピュータエンタテインメント Thread debugging device, thread debugging method and program
US7669186B2 (en) * 2005-11-16 2010-02-23 Sun Microsystems, Inc. Debugging applications at resource constrained virtual machines using dynamically installable lightweight agents
US20070168997A1 (en) * 2005-12-20 2007-07-19 Duong-Han Tran Debugging of remote application software on a local computer
US20080301685A1 (en) * 2007-05-31 2008-12-04 Novell, Inc. Identity-aware scheduler service
US8370839B2 (en) * 2007-07-20 2013-02-05 International Business Machines Corporation Monitoring message queues in message queuing information systems and initiating batch jobs to perform functions on the message queues
CN101360067B (en) * 2007-07-30 2012-11-07 国际商业机器公司 Group combination debugging system and method based on message transceiving system
US20090094684A1 (en) * 2007-10-05 2009-04-09 Microsoft Corporation Relay server authentication service
CN101159587A (en) * 2007-11-07 2008-04-09 华为技术有限公司 Method and system of remote exchange deployment
US8205120B2 (en) * 2007-12-21 2012-06-19 Sap Ag Intelligent test framework
US20090276754A1 (en) * 2008-05-01 2009-11-05 Kabira Technologies, Inc. Java virtual machine having integrated transaction management system
US8156476B2 (en) * 2008-06-10 2012-04-10 Microsoft Corporation Debugging support for tasks in multithreaded environments
US10169199B2 (en) 2008-06-10 2019-01-01 Microsoft Technology Licensing, Llc Automatic model-specific debugger extensions
US20090328005A1 (en) * 2008-06-27 2009-12-31 Microsoft Corporation Debugger call stack caching
CN101441579B (en) * 2008-12-02 2011-05-04 南京大学 Three-dimensional model library characteristic extracting method based on cluster computing system
US9703678B2 (en) * 2008-12-23 2017-07-11 Microsoft Technology Licensing, Llc Debugging pipeline for debugging code
US8346870B2 (en) * 2009-05-06 2013-01-01 Microsoft Corporation Low-privilege debug channel
US8407723B2 (en) * 2009-10-08 2013-03-26 Tibco Software, Inc. JAVA virtual machine having integrated transaction management system and facility to query managed objects
US8352621B2 (en) * 2009-12-17 2013-01-08 International Business Machines Corporation Method and system to automatically optimize execution of jobs when dispatching them over a network of computers
US8752017B2 (en) * 2010-05-17 2014-06-10 Salesforce.Com, Inc. Method and system for remote debug protocol proxying for production debugging; selective session and user routing for debugging in multi-tenant cloud computing infrastructure
US8856742B2 (en) * 2010-06-11 2014-10-07 International Business Machines Corporation Distributed debugging
US8589885B2 (en) * 2010-09-30 2013-11-19 Microsoft Corporation Debugger launch and attach on compute clusters
US8412984B2 (en) * 2010-11-12 2013-04-02 Microsoft Corporation Debugging in a cluster processing network

Patent Citations (6)

* Cited by examiner, † Cited by third party
Publication number Priority date Publication date Assignee Title
US6357019B1 (en) 1999-01-29 2002-03-12 International Business Machines Corporation Method and apparatus for employing network loadable debugging agents, capable of first failure support on retail versions of software products
US20040123271A1 (en) * 2002-09-26 2004-06-24 Jutta Bindewald Remote debugging through firewalls
US20060195894A1 (en) * 2005-02-25 2006-08-31 Microsoft Corporation Windows remote debugger service
US7660412B1 (en) * 2005-12-09 2010-02-09 Trend Micro Incorporated Generation of debug information for debugging a network security appliance
US20090276482A1 (en) 2008-05-01 2009-11-05 Microsoft Corporation Automated offloading of user-defined functions to a high performance computing system
US20100057865A1 (en) * 2008-09-04 2010-03-04 International Business Machines Corporation Transferable Debug Session in a Team Environment

Also Published As

Publication number Publication date
KR101855541B1 (en) 2018-05-04
JP5906246B2 (en) 2016-04-20
US8589885B2 (en) 2013-11-19
CN102523100A (en) 2012-06-27
EP2622484A4 (en) 2017-11-01
EP2622484A1 (en) 2013-08-07
CA2811002A1 (en) 2012-04-19
HK1170609A1 (en) 2013-03-01
US20120084753A1 (en) 2012-04-05
KR20130139897A (en) 2013-12-23
JP2013539131A (en) 2013-10-17
EP2622484B1 (en) 2020-03-18
CN102523100B (en) 2015-01-28

Similar Documents

Publication Publication Date Title
US8589885B2 (en) Debugger launch and attach on compute clusters
US7243352B2 (en) Distributed process runner
US9244817B2 (en) Remote debugging in a cloud computing environment
CN109561171B (en) Configuration method and device of virtual private cloud service
US8832271B2 (en) Identity provider instance discovery
US9817657B2 (en) Integrated software development and deployment architecture and high availability client-server systems generated using the architecture
US20100057865A1 (en) Transferable Debug Session in a Team Environment
JP6061936B2 (en) System and method for deployment with increasing demand for location neutral software
US7426729B2 (en) Distributed processing framework system
Aiftimiei et al. Design and implementation of the gLite CREAM job management service
US7624163B2 (en) Automatic configuration information generation for distributed computing environment
WO2019099260A1 (en) Assistive debugging of web applications with port forwarding
US20050091374A1 (en) Aspect oriented web service invocation
Lee et al. Itinerary-based mobile agent as a basis for distributed OSGi services
US10771283B2 (en) Virtual cloud node
US10587725B2 (en) Enabling a traditional language platform to participate in a Java enterprise computing environment
US9537931B2 (en) Dynamic object oriented remote instantiation
US20240106916A1 (en) Device and method for performing dynamic-service-oriented communication between vehicle applications on autosar adaptive platform
KR20040002624A (en) The Apparatus & Method to link Multi Protocol For Component Middleware In Real-Time
Klous et al. Transparent access to grid resources for user software
Pierantoni et al. Multi-grid and multi-vo job submission based on a unified computational model
JP2004062608A (en) Parallel processing system, server, parallel processing method, program and recording medium
van Nieuwpoort et al. Experiences Deploying Parallel Applications on a Large-scale Grid
Wenzel MetaEdge: an interoperable framework for the integration of edge computing platforms
CN118018349A (en) Distributed soft bus, communication method and medium

Legal Events

Date Code Title Description
121 Ep: the epo has been informed by wipo that ep was designated in this application

Ref document number: 11832947

Country of ref document: EP

Kind code of ref document: A1

ENP Entry into the national phase

Ref document number: 2811002

Country of ref document: CA

WWE Wipo information: entry into national phase

Ref document number: 2011832947

Country of ref document: EP

ENP Entry into the national phase

Ref document number: 2013531628

Country of ref document: JP

Kind code of ref document: A

Ref document number: 20137008236

Country of ref document: KR

Kind code of ref document: A

NENP Non-entry into the national phase

Ref country code: DE