3.2. Materializing a workspace using the Eclipse IDE

This section describes how to download the source code into a workspace, using the Eclipse IDE (the previous section describes how to create and configure the workspace).

Warning

You must set the target platform correctly, as described in the previous section. The default target (the running platform) must not be used.

3.2.1. Materialize the target platform and code base

Set-up for users not directly connected to the DLS network.

  • Define SSH tunnels to the DLS hosts (instructions here), and make a note of the local port numbers.
  • Before materializing the CQuery, go to the Properties tab and add two new keys (using the same port numbers as when you created the SSH tunnels):
    • diamond.dascgit.host.port=localhost:5022
    • diamond.p2.host.port=localhost:5080

Check out the target platform and code base

  1. File ‣ Open a Component Query and enter the appropriate URL (see the Reference Card)
    Set the Component Name field to the value for the parent component (see Buckminster components for a list of possible values)
    Set the Component Type field to the value for the parent component, if you know it
    Change any other values on the Properties tab as required (see Buckminster properties). You need to add property key github.authentication and its value to anonymous for org.dawb in dawn-common.git.
  2. Click Resolve and Materialize. You can close the CQuery after materialization completes.
    This downloads the specified component and all its dependencies to the Eclipse workspace, and imports them as Eclipse projects.
    The target platform components will be materialized in the tp project in the workspace.

Notes

If Eclipse prompts you to Enter Username and Password for https://svn.diamond.ac.uk, you must select the Save Password option; otherwise you will be prompted with repeated requests for your credentials. For more information on where your password is saved, and how to keep it secure, see Subversion security.