# Building and Running VxWorks Samples

> To build samples using the VxWorks Workbench, please perform the following steps:

> > 1. Unpack the eXtremeDB package (see instructions here).

> > 2. Start the WindRiver Workbench IDE

> > 3. Create a new workspace:

> > > From the menu choose “File”, then the “Switch Workspace” and “Other” menu items. The IDE will display a “Workspace Launcher” window. Choose the new workspace location and click “OK”. (For example choose the “samples” directory of the eXtremeDB installation.)

> > 4. Right-click the “Project Explorer” pane (on the left by default) and choose the “Import…” menu item.

> > 5. In the “Import” window choose “Existing Projects into Workspace” and click “Next”.

> > 6. Choose the “Select root directory” radio-button and specify the import directory. (For example select the `samples` directory of the eXtremeDB installation.)

> > 7. Select interesting samples or use the “Select All” button to mark all existing samples. (Do not check the “Copy projects into workspace” checkbox if the workspace is in the “samples” directory. If the workspace is located somewhere else this box can be checked to cause the IDE to copy the samples source code files and preserve the original files unchanged.)

> > 8. Click the “Finish” button to complete the import process. This will create a projects tree in the “Project Explorer” pane.

> > 9. Select a sample project with a mouse click.

> > 10. Select the active build target using menu “Project”/“Build Options”/“Set Active Build Spec”/<TARGET NAME>. (The target name could be “SIMNTgnu”/“SIMNTdiab” or the hardware platform name.

> > 11. Also here select the “Debug” or “Release” build option.

> > 12. Build the sample with the “Project”/“Build Project” menu options.

## Running SDK Samples

> To run VxWorks samples perform the following steps:

> > 1. Connect to your target or use the local simulator. The target (or the SIM) name will appear in the “Remote Systems” pane in the bottom left corner by default. To connect to your target, right click on the target title and choose the “Connect ‘<target name>’” menu item.

> > 2. Select the sample project in the “Project Explorer” pane; expand the project’s tree; choose the “Build targets” item and right-click on the sample binary name. In the menu choose “Debug VxWorks Kernel Task” or “Run VxWorks Kernel Task” for DKM-packages, or “Debug VxWorks Task” or “Run VxWorks Task” for RTP-packages. In the next window use the default settings and click OK.

> > 3. The IDE will start the target console window. The sample will print output to the console.

> > 4. It is possible to adjust the process settings in the project properties window. To get to the window right click on the project name in the “Project Explorer” pane and select the “Properties” menu item at the bottom of the menu. In the properties windows notice the “Build Properties” item. This item opens the build and link properties tabs where it is possible to modify/adjust the include and libraries paths, compiler options, compiler defines, etc.

> > If the IDE reports linkage errors during the download stage, make sure that all the necessary eXtremeDB libraries were enumerated in your project properties. All of the samples are provided ready to compile and run. For instructions and comments on the individual samples please follow the links here.