======================================================= Installing the Data Platform Module ======================================================= The Data Platform comes as a zipped file that contains the following: * Orchard.Module.NetworkedPlanet.DataPlatform.Orchard.1.x.x.x.nupkg * Orchard.Module.NetworkedPlanet.DataPlatform.Orchard.ContentParts.1.x.x.x.nupkg * Config directory * EULA (End User License Agreement) * Acknowledgements * Documentation The location where you unzip this file is referred to in the following section as ``[INSTALLERDIR]`` 1. Install Orchard ******************* .. warning:: To successfully install the Data Platform module, you must install Orchard via a download of the complete source, or via the Web Platform Installer in IIS tools. The Data Platform is **not currently compatible** with an installation of Orchard CMS from a zip of the Orchard.Web directory that is also offered by Orchard. Follow the `Orchard CMS documentation `_ to install Orchard as a new website within IIS. The Data Platform 1.0 is compatible with Orchard CMS version 1.9.1 .. note:: To follow this installation guide you must add ``Modify`` access to the Orchard Modules folder for the group ``IIS_IUSRS``. On a production server, you should remove this permission after installing the Data Platform. 2. Upgrade Orchard Assemblies ***************************** The Data Platform requires a newer version of the Newtonsoft.JSON.dll than is provided by default with Orchard 1.9.1. Copy the file ``[INSTALLERDIR]\\config\\bin\\Newtonsoft.JSON.dll`` to the ``bin`` directory of the Orchard website, replacing the existing file in that directory. Open the ``Web.config`` file for the Orchard website and locate the following lines:: Update the ``oldVersion`` and ``newVersion`` attributes of this entry so that they refer to version 7.0.0.0 like this:: Save your changes and then restart the website for this change to take effect. 4. Create and set up the Download directory ******************************************* Navigate to the root folder of your website and create a folder called ``Download`` .. figure:: /images/downloaddir.png :scale: 90 % :alt: Download Directory Copy the ``web.config`` file from the directory ``[INSTALLERDIR]\\Config\\Download`` into this ``Download`` directory. Make sure that the group ``IIS_IUSRS`` has read and write access to this folder. 5. Create the Import directory ****************************** Navigate to the root folder of your website and create a folder called ``Import``. Make sure that the group ``IIS_IUSRS`` has read and write access to this folder. 6. Add the Data Platform License File ************************************* You can run the Data Platform on a server and run it on a website using the localhost domain without a license file. However to publish your site it requires a license file from Networked Planet. The license file is a file named ``NetworkedPlanet.DataPlatform.Orchard.lic``. Place this file in the root directory of your website. See the `Data Platform pricing page `_ for more details about license features and costs, including our discounts for not-for-profit organisations. 7. Install BrightstarDB *********************** Download the `BrightstarDB installer `_ and run to install the BrightstarDB triple store on your server. The Data Platform 1.0 is built with BrightstarDB 1.11.0 and should be compatible with all 1.x.x releases from 1.11.0 onwards. 8. Install the Data Platform **************************** Open the Orchard CMS website in your browser and login to the dashboard. Navigate to the Modules page, and click the "Installed" tab. Click "Install a module from your computer" and browse to where you extracted the Data Platform installer directory, and select the **Orchard.Module.NetworkedPlanet.DataPlatform.Orchard.1.x.x.x.nupkg** file. .. image:: images/Install.png When the module has installed, you can immediately enable it. 9. [OPTIONAL] Install the Data Platform Content Parts Module ************************************************************ The Content Parts Module contains some additional Orchard content parts for presenting RDF data in a user-friendly manner. You can optionally install this module - it is not required for the correct operation of the Data Platform. Open the Orchard CMS website in your browser and login to the dashboard. Navigate to the Modules page, and click the "Installed" tab. Click "Install a module from your computer" and browse to where you extracted the Data Platform installer directory, and select the **Orchard.Module.NetworkedPlanet.DataPlatform.Orchard.ContentParts.1.x.x.x.nupkg** file. When the module has installed, you can immediately enable it. 10. Configure the BrightstarDB settings *************************************** Before you can create any datasets, you must first set the connection to the BrightstarDB server, this is found in the main Settings page of Orchard CMS. .. figure:: /images/settings.png :scale: 90 % :alt: Data Platform Settings **BrightstarDB Connection String** Information about BrightstarDB connection strings can be found in the online `BrightstarDB documentation `_ . For example, the following could be used as an embedded connection to the BrightstarDB server using a data directory located at ``C:\\Brightstar``:: Type=embedded;StoresDirectory=c:\Brightstar The following would be used as a REST connection to a locally installed BrightstarDB server (note that the Store Name is not included in this connection string):: Type=rest;endpoint=http://localhost:8090/brightstar; We recommend using the REST connection to a BrightstarDB server. You may also choose to locate your BrightstarDB server on a different machine from the web server - if so please ensure that the port used by BrightstarDB (by default 8090), is open for connections from the web server machine.