A product of Rift Web Design
- Java 8 (JNLP/Web Start compatible)
- 512MB Ram (larger projects will require more memory)
- Firefox / Chrome
- Lucee Web Service (AdobeCF not yet supported)
This section covers the setup of Coldbug.
Coldbug uses JNLP / Web Start technology to launch from a browser.
- Download the file from the website (https://getcoldbug.com) by clicking “Run Now”. This will download a file named jnlp.cfm.
- Navigate to the file from a CLI and launch the web start file.
Note: this requires that Java is accessible from CLI.
Example (Windows 10):
- This will install the necessary files and display a Security Prompt. Click “Run” (Do not show this again… is optional).
- On supported Operating Systems, this will immediately launch the application in the default web browser. On unsupported systems, navigate to “http://localhost:4567/”
Note: if you receive a message “Only 1 debugging session can be active at a time.”, and no other tabs have this open, refresh the browser window.
If this is your first time using the application, you will need to register and get logged in. You should then be on “Projects” screen.
- Click on add project. Which takes us into the Project Settings page. Fill in the form, use the below screenshot as a reference. Note: on Linux OS use absolute path, do not use the tilde character in the path, IE ~/Documents should be /myname/Documents. Linux paths are also case sensitive.
- The local and remote directories are a mapping for Coldbug to find the files at the specified local location based on the remote directory. IE, if your Project Root is at C:/mylocalproject/, this would be the local directory. If you are debugging a local instance the remote directory would also be C:/mylocalproject/. If debugging a remote instance, it will create the translation from remote to local, so C:/myremoteproject/index.cfm will look for index.cfm in C:/mylocalproject/.
- Directory maps should include the “Mappings” of directories found inside of the Lucee admin “Mappings” section. IE, C:/mysharedlibrary maps a virtual directory as /shared. This would need to be added with the local and remote directories to C:/mysharedlibrary. This allows the files to load so breakpoints can be added or the files can be stepped over.
- After adding the project you will have a new project in the list.
- Open the project and you will not be in the debugger screen.
Java options must be added to the web service before Coldbug can attach to it for debugging. The next subsections will explain how to setup these options for various server types. If your server is not listed, and you need help to get it setup, please send an email to firstname.lastname@example.org to request the setup information be added.
The java options that will be used is:
Java Opts: -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=
Example: -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=7999
If you already have lucee express running, skip steps 1 and 2.
- Download the Lucee express zip file.
- Unzip the file and configure your web instances.
- Navigate to the bin directory and find Catalina.bat (Catalina.sh for linux).
- From a CLI execute the follow:
./catalina.bat jpda start
- Scroll to the top of the window and find the port that was opened for debugging.
Listening for transport dt_socket at address: 8000
- Update your project configuration in Coldbug and set the port to this value: 8000.
- Save the project.
- Open the project.
- Click the play button to attach to the server.
If you already have command box running, skip steps 1 and 2.
- Download and setup command box with the lucee web service.
- Configure your web instances.
- Load into box from CLI (this assumes box is part of your PATH):
- Navigate to your project.
- Execute the startup script with java options
- You can specify the port number in the arguments to match the port number you have added to settings, if it is a port other than 7999 (replace address=[port] in the screenshot above).