Creating a Remote C/C++ Project

After you have created a connection to an AIX or Power Linux server, you are ready to create a remote C/C++ project.

To create a project for your C/C++ files on the remote host, use the Remote C/C++ Project wizard.

  1. To create a new Remote C/C++ Project begin by opening the New Remote C/C++ Project wizard by going to File > New > Remote C/C++ Project.

    File > New > Remote C/C++ Project


  2. Enter the project name.

    Enter Project Name


  3. Click the Browse button to browse for the remote location (on AIX or Power Linux machine) of the project in Remote Location. Use the Connection field pulldown to select your remote host.

    Browse for Folder


  4. Locate and select the location of the remote project's root folder. Click OK.

    Project Root Folder

    NOTE: Do not create projects pointing to the same project location on the remote host in multiple IDEs. This will cause unexpected behavior to occur.


  5. Check the Associate a local location checkbox if you wish to have a local project. If you wish to use source control (see Working with Rational Team Concert for additional configuration information), work disconnected from the remote machine, or wish to use a mounted folder, you will want a local project.

    Associate local location option

    If you wish to use a location other than the default, uncheck Use default location.


    File synchronization options:

    If you are not using a mounted directory, select Work with local copy of files and push file changes to remote location.

    If you are using a mounted directory, and this directory corresponds to the remote location, select Local location is a mounted folder pointing to the remote location.

    NOTE: If the location is a mounted version of the remote location and you do not select this option, your files will not synchronize properly and the C/C++ Indexer will not be properly invoked when your files change.



  6. Click Next to configure the project options.

    Configure Project Options

    Choose either C or C++ for the language option.


    If you would like to create your own makefile, choose Makefile project, otherwise select Managed Build to have a makefile generated for you. The options available for a managed build project are further explained here.


    NOTE: The generated makefile currently supports GNU make only.



    The Tool Chains section shows which tool chains are available for your project.



  7. Click Next to configure additional project options.

    Configure Build Options

    The build command is the build command to be used to build your project; the build directory is the location where the build output is to be stored; the compiler executable directory is the location where the compiler executable can be found.



    To import an off-line index from the remote system for the new project, browse for the off-line index zip file. For more information, see Creating/Importing an Offline Index.

    Choosing Do not index project until the project has been built will prevent the indexer from launching until the project has been built.



  8. Click on Advanced ... to edit the configuration for the C/C++ Indexing service and/or the Build service. For more information, see Service Providers.

    C/C++ Indexing Service


    Build Service
    When you have finished your edits, click OK.


  9. Click Finish in the Remote C/C++ Project wizard to create the remote C/C++ project. Creating the project may take a few minutes. Once the project has been created it will appear in the Project Explorer view.

    Remote Project in Project Explorer View


Once you have created the remote C/C++ project, you are ready to create a C or C++ file.



Related tasks
Connecting to an AIX server
Connecting to a Power Linux server
Import Remote C/C++ Projects
Creating a C or C++ source file
Editing a C or C++ File
Creating a makefile
Building a C/C++ project