Enter the name for the launch configuration in the Name field.
In the Configuration tab
Project field: select the project to debug
Only Perl projects (projects associated with a Perl nature) will be shown. If the project you require is not shown, see the section called “Converting an Existing Project” for adding a Perl nature to your project.
File to execute field: select the Perl file to execute
Only files associated with the Perl editor will be shown. See the section called “Associating Files with the Perl Editor” for details.
Commadline Parameters field: enter command line parameters to pass to the selected Perl script
Press the
buttonEnter the name for the launch configuration in the Name field.
In the Web Server tab
HTML Root Directory field: enter the base directory that contains all HTML files or use the button to select the appropriate directory.
HTML Startup File field: enter the file name to be shown in the browser after startup or use the button to select this file.
CGI Root Directory field: enter the base directory that contains all CGI files or use the button to select the appropriate directory.
Extension for CGI files field: this is a comma separated list of file extensions (each starting with a "." ) used for CGI files in the project.
In the CGI Environment tab
CGI-Script Environment Variables
field: sorted list of environemt variables to be set for CGI
scripts to be executed. Use the following syntax to specify
environment variables:
name=value
.
In the Browser tab, there are two possible settings:
Select Custom Browser: specify the
path to the browser executable and add the required command
line parameters. Use %1
as a place holder
for the HTML file to be opened.
Select Default System Browser to use the browser defined as default browser by your OS preferences.
Press the
button.Some points to consider:
You need a Perl interpreter installed on your target machine.
The EPIC debugger opens a network connection between local and remote host (port number can be specified in the corresponding launch configuration). So have a look at your firewall configuration.
Scripts executed and code shown are from different sources: EPIC displays the code present on your local machine and executes a copy of this code on the remote host. So if you make changes within your project please make sure to transfer these changes to the remote host (see below for further details).
This problem gets more significant for code/modules provided by your Perl installation. If modules on your local and remote machine differ, debugging results may be quite meaningless. So try to have the same Perl version installed on both machines and make sure all modules you require (and are not part of your Eclipse project) are identical.
@INC path handling: if the include path references directories within your project or directories that are linked into your projects, EPIC will include these modules in the list of files to be copied to the remote host and adjust the @INC-path for your remote machine accordingly.
Enter the name for the launch configuration in the Name field.
In the Configuration tab
Project field: select the project to debug.
Only Perl projects (projects associated with a Perl nature) will be shown. If the project you require is not shown, see the section called “Converting an Existing Project” for adding a Perl nature to your project.
File to execute field: select the Perl file to execute.
Only files associated with the Perl editor will be shown. See the section called “Associating Files with the Perl Editor” for details.
Local Host IP: this is the IP-address used by the remote host to connect to your local machine. In most cases the default value is appropriate.
Target Host Project Installation Path: the location on the remote machine, where your Eclipse project should be copied to.
Port: Port used to transfer data between local and remote host.
Create Debug Package: if checked, a ZIP file containing all data to be transfered to the remote machine is created. This file is stored at the location indicated in Debug Package File Path.
Press the
button.Extract the ZIP file to the location on your remote machine indicated in Target Host Project Installation Path.
Start the script start_epicDB.pl on your remote machine (it is located in the directory indicated by Target Host Project Installation Path).
Enjoy debugging...