RubyMine 2016.3 Help

Attaching to Local Process

On this page:

Introduction

Attach to local process feature allows you to debug a project which you are developing in RubyMine, but (for some reasons) are not able to launch directly from your IDE.

Note that Attach to process works only for MRI Rubies version 2.0 and higher.

Prerequisite for OS X users

Attach to process uses in its work the Python module six, which may be missing in your OS X installation.

If six Python module is not installed, then install it using any method of your convenience, for example pip install six. Refer to this page for details.

Attaching to local process

To attach to a local process, follow these general steps:

  1. Launch the process intended for debugging. You can do it from operating system or using the RubyMine terminal.
  2. To find the process to attach to, do one of the following:
    • On the main menu, choose Run | Attach to Local Process:
      /help/img/idea/2016.3/attachMainMenu.png
    • On the main menu, choose Help | Find Action or press Ctrl+Shift+A. In the list of actions that appears, find the desired action by typing the first letters, and select it:
      /help/img/idea/2016.3/attachFindAction.png
  3. From the list of available processes that appears, select the desired process. Simplify your search by typing the first letters of its name or PID
    /help/img/idea/2016.3/rm_attachToProcess.png
  4. Proceed with debugging the same way as you usually do it in RubyMine (set breakpoints, step through, pause and resume the process, evaluate expressions etc.)
  5. When finished, detach the process: select the Run | Stop or click the Stop the process button /help/img/idea/2016.3/stop.gif of the Debug Tool Window .

See Also

Last modified: 24 December 2016