Release Notes for the Examples
.png "patterns & practices Developer Center")
| On this page: | Download: |
|---|---|
| System Requirements | Notes | To Deploy a VMDepot Virtual Machine in the Cloud | Known Issues |
|
.png "Download code samples")
.png "Download PDF")
.png "Order Paperback")
System Requirements
To install and run the reference implementation, you must have the following software installed:
Microsoft Windows 7 with Service Pack 1, Microsoft Windows 8, Microsoft Windows Server 2008 R2 with Service Pack 1, or Microsoft Windows Server 2012 (32 bit or 64 bit editions).
Microsoft Internet Information Server (IIS) 7.0 or later.
Microsoft Windows PowerShell 3.0, available as part of the Microsoft Windows Management Framework 3.0.
Microsoft Visual Studio 2012 Ultimate, Premium, or Professional edition.
Windows Azure SDK for .NET, version 2.0 or later (includes the Windows Azure Tools for Visual Studio).
Note
This is only required for the DAG.Azure solution
(Optional) Microsoft SQL Server 2012 if you don't wish to use SQL Server Express LocalDB provided with Visual Studio 2012.
(Optional) If you wish to deploy the solution to Windows Azure, you will also need a Windows Azure subscription.
To install either solution using NoSQL databases, you must have the following additional software installed and configured:
- MongoDB (version 2.2.3 or later).
Note
The sample solution runs using a default configuration of MongoDB. For more information about installing MongoDB, visit the MongoDB website.
If you have a Microsoft Windows Azure subscription, you can create a virtual machine running MongoDB in the cloud. Microsoft Open Technologies provide a prebuilt virtual machine image that you can configure and deploy. For more information, see the section To Deploy a VMDepot Virtual Machine in the Cloud later in this document. You can find additional information about the Microsoft Open Technologies online.
Scripts supplied with the sample code create and populate the database. For more information, see the Readme file included with the sample solution.
- Neo4j (version 1.8 or later).
Note
Neo4j requires that you have installed the Java Runtime Environment on your computer. For more information about installing and configuring Neo4j, visit the Neo4j website.
If you have a Microsoft Windows Azure subscription, you can create a virtual machine running Neo4j in the cloud. Microsoft Open Technologies provide a prebuilt virtual machine image that you can deploy. For more information, see the section To Deploy a VMDepot-based Virtual Machine in the Cloud later in this document. You can find additional information about the Microsoft Open Technologies online.
Scripts supplied with the sample code create and populate the Neo4j database. For more information, see the Readme file included with the sample solution.
For instructions on how to configure and run the example solution, see the Readme file.
Notes
- The solution includes a web service and a web application that provides the user interface. You can connect to the web application by using Internet Explorer 10, Chrome, and Firefox. Other browsers, including Internet Explorer 9, Internet Explorer 8, and earlier, are not supported.
- Ensure that you have installed all applicable updates for your computer from Windows Update before installing the prerequisites listed above.
- You must run the projects and solutions under an account that has Administrator privileges.
- Other components and frameworks required by the examples are installed using NuGet when you build the solutions.
- The sample code is not designed to be reused in a production application.
To Deploy a VMDepot Virtual Machine in the Cloud
To deploy a VMDepot virtual machine in the cloud, step through the following procedure in the order shown:
Download and install VMDepot Command Line Tools if they are not already installed on your computer.
Download and install PuTTY if it is not already installed on your computer.
Search for the specific NoSQL image on VMDepot that you would like to install.
- For Neo4j, the Neo4j Community 1.8 on Ubuntu 12.04 LTS image can be used.
- For MongoDB, the MongoDB v2.2.3 on Hardened Ubuntu 12.04 LTS.
After selecting a specific VMDepot virtual machine, click the “Deployment Script” link at the top of the page.
Agree to the Terms of Use.
Select the Windows Azure Deployment Region from the drop-down where you would like the virtual machine deployed. This will generate a command-line to use with the VMDepot Command Line Tools that will deploy the virtual machine. Copy the generated command line to the clipboard.
Run a command prompt to use the VMDepot Command Line Tools and paste the previously copied command line into the command prompt. Follow the instructions to deploy the virtual machine.
Note
It is strongly recommended that you use the "--ssh" command line switch to automatically configure SSH so you can use PuTTY to remotely connect to the deployed virtual machine.
Once the virtual machine deployment is complete, follow any image-specific instructions to configure the virtual machine for use. Typically, this will involve opening ports in the firewall for the virtual machine. The firewall configuration can be found on the Windows Azure Portal for the deployed virtual machine.
Known Issues
The reference implementation does not use a secure channel to communicate with some of the data sources. This was deliberate to ease deployment and running of the reference implementation. In a production environment, all communication should be done over a secure channel. Please visit the following locations to learn how to configure secure communication for the various data sources.
For more information on securing MongoDB in a production environment, see the MongoDB documentation.
Read the current documentation for the selected MongoDB driver to enable SSL and authentication to the MongoDB Server.
For more information on securing Neo4j in a production environment, see the Neo4j documentation.
For more information on securing ASP.NET MVC and ASP.NET Web API, see the following: