KrishnaVandanu

<div dir="ltr" style="text-align: left;" trbidi="on"><br /><div class="accordion-heading"><br /></div><br /><a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseOne" data-toggle="collapse" href="http://www.blogger.com/null"> Dreamfactory Service Platform<br />                </a><br />            <br />            <br /><br /><div class="accordion-body in collapse" id="collapseOne" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#dreamfactory-services-platform"> Dreamfactory<br />                            Services Platform Overview</a></li><br /></ul><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseTwo" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     Developer Features<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseTwo" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#feature-cors"> CORS support</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#feature-NoSQL"> NoSQL Access</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#feature-provider"> Authentication Providers</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#feature-rfs"> Remote File Storage</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseThree" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     Live Rest API<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseThree" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list "><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#rest-api"> Swagger Live Rest API</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseFour" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     DSP Free Edition<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseFour" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#dsp-account"> Account Setup</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#dsp-access"> Creating Your DSP</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#dsp-management"> Manage Your DSP</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseFive" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     Admin Console User Guide<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseFive" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-overview"> Admin Console Overview</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#admin-apps"> Applications</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#admin-users"> Users</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-roles"> Roles</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-groups"> Groups</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-data"> Manage Data</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#admin-services"> Services</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#admin-files"> Files</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-schema"> Manage Schema</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-packages"> Packages</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#admin-sysconfig"> System Config</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseSix" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     DSP on Your Cloud<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseSix" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#cloud-azure"> Windows Azure</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#cloud-ec2"> Amazon EC2</a></li><br /><li class="active"><a href="https://www.dreamfactory.com/developers/documentation/main#cloud-vagrant"> Vagrant</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseSeven" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     DSP on an Existing System<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseSeven" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#local-ubuntu"> Debian or Ubuntu System</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#local-centos"> CentOS or Redhat system</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="span10 offset1" style="text-align: left;"><br /><br /><br /><section><article about="/developers/documentation/main" class="node node-developers clearfix" id="node-99" typeof="sioc:Item foaf:Document"><div class="field field-name-body field-type-text-with-summary field-label-hidden"><br /><div class="field-items"><br /><div class="field-item even" property="content:encoded"><br /><div class="row-fluid" id="dspdocs-area"><br /><div class="span9" data-offset="400" data-spy="scroll" data-target="#leftMenu" id="docDiv" style="height: 600px; overflow-y: scroll;"><br /><br /><br /><section><div id="dreamfactory-services-platform"><br /><h2><br />DreamFactory DSP</h2><br />The DreamFactory Services Platform (DSP) is a powerful open-source mobile services platform that provides all<br />            the back-end infrastructure required to build cutting edge enterprise applications for the desktop, tablet,<br />            or phone. All of your services are accessed through a REST interface that supports both JSON and XML<br />            documents. This style of document exchange interface is perfect for HTML5 applications or native client<br />            technologies like iOS. Here are a few of the key features provided by every DSP.<br /><br /><b>Admin Console</b> - Each DSP comes with a built-in admin console for managing all aspects of the<br />            DSP including applications, users, roles, and services.<br /><br /><b>Application Hosting</b> - A DSP can host any number of applications. Each application is similar<br />            to a mini web site. You can easily upload and manage each application's files and folders from the admin<br />            console.<br /><br /><b>User and Role Management</b> - The DSP takes care of user management, single sign-on, and user<br />            roles. You can define roles to control user access to applications, database tables, and services.<br /><br /><b>SQL Services</b> - Your DSP provides a comprehensive and secure connection to a dedicated SQL<br />            database. You have services for Create, Read, Update and Delete, as well as complex filtering and a complete<br />            suite of metadata services. The ability to query across object relationships is supported.<br /><br /><b>BLOB Storage</b> - Your DSP provides interfaces to all of the major BLOB storage systems<br />            including S3 and Azure BLOB. The master credentials to each service are hidden by the platform and users are<br />            granted access through single sign-on.<br /><br /><b>External Integration</b> - Your DSP can provision any number of integration points for external<br />            services such as email, NoSQL data, and remote BLOB storage. These services hide master credentials on the<br />            platform and can be administered by user role.</div><br /></section><br /><br /><section><br /><h2><br />Developer Features</h2><br /><br /><div id="feature-cors"><br /><div class="page-header"><br /><h3><br />CORS support</h3><br /></div><br />Developers prefer to write codes in an environment they are familiar with where debug tools and test suites are<br />        readily available. By enabling CORs support a developer can run apps from outside their dsp and still<br />        leveragethe power of our REST API.<br /><br />To Enable CORS support log in to your DSP and click on the System Config menu item on the left hand side. On the<br />        System Config screen you will see the CORS Access options. Setting * will allow you to work from your desktop or<br />        anywhere. You may also use your localhost server, or another DSP or remote server you wish to have access to<br />        your data or service. Having the allowed verbs checkboxes enforces another layer of access control by locking<br />        down the entire DSP to use only the verbs checked for CORS. <br /><br />To use CORS without logging in, you will also have to allow for Guest Access, and create a Role for guest user<br />        access. This way you can limit any guest access to only database tables or services you see fit.<br /><br />If you’d like to pass authentication instead of having a guest role, consult our Swagger API docs here for the<br />        latest API call for logging in a user (see the /user/session POST request). That POST will return a session_id<br />        that you can pass as a new header called X-DreamFactory-Session-Token with all your future API requests. You<br />        will also need to include the API name you created with your application as X-DreamFactory-Application-Name if<br />        you haven’t already.<br /><br /><img alt="DSP Create Service" src="https://s3.amazonaws.com/dfImages/dsp-svc-cors.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /></div><br /><br /><div id="feature-NoSQL"><br /><div class="page-header"><br /><h3><br />NoSQL Access</h3><br /></div><br /><div><br /><div><br /><h4><br />No SQL Highlights</h4><br />Securely store any credentials required to access your storage on the server-side, relieving your app from<br />        maintaining it.<br /><br />We remove any cross-site hoops your app would have to handle by making it a “native” REST service on the<br />        DSP. <br /><br />Provide a common, fully REST-based API to each of the supported NoSQL service types and use a common data<br />        format layout, using JSON, for data entry and retrieval.<br /><br />We also provide a common SQL-like filtering language, making it dirt simple to find the data you need.</div><br /><div><br /><h4><br />Overview</h4><br />Each flavor of NoSQL has a unique way of defining how data id stored. Azure calls them “tables” as does AWS,<br />        that is for DynamoDb, but for SimpleDb, they are called “domains”. For CouchDb, they are called “databases”,<br />        not to be confused with MongoDb's “databases” which stores your data in what they call “collections”. While<br />        each vendor calls them something different, we will refer to them collectively as “tables”. These are the<br />        things that group your sets of data together or partition them, however you seeit. You can actually manage<br />        most aspects of the table administration through the REST API. <br /><br />Currently, each DSP supports Amazon Web Services' SimpleDB and DynamoDB, Windows Azure's Tables, MongoDB and<br />        CouchDB.</div><br /><div><br /><h4><br />Service Setup</h4><br />To create a new NoSQL service, select services from the admin console left navigation menu. In the type<br />        dropdown menu select NoSQL DB. Enter the Service Name, Api Name and Description. Then select the Appropriate<br />        NoSQL Type. The required fields for each NoSQL Type are outlined below.<br /><br /><img alt="DSP Create Service" src="https://s3.amazonaws.com/dfImages/dsp-svc-create-nosql.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /></div><br /><div><br /><h4><br />Amazon DynamoDB</h4><br />To complete the setup of your NoSQL service select Amazon DynamoDB from the NoSQL Dropdown. <br /><br />Enter your AWS Access and Secret Key. <br /><br />Select the AWS Region that will host your DynamoDB. <br /><br />Click <a class="external text" href="http://docs.aws.amazon.com/fws/1.1/GettingStartedGuide/index.html?AWSCredentials.html" rel="nofollow">here</a> for instructions on locating your Access Key and<br />        Secret Key.<br /><br /><img alt="DSP NoSQL DynamoDB" src="/sites/all/themes/dreamfactory/docs/img/dsp-nosql-dynamo.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br /></div><br /><div><br /><h4><br />Amazon SimpleDB</h4><br />To complete the setup of your NoSQL Service select Amazon SimpleDB from the NoSQL Dropdown. <br /><br />Enter your AWS Access and Secret Key. <br /><br />Select the AWS Region that will host your SimpleDB. <br /><br />Click <a class="external text" href="http://docs.aws.amazon.com/fws/1.1/GettingStartedGuide/index.html?AWSCredentials.html" rel="nofollow">here</a> for instructions on locating your Access Key and<br />        Secret Key.<br /><br /><img alt="DSP NoSQL SimpleDB" src="/sites/all/themes/dreamfactory/docs/img/dsp-nosql-simpledb.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br /></div><br /><div><br /><h4><br />Windows Azure Tables</h4><br />To setup your NoSQL service select Windows Azure Tables from the NoSQL Dropdown. <br /><br />Enter your Azure Account Name and Account Key<br /><br />Click <a class="external text" href="http://www.windowsazure.com/en-us/manage/services/storage/how-to-manage-a-storage-account/#regeneratestoragekeys" rel="nofollow">here</a> for instructions on locating your Account Name and Account<br />        Key.<br /><br /><img alt="DSP NoSQL Azure Tables" src="/sites/all/themes/dreamfactory/docs/img/dsp-nosql-azuretables.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br /></div><br /><div><br /><h4><br />CouchDB</h4><br />To setup your NoSQL service select CouchDB from the NoSQL Dropdown.<br /><br />In the connection string enter the host name of your mongo instance. For example couch.dreamfactory.com; if<br />        your CouchDB is running on a different port than 5984 you can append the port number to the host name ie.<br />        couch.dreamfactory.com: 5984.<br /><br />The Database field is the location in CouchDB where the collection you wish to access is located.<br /><br />The fields username and password are optional. These values can be left blank unless they are required by<br />        your CouchDB deployment.<br /><br /><img alt="DSP NoSQL CouchDB" src="/sites/all/themes/dreamfactory/docs/img/dsp-nosql-couchdb.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /></div><br /><div><br /><h4><br />MongoDB</h4><br />To setup your NoSQL service select MongoDB from the NoSQL Dropdown.<br /><br />In the connection string enter the host name of your mongo instance. For example mongo.dreamfactory.com; if<br />        your MongoDB is running on a different port than 27017 you can append the port number to the host name;<br />        mongo.dreamfactory.com:28017.<br /><br />The Database field is the location in MongoDB where the collection you wish to access is located.<br /><br />The fields username and password are optional. These values can be left blank unless they are required by<br />        your MongoDB deployment.<br /><br /><img alt="DSP NoSQL MongoDB" src="/sites/all/themes/dreamfactory/docs/img/dsp-nosql-mongo.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /></div><br /><div><br /><h4><br />Verifying your NoSQL Configuration.</h4><br />The easiest way to verify your access to your NoSQL service is to use our api documentation tool, Swagger. To<br />        access swagger press the script button next to the NoSQL service name. To explore the service in depth press<br />        the HTTP Verb you would like to execute.<br /><br />The HTTP verb 'POST' is used for creating new entities, 'PUT' is used for replacing the whole content of an<br />        entity and 'PATCH' is used to merge in changes to an entity ('PATCH' and 'MERGE' HTTP verbs are used<br />        interchangeably in the REST API). Also, as with the other DSP services, if your transport layer only accepts<br />        'GET' and 'POST' verbs, using a 'POST' command while setting either a url parameter, 'method=PATCH', or a<br />        header, X-HTTP-Method = PATCH will “tunnel” the command through properly.</div><br /><div><br /><h4><br />Retrieving Records using Swagger</h4><br />When it comes to making your NoSQL data available to your app, our REST API provides several different<br />        methods to get just the data sets you want, when you want it. Below are the available options for a GET<br />        request on a particular table.<br /><br />The table name is sent as part of the url, while the other options are sent as url parameters. If url<br />        parameters are not your cup of tea, you can send most of them as posted data (using POST request with<br />        X-HTTP-METHOD = GET as mentioned earlier. Note that the “record” parameter can only be sent in this way.).<br />        Most of them are self explanatory, but a few may need clarification.<br /><br /><table class="table-striped table-condensed"><br />        <tbody><br /><tr><br />            <td>ids</td><br />            <td>This is a comma delimited list of unique identifiers (think primary key) values for retrieving<br />                    multiple records at a time. If passed as POST data, this can also be an array of ids. In the<br />                    case where they is no static identifier field (DynamoDb), use of the “id_field” parameter is<br />                    necessary to indicate which field these values belong to.</td><br />        </tr><br /><tr><br />            <td>filter</td><br />            <td>This is where you use our simple SQL-like filter string. Comparison operators supported on every<br />                    platform are ' = ', ' != ', ' > ', ' >= ', ' < ', ' <= '; or as their SQL short form ' eq ', '<br />                    ne ', ' gt ', ' ge ', ' lt ', ' le '. Depending on the dbvendor, others such as ' contains ', '<br />                    like ', and ' begins_with '.Spaces surrounding the operator is required. String values on the<br />                    right side of the comparison must be within single of double quotes. Depending on the db vendor,<br />                    logical comparisons (AND, OR, NOT) are also supported. More on the differences in later blogs.<br />                    The whole filter string must be url-encoded.</td><br />        </tr><br /><tr><br />            <td>record</td><br />            <td>Used only in POST data, this option allows you to send partial (minimally the identifier fields)<br />                    or complete records back to the database to be “refreshed” with the latest values. This is also<br />                    helpful in instances where the table has multiple indexes, i.e. DynamoDb and Azure Tables.</td><br />        </tr><br /></tbody></table><br />If we want to find the first 3 records in the zipcodes table information that have a population of over<br />        20,000 people, returning only the city, state and percentage over 40 years of age. Here is what it looks<br />        like in our REST API.<br /><br /><pre class="de1">    https://dsp-mydspname.cloud.dreamfactory.com/rest/mongo/zipcodes?filter=pop+%3E+20000&limit=3&fields=city%2Cstate%2CPopulationOver40<br />    </pre><br />And this is what gets returned...<br /><br /><pre class="de1">    {<br />    "record": [<br />    {<br />    "_id": "28659",<br />    "city": "NORTH WILKESBORO",<br />    "state": "NC",<br />    "PopulationOver40": 9.19<br />    },<br />    {<br />    "_id": "31201",<br />    "city": "HUBER",<br />    "state": "GA",<br />    "PopulationOver40": 99.877<br />    },<br />    {<br />    "_id": "71291",<br />    "city": "WEST MONROE",<br />    "state": "LA",<br />    "PopulationOver40": 80.099<br />    }<br />    ]<br />    }<br />    </pre><br /></div><br /><div><br /><h4><br />Updating and Merging Into Records</h4><br />The same array of records or a single record format with changes is supported for updating records. Using the<br />        PUT HTTP verb as mentioned above will replace the whole record with the posted data if found by matching<br />        identifiers in the record.<br /><br /><pre class="de1">    PUT https://dsp-mydspname.cloud.dreamfactory.com/rest/mongo/zipcodes<br />    </pre><br /><pre class="de1">    {<br />    "_id": "29684",<br />    "city": "STARR",<br />    "state": "SC",<br />    "pop": 2890,<br />    "PopulationOver40": 79.4<br />    }<br />    </pre><br />If you only want to merge changes into a record without having to reset everything, then use the MERGE or<br />        PATCH HTTP verb and send only the changes along with the identification fields.<br /><br /><pre class="de1">    PATCH https://dsp-mydspname.cloud.dreamfactory.com/rest/mongo/zipcodes<br />    </pre><br /><pre class="de1">    {<br />    "_id": "29684",<br />    "pop": 2890,<br />    "PopulationOver40": 79.4<br />    }<br />    </pre><br />If you only want to update or merge data for one record, and it can be identified by a single key field, then<br />        you could also add the id to the end of the url, and pass only the fields that require change.<br /><br /><pre class="de1">    PATCH https://dsp-mydspname.cloud.dreamfactory.com/rest/mongo/zipcodes/29684<br />    </pre><br /><pre class="de1">    {<br />    "pop": 2890,<br />    "PopulationOver40": 79.4<br />    }<br />    </pre><br />Two other methods of merging data are by id list or filter (using “ids” or “filter” url parameters mentioned<br />        above for retrieving records). In these cases, if not natively supported, the server will query the table<br />        for the filtering results, merge in the record changes and push the changes back in an update request. This<br />        is an easy way of updating multiple records with the same field-value changes.</div><br /><div><br /><h4><br />Deleting Records</h4><br />Deleting is similar to updating records but no posted data is required.</div><br /></div><br /></div><br /><br /><div id="feature-provider"><br /><div class="page-header"><br /><h3><br />Authentication Providers</h3><br /></div><br />Dreamfactory DSP Free edition now has the ability to authenticate users to using Facebook or GitHub using our open registration feature.<br /><br />Here are the steps to enable this feature :<br /><br />Log into your DSP and access the Config menu in the DSP admin console.<br /><br />Under Open Registration check the box allow open registration and assign a role to the users who will authenticate using open registration. (When you enable open registration anyone can create an account on your DSP.  Please verify that the role has the appropriate rights to your DSP.)<br /><br /><img alt="DSP Provider Enable" src="https://s3.amazonaws.com/dfImages/dsp-provider-enabled.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <br /><br />The next time you log onto your DSP you will see two icons for Facebook and GitHub.<br /><br /><img alt="DSP Provider Login" src="https://s3.amazonaws.com/dfImages/dsp-provider-login.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <br /><br />Click on the provider icon to enter your Facebook or GitHub credentials to authenticate.<br /><br />Once you have logged into the DSP with your external provider you will see your Facebook or GitHub account under the user tab of the Admin Console. <br /><br />From the User menu you have the ability to change the role of the user.  For example, if you would like to use your GitHub account to login to the DSP as an administrator, select your GitHub account from the Users menu then select the checkbox “this user is an administrator”, then press save.<br /><br />This feature is only available in the hosted Free DSP available at http://www.dreamfactory.com.  This feature will be available in all DSP versions in the near future.</div><br /><br /><br /><div id="feature-rfs"><br /><div class="page-header"><br /><h3><br />Remote File Storage</h3><br /></div><br /><div><br /><div><br />The Remote file service allows a developer to connect to external storage providers to store and retrieve<br />                files. The following storage providers are available: Amazon Simple Storage Service (Amazon S3), Windows<br />                Azure Storage, rackspace Cloud Files and OpenStack Object Storage. </div><br /><div><br /><h4><br />Remote File Service Setup</h4><br />Once you’re in the DSP Admin Console, click on the Services menu. Then click on the “Create New<br />                Service”<br /><br /><img alt="DSP SVC RFS Menu" src="https://s3.amazonaws.com/dfImages/dsp-svc-menu.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />            <br /><br />Then enter information about the service.<br /><br />In the Type dropdown select “Remote File Storage.”<br /><br />Enter a Service Name. The Service Name will be displayed in the Admin Console. You can edit the service<br />                later after you’ve created it.<br /><br />Enter an API Name. The API Name will be used when making REST calls within the DSP.<br /><br />Enter a Description of the service (optional).<br /><br />In the Storage Name field enter the folder name where your content is located on either Amazon S3 or<br />                Windows Azure.<br /><br />In the Storage Type dropdown, select either Amazon S3 or Windows Azure. See the directions below for<br />                adding your S3 or Azure key credentials.<br /><br />Check the Active box to enable the service.</div><br /><div><br /><h4><br />Amazon S3 Configuration</h4><br />Windows Azure Storage requires an Account Name and Account Key. <br /><br />Click <a class="external text" href="http://docs.aws.amazon.com/fws/1.1/GettingStartedGuide/index.html?AWSCredentials.html" rel="nofollow">here</a> for instructions on locating your Account Name and<br />                Account Key.<br /><br /><img alt="DSP SVC Remote File Storage" src="https://s3.amazonaws.com/dfImages/dsp-svc-rfs-s3.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />        </div><br /><div><br /><h4><br />Windows Azure Configuration</h4><br />For Amazon S3 you’ll need to provide your Access Key and Secret Key. <br /><br />Click <a class="external text" href="http://www.windowsazure.com/en-us/manage/services/storage/how-to-manage-a-storage-account/#regeneratestoragekeys" rel="nofollow">here</a> for instructions on locating your Account Name and<br />                Account Key.<br /><br /><img alt="DSP SVC Azure" src="https://s3.amazonaws.com/dfImages/dsp-svc-rfs-azure.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />        </div><br /><div><br /><h4><br />Rackspace Cloud Files Configuration</h4><br />Rackspace Cloud Files requires your rackspace username, API Key, Tenant Name also known as your Cloud<br />                Account Number, and the region where you files are stored.<br /><br />Click <a class="external text" href="http://www.rackspace.com/knowledge_center/article/rackspace-cloud-essentials-1-viewing-and-regenerating-your-api-key" rel="nofollow">here</a> for instructions on locating your username, API Key,<br />                and Tenant Name.<br /><br /><img alt="DSP SVC Rackspace" src="https://s3.amazonaws.com/dfImages/dsp-svc-rfs-rackspace.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />        </div><br /><div><br /><h4><br />Test Your Connection</h4><br />Now it’s time to test your connection to remote file storage. Select the Manage Files menu item in the<br />                Admin Console. You will now see a new entry for the DSP service name you just created.<br /><br /><img alt="DSP SVC RFS Test" src="https://s3.amazonaws.com/dfImages/dsp-svc-rfs-manage-files.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />            <br /><br />Double click on the service name to view your remote files.<br /><br /><img alt="DSP SVC RFS Test" src="https://s3.amazonaws.com/dfImages/dsp-svc-rfs-view-files.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />            <br /><br />And you’re done! Now your application can access all the remote files located in the specified Amazon S3,<br />                Windows Azure or rackspace folder.</div><br /></div><br /></div><br /></section><br /><section><br />    <h2><br />Live Rest API</h2><br /><br />    <div id="rest-api"><br /><div class="page-header"><br /><h3><br />Swagger Live Rest API</h3><br /></div><br />Each DSP is bundled with an interactive API powered by Swagger. Swagger provides a developer with a live test<br />            environment assists with generating client side code and is dynamic enough to update as you onboard new<br />            services.<br /><br /><h4><br />How does DreamFactory use Swagger?</h4><br />Documenting static services of our API is as easy as <a class="external text" href="https://github.com/wordnik/swagger-core/wiki/Downloads" rel="nofollow">annotating server-side code</a>, just<br />            as you would use javadoc or phpdoc. You define the API services, including path variables, query<br />            parameters,and even members of the posted body data, along with models of any data types passed between<br />            client and server. Documentation is then easily generated in various formats (json, xml, etc) and cached for<br />            speedy access from clients.<br /><br /><h4><br />Interacting with Swagger</h4><br />To access the Swagger API documentation, Press the Gear icon on the top menu bar to access the admin console<br />            then select API Documentation from the left menu bar. Each resource of the API Doc can be expanded<br />            bypressing the resource name or the List Operations link.<br /><br /><img alt="DSP SVC RFS Test" src="https://s3.amazonaws.com/dfImages/dsp-swagger-verbs.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    </div><br /></section><br /><section><br />    <h2><br />DSP Free Edition</h2><br /><br />    <div id="dsp-account"><br /><div class="page-header"><br /><h3><br />Setting Up Your DSP</h3><br /></div><br />To start your own DSP environment you must create a DreamFactory account. To create your account press the<br />            Create Account button located on the DreamFactory website.<br /><br />Enter the required fields to create you account<br /><br /><img alt="DSP Create Account" src="https://s3.amazonaws.com/dfImages/df-create-account.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />        <br /><br />An account verification email will be sent.<br /><br /><img alt="DSP Email Confirm" src="https://s3.amazonaws.com/dfImages/df-email-confirm.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />        <br /><br />Once a DreamFactory password has been set, you will see your Account Dashboard.<br /><br /><img alt="DSP Dashboard" src="https://s3.amazonaws.com/dfImages/df-dashboard.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    </div><br /><br />    <div id="dsp-access"><br /><div class="page-header"><br /><h3><br />Creating Your DSP</h3><br /></div><br />The Account Dashboard is used to manage your DSP environment. The Dashboard menu can be accessed by logging<br />            into your DreamFactory account.<br /><br /><h3><br />Creating your DSP</h3><br />To being setting up your DSP press the Create New DSP Button on You Dashboard.<br /><br />Press the Get the Free Edition button from the DSP Dashboard to being the provisioning process.<br /><br />The Fully Qualified Domain Name for you DSP will pre populated, If you would like you can change your DSP<br />            environment URL.<br /><br /><img alt="DSP Free Edition Setup" src="https://s3.amazonaws.com/dfImages/df-create-dsp.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />        <br /><br />When your instance is available you will be sent an email with a link to access your DSP or you can click on<br />            the DSP name in your dashboard. The provisioning process should be less than 5 minutes.<br /><br /><img alt="DSP Access DSP" src="https://s3.amazonaws.com/dfImages/df-free-trial.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />        <br /><br /><h3><br />Getting Started with DSP</h3><br />For security purposes the first step is to authenticate using your DreamFactory account.<br /><br /><img alt="DSP Activate" src="https://s3.amazonaws.com/dfImages/df-activate-dsp.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />        <br /><br />Now that you have verified your DreamFactory account you can now setup your DSP admin account. Make any<br />            changes to the pre-populated fields and press submit.<br /><br /><img alt="DSP Set Admin User" src="https://s3.amazonaws.com/dfImages/df-set-admin.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    </div><br /><br />    <div id="dsp-management"><br /><div class="page-header"><br /><h3><br />Manage Your DSP</h3><br /></div><br />From the DSP dashboard each developer is able to Backup, Restore and Destroy instances. A Backup is a point<br />            in time snap shot of a DSP, for customers who have purchased DSP there are options to migrate a DSP into<br />            your private cloud or internal network. All other Backups are stored in the DreamFactory dashboard.<br />            Restoring a DSP allows a user to restore a previous backup to any DSP instance.<br /><br /><img alt="DSP Access DSP" src="https://s3.amazonaws.com/dfImages/df-free-trial.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />        <br /><br />To start the Backup process select the DSP from your DreamFactory dashboard then press the Backup button.<br />            Follow the onscreen instructions for starting the Backup. Once the Backup is complete an email will be sent<br />            to the developer's email account. Each Backup is stored for 30 days.<br /><br />To start the Restore process select the DSP instance that will be used and press the Restore button. Follow<br />            the onscreen prompts for restoring the backup. Please Note: This is a destructive process. You will<br />            permanently lose any and all data associated (not including snapshots) with this DSP when you restore a<br />            snapshot.<br /><br />Destroying a DSP will permanently remove the instance from your dashboard. Once a DSP is destroyed the<br />            instance cannot be recovered and all previous backups will be permanently deleted.</div><br /></section><br /><br /><section><br /><h2><br />Admin Console User Guide</h2><br /><br /><div id="admin-overview"><br /><div class="page-header"><br /><h3><br />Admin Console Overview</h3><br /></div><br />The Admin Console is used to provide access the following modules: Applications, Users, Roles, App Groups,<br />        Services, File Management and Data Management. Only system administrators should be allowed to access the Admin<br />        Console.<br /><br />To Access the Admin Console select the gear icon in the top right corner of your DSP environment.<br /><br />There are three sections that make up the Admin Console interface. On the left is the Navigation Menu which<br />        provides access to DSP Resources. In middle section is the Resource List which shows the resources that have<br />        been created for each menu item. Finally to the right is the Resource Workspace which is used to create and<br />        update resources.<br /><br /><img alt="DSP Overview Screen" src="https://s3.amazonaws.com/dfImages/dsp-overview.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /></div><br /><br /><div id="admin-apps"><br /><div class="page-header"><br /><h3><br />Applications</h3><br /></div><br /><h4><br />Sample Applications</h4><br />To gain an understanding of how applications work inside of your DSP we have included sample applications. These<br />        applications provide a basic overview of the functionality of the DSP and can be deleted at anytime.<br /><br />If you would like to import a sample application press import application on the top right corner of the screen.<br />        Then select the application from the list that is shown on the screen. Finally press the import button. <br /><br />If you have downloaded a dfpkg file from our GitHub page to your local file system you can import the application<br />        by browsing to the source file, then pressing the import button.<br /><br /><h4><br />Native Applications</h4><br />Native applications use the DSP to access the rest system but all of the application’s files are located on the<br />        device or client.<br /><br /><h4><br />Hosted Applications</h4><br />Application can use your DSP to host all of the application files. Files can be uploaded to the application using<br />        the DSP’s File manger.<br /><br />If you have an application that is hosted on one of your existing web servers you can configure your DSP to<br />        communicate with this environment by entering the URL of your application.<br /><br /><img alt="DSP Application Create" src="https://s3.amazonaws.com/dfImages/dsp-app.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /></div><br /><br /><div id="admin-users"><br /><div class="page-header"><br /><h3><br />Users</h3><br /></div><br />Each DSP environment is bundled with a user management component. This allows the developer to focus on building<br />        applications instead of creating user management components. The user management interface can add a new user,<br />        make changes to an existing user or reset a users password. Currently a user can only be assigned to a single<br />        role.<br /><br /><h4><br />Creating and Managing Users</h4><br />To access the User menu select User from the Navigation Menu, then Press the Create New User button on the user<br />        Workspace, next begin entering the user details. The required fields are highlighted in red as you enter the<br />        user account details. If the user is a system administrator they will be provided access to all applications in<br />        the DSP. When creating your user there is an option to assigning a user a to a role.<br /><br />Once you have entered the user details press the Save Button.<br /><br /><img alt="DSP User Create" src="https://s3.amazonaws.com/dfImages/dsp-user-create.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />Public Name and Description are displayed to users in the DSP application.<br /><br /><h4><br />Updating Users and Changing Passwords</h4><br />To update a user select the user name from the user list press the edit button. Make the appropriate changes and<br />        press the Update user button.<br /><br /><h4><br />Deleting Users</h4><br />From the User list select the user to remove and press the Delete button.</div><br /><br /><div id="admin-roles"><br /><div class="page-header"><br /><h3><br />Roles</h3><br /></div><br />Roles are used to manage users access to Applications and Services. Since roles are assigned to users each role<br />        can control access to a DSP Services. A role can be assigned to one or more applications and to one or more<br />        service. The following types of rights can be assigned to a service: Full Access, Read and Write, Read Only,<br />        Write Only and No Access.<br /><br /><h4><br />Adding and Managing Roles</h4><br />To create a new Role select Roles from the navigation Menu then press the Create New Role button in Role<br />        Workspace.<br /><br />Enter the Role Name and Description<br /><br /><img alt="DSP Role Create" src="https://s3.amazonaws.com/dfImages/dsp-roles-create.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />Select the users who will be a member of the Role.<br /><br /><img alt="DSP Role User Assign" src="https://s3.amazonaws.com/dfImages/dsp-roles-user-assign.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />Select the Apps that will be assigned to the Role.<br /><br /><img alt="DSP Role Apps Assign" src="https://s3.amazonaws.com/dfImages/dsp-roles-apps-assign.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />Assign Service Access to a Role.<br /><br />Select the Service, Component and the Access level then press the Add Service Access Button.<br /><br /><img alt="DSP Role Service Assign" src="https://s3.amazonaws.com/dfImages/dsp-roles-service-assign.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />To add additional Services Select the appropriate service type then press the add Service Access Button.<br /><br />If a service is added incorrectly press the delete icon to remove the service access.<br /><br />Press the Save button to create the new Role.<br /><br /><h4><br />Updating Roles</h4><br />Roles can be updated by selecting the Role from the list, then editing the Users, Applications or Services<br />        related to the selected role.<br /><br /><h4><br />Deleting Roles</h4><br />Select the Role name from the list then, press the delete icon. Confirm you would like to delete the selected<br />        Role.</div><br /><br /><div id="admin-groups"><br /><div class="page-header"><br /><h3><br />Groups</h3><br /></div><br />Groups are used to organize applications under a heading.<br /><br />To Create a new Application Group Select App Groups from the navigation menu then press the Create New Group<br />        button in the Admin Console Workspace.<br /><br />Enter a Group Name, Description and select the Applications that will be part of the group.<br /><br />Press save to create your Application Group.<br /><br /><img alt="DSP Groups Assign" src="https://s3.amazonaws.com/dfImages/dsp-groups-assign.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br /><h4><br />Updating Groups</h4><br />Select the group name from the list, add or remove the desired Applications then click Save .<br /><br /><h4><br />Deleting Groups</h4><br />Select the Role name from the list then, press the delete icon. Confirm you would like to delete the selected<br />        Role.</div><br /><br /><div id="admin-data"><br /><div class="page-header"><br /><h3><br />Manage Data</h3><br /></div><br />Data Manager allows a developer to view and edit locally stored SQL data.<br /><br />From the Manage Schema workspace the admin can edit, delete, sort, search and filter your data. From the Manage<br />        Data component select you table which will display the data editor view.<br /><br />To enter a new row of data enter the data values into the first row of the table and press the save icon to the<br />        left. To edit a field double click on the value you would like to change, enter the new value and press the save<br />        icon. To Delete a row press the red X icon on the row you would like to delete. Data can be sorted by pressing<br />        the column heading.To access the Search and Group data feature select the drop down arrow in the top right of the header row. To<br />        search data begin typing in the search box. To group data select the icon to the right of the data fields.<br />        Multiple groupings can be applied. The order of the group using a number to the right of the group button. The<br />        check box to the left of the field name can be used to hide and show fields.<br /><br /><img alt="DSP Manager Editor" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-schema-grid.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /></div><br /><br /><div id="admin-services"><br /><div class="page-header"><br /><h3><br />Services</h3><br /></div><br /><a href="http://www.blogger.com/null" name="ServiceList"></a><br /><br /><br /><br />DSP uses a variety of services to communicate with internal and external resources. A complete listing of available<br />    DSP services are defined below.<br /><br />Below is a list of services that can be created in your DSP. Click on the service name to view detailed instructions<br />    on configuring each service<br /><br /><table class="table-striped table-condensed"><br />    <tbody><br /><tr><br />        <td><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#RemoteWebService" style="color: #ff8907;">Remote Web Service</a></td><br />        <td>Remote Web Services are used to communicate with Web Applications hosted outside of the DSP.</td><br />    </tr><br /><tr><br />        <td><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#RemoteSQLDB" style="color: #ff8907;">Remote SQL DB</a></td><br />        <td>Remote SQL DB allows a developer to connect to a database hosted outside of the DSP.. Currently we<br />            provide support to MySQL but will be looking to add the ability to connect to oracle and MS SQL server in<br />            the future.</td><br />    </tr><br /><tr><br />        <td><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#NoSQLDB" style="color: #ff8907;">NoSQL DB</a></td><br />        <td>The NoSQL Service allows a user to connect to a remote NoSQL DB. Currently support for Amazon DynamoDB,<br />            Amazon SimpleDB, and Windows Azure Tables are available.</td><br />    </tr><br /><tr><br />        <td><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#LocalFileStorage" style="color: #ff8907;">Local File Storage</a></td><br />        <td>Local File Storage Is used to store files on the DSP server. Application (app) and Library (lib) are both<br />            examples of local file storage.</td><br />    </tr><br /><tr><br />        <td><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#RemoteFileStorage" style="color: #ff8907;">Remote File Storage</a></td><br />        <td>Remote File Storage allows a developer to access external storage services. Amazon S3, Open Stack,<br />            Rackspace , and Windows Azure remote file services can be accessed from your DSP.</td><br />    </tr><br /><tr><br />        <td><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#EmailService" style="color: #ff8907;">Email Service</a></td><br />        <td>There are three types of email Providers Server Default, Server Command and SMTP. When using the Server<br />            Default we utilize the default email provider on the local machine. This is the default email provider for<br />            hosted DSP's. If your DSP is hosted on a system where you have<br />            root access you can use a server command to send emails from the DSP. SMTP can be configured to send emails<br />            using your SMTP provider using SSL or TLS authentication.<br />        </td><br />    </tr><br /></tbody></table><br /><div><br /><h4><br /><a href="http://www.blogger.com/null" name="RemoteWebService"></a>Remote Web Service</h4><br />From DSP Admin Console, click on the Services menu. Then click on the “Create New Service” button.<br /><br />Then enter information about the service.<br /><br />In the Type drop down select “Remote Web Service”.<br /><br />Enter a Service Name. The Service Name will be displayed in the Admin Console. You can edit the service later<br />        after you’ve created it.<br /><br />Enter an API Name. The API Name will be used when making REST calls within the DSP.<br /><br />Enter a Description of the service (optional).<br /><br />In the base URL enter the address of the Remote Web Service. <br /><br />If you remote Web Service requires additional parameters or headers they can be entered into the appropriate<br />        fields.<br /><br />Check the Active box to enable the service.<br /><br />To create your Remote Web Service press Save.<br /><br /><img alt="DSP Remote SQL Service" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-svc-rws.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <br /><br /><h5><br /><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#ServiceList">Return to Services</a></h5><br /></div><br /><div><br /><h4><br /><a href="http://www.blogger.com/null" name="RemoteSQLDB"></a>Remote SQL DB</h4><br />From DSP Admin Console, click on the Services menu, next click on the “Create New Service” button.<br /><br />Then enter information about the service.<br /><br />In the Type drop down select “Remote SQL DB”.<br /><br />Enter a Service Name. The Service Name will be displayed in the Admin Console. You can edit the service later<br />        after you’ve created it.<br /><br />Enter an API Name. The API Name will be used when making REST calls within the DSP.<br /><br />Enter a Description of the service (optional).<br /><br />In the field connection string enter the connection string for your remote database.<br /><br />Enter the username and password for the database.<br /><br />Check the Active box to enable the service.<br /><br />To create your Remote SQL DB press Save.<br /><br /><img alt="DSP Remote SQL Service" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-svc-rsql.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <br /><br /><h5><br /><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#ServiceList">Return to Services</a></h5><br /></div><br /><div><br /><h4><br /><a href="http://www.blogger.com/null" name="NoSQLDB"></a>NoSQL DB</h4><br />From DSP Admin Console, click on the Services menu. Then click on the “Create New Service” button.<br /><br />In the Type drop down select “NoSQL DB”.<br /><br />Enter a Service Name. The Service Name will be displayed in the Admin Console. You can edit the service later<br />        after you’ve created it.<br /><br />Enter an API Name. The API Name will be used when making REST calls within the DSP.<br /><br />Enter a Description of the service (optional).<br /><br />In the Storage Type drop down, select the appropriate Amazon DynamoDB, Amazon SimpleDB, and Windows Azure<br />        Tables. <br /><br />For the Amazon DynamoDB SimpleDB and providers you will need your account Access Key and Secret Key.<br /><br /><br />    <img alt="DSP NoSQL AWS Service" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-svc-nosql-dynodb.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <br />    <img alt="DSP NoSQL Windows Azure Tables Service" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-svc-nosql-azuredb.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />Check the Active box to enable the service.<br /><br /><h5><br /><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#ServiceList">Return to Services</a></h5><br /></div><br /><div><br /><h4><br /><a href="http://www.blogger.com/null" name="LocalFileStorage"></a>Local File Storage</h4><br />From DSP Admin Console, click on the Services menu. Then click on the “Create New Service” button.<br /><br />In the Type drop down select "Local File Storage”.<br /><br />Enter a Service Name. The Service Name will be displayed in the Admin Console. You can edit the service later<br />        after you’ve created it.<br /><br />Enter an API Name. The API Name will be used when making REST calls within the DSP.<br /><br />Enter a Description of the service (optional).<br /><br />In the Storage Name field enter the desired folder name.<br /><br />Check the Active box to enable the service.<br /><br /><img alt="DSP Local File Storage" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-svc-lfs.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <br /><br /><h5><br /><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#ServiceList">Return to Services</a></h5><br /></div><br /><div><br /><h4><br /><a href="http://www.blogger.com/null" name="RemoteFileStorage"></a>Remote File Storage</h4><br />From DSP Admin Console, click on the Services menu. Then click on the “Create New Service” button.<br /><br />Then enter information about the service.<br /><br />In the Type drop down select “Remote File Storage”.<br /><br />Enter a Service Name. The Service Name will be displayed in the Admin Console. You can edit the service later<br />        after you’ve created it.<br /><br />Enter an API Name. The API Name will be used when making REST calls within the DSP.<br /><br />Enter a Description of the service (optional).<br /><br />In the Storage Name field enter the folder name where your content is located in your file service provider.<br /><br />In the Storage Type drop down, select the appropriate file service.<br /><br />Amazon S3 can be accessed using your AWS Access Key and Secret Key.<br /><br /><br />    <img alt="AWS Remote File Storage" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-svc-rfsaws.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />To access your Windows Azure Storage account you will need your Windows Azure Account Name and Account Key.<br /><br /><br />    <img alt="Azure Remote File Storage" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-svc-rfsazure.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />To access Rackspace or Openstack file storage you will need to provide your User Name, API Key, Tenant Name (also<br />        called Cloud Account Number) and the Region where you content is located.<br /><br /><br />    <img alt="RackSpace Remote File Storage" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-svc-rfsrackspace.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />Check the Active box to enable the service.<br /><br />To test your connection to remote file storage; Select the Manage Files menu item in the Admin Console. You will<br />        now see a new entry for the DSP service name you just created.<br /><br />Double click on the service name to view your remote files.<br /><br />To create your Remote File Storage Service press Save.<br /><br /><h5><br /><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#ServiceList">Return to Services</a></h5><br /></div><br /><div><br /><h4><br /><a href="http://www.blogger.com/null" name="EmailService"></a>Email Service</h4><br /><h5><br />Sever Default</h5><br />From DSP Admin Console, click on the Services menu. Then click on the “Create New Service” button.<br /><br />In the Type drop down select "Email Service”.<br /><br />Select the Provider Server Default<br /><br />Enter a Service Name. The Service Name will be displayed in the Admin Console. You can edit the service later<br />        after you’ve created it.<br /><br />Enter an API Name. The API Name will be used when making REST calls within the DSP.<br /><br />Enter a Description of the service (optional).<br /><br />In the Command field enter the command used to execute the locally installed email service.<br /><br />Complete the Parameters section. Depending on the email service you installed you may need to provide a valid<br />        from and reply to email address.<br /><br />Check the Active box to enable the service.<br /><br /><img alt="DSP Local Email Service" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-svc-lemail.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <br /><br /><h5><br /><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#ServiceList">Return to Services</a></h5><br /></div><br /><div><br /><h5><br />Server Command</h5><br />From DSP Admin Console, click on the Services menu. Then click on the “Create New Service” button.<br /><br />In the Type drop down select "Email Service”.<br /><br />Select the Provider Server Command<br /><br />Enter a Service Name. The Service Name will be displayed in the Admin Console. You can edit the service later<br />        after you’ve created it.<br /><br />Enter an API Name. The API Name will be used when making REST calls within the DSP.<br /><br />Enter a Description of the service (optional).<br /><br />In the Command field enter the command used to execute the locally installed email service.<br /><br />Check the Active box to enable the service.<br /><br /><imgsrc alt="DSP Local Email Service" class="df-image" dfimages="" dsp-svc-lemail.png="" https:="" s3.amazonaws.com="" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;"><br />    </imgsrc><br /><br /><h5><br /><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#ServiceList">Return to Services</a></h5><br /></div><br /><div><br /><h5><br />SMTP</h5><br />In the example below we are using Gmail to setup the remote service.<br /><br />To Crete a new service Select Remote Email Service and enter a service name, API name and a description.<br /><br />From DSP Admin Console, click on the Services menu. Then click on the “Create New Service” button.<br /><br />Then enter information about the service.<br /><br />In the Type drop down select “Remote Email Service”.<br /><br />Select the Provider SMTP<br /><br />Enter a Service Name. The Service Name will be displayed in the Admin Console. You can edit the service later<br />        after you’ve created it.<br /><br />Enter an API Name. The API Name will be used when making REST calls within the DSP.<br /><br />Enter a Description of the service (optional).<br /><br />Enter the host name of SMTP server, the port number and select the security type either SSL or TSL.<br /><br />The parameters from_name, from_email, reply_to_name and reply_to_email are required fields. Some Email providers<br />        require that a valid account including the domain name is entered in these fields.<br /><br />Finally, the username and password for the authenticated user is entered into the appropriate field.<br /><br />Check the Active box to enable the service.<br /><br />To create your Remote Email Service press Save.<br /><br /><imgsrc alt="DSP Remote Email Service" class="df-image" dfimages="" dsp-svc-remail.png="" https:="" s3.amazonaws.com="" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;"><br />    </imgsrc><br /><br /><h5><br /><a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#ServiceList">Return to Services</a></h5><br /></div><br /></div><br /><br /><div id="admin-files"><br /><div class="page-header"><br /><h3><br />Manage Files</h3><br /></div><br />File Manager is used to manage upload and edit files at the DSP Level. This same functionality is available at<br />        the application level.<br /><br />To create new folders press the Create Folder button and enter your desired folder name when prompted.<br /><br />Files can be uploaded using drag and drop from your local machine, or by using the Upload File utility. To use<br />        drag and drop select the file from your local machine and drag it into file manager. At this point you can only<br />        drag and drop files. Individual or zip files can be uploaded from either your local machine or a URL. To upload<br />        a file press the choose file button select the file from your local machine and press the import button. To<br />        upload from URL Enter the fully qualified URL (http://www.dreamfactory.com/inapp01.zip) and press the Import<br />        button. When importing zip files you will need make sure Extract ZIP files is checked. There is also a check box<br />        to delete existing folder contents before extracting.<br /><br /><img alt="DSP Local File Storage" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-fileman-upload.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />The file editing tool allows a developer to edit files from within a web browser with the assistance syntax<br />        highlighting. To edit a file press the edit icon to the right of the file name.<br /><br /><imgsrc alt="DSP Manager Editor" class="df-image" dfimages="" dsp-fileman-editor.png="" https:="" s3.amazonaws.com="" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;"><br /><br />    </imgsrc><br /><br />Once the file editor opens you are able to make changes to your file and press Save. If you do not want to save<br />        your changes press the Cancel button.<br /><br />If you would like to migrate your application to a different DSP or make a backup of your application before<br />        making changes the Download Zip utility can be used to export your data to your local machine.<br /><br />Deleting items can be completed by selecting the item you would like to delete and pressing the Delete Item(s)<br />        button. Multiple items can be selected by holding the control or shift keys.</div><br /><br /><div id="admin-schema"><br /><div class="page-header"><br /><h3><br />Manage Schema</h3><br /></div><br /><table class="table table-bordered table-striped table-hover"><br />        <thead><br /><tr><br />            <th>Data Type<br />            </th><br />            <th>Description<br />            </th><br />        </tr><br /></thead><br />        <tbody><br /><tr><br />            <td>ID/Primary Key<br />            </td><br />            <td>Defines a typical table identifier, translates to "int not null auto_increment primary key". This type<br />                requires no other properties to define the field. It presumes a "type" of int with "allow_null" set to<br />                false, the "auto_increment" and "is_primary_key" are set to true. It can only be used once in a table<br />                definition.<br />            </td><br />        </tr><br /><tr><br />            <td>String<br />            </td><br />            <td>Defines a string field (i.e. varchar or char), defaults to a length of 255, but can be set using the<br />                "length" property. Optional properties: "allow_null".<br />            </td><br />        </tr><br /><tr><br />            <td>Integer<br />            </td><br />            <td>Defines an integer field. Use "length" to set the displayable length of the integer, i.e. int(11) in<br />                MySQL. Optional properties: "allow_null".<br />            </td><br />        </tr><br /><tr><br />            <td>Text<br />            </td><br />            <td>Defines a large string field (i.e. MySQL's text or MSSQL's varchar[max]), defaults to the largest length<br />                string allowed by the underlying database. Optional properties: "allow_null".<br />            </td><br />        </tr><br /><tr><br />            <td width="100">Boolean<br />            </td><br />            <td>Defines a boolean field, which may be represented by int of length 1, using 0 and 1 values, if a true<br />                and false boolean type is not supported by the underlying database. Optional properties: "allow_null".<br />            </td><br />        </tr><br /><tr><br />            <td>Binary<br />            </td><br />            <td>Defines a binary string field (i.e. varbinary or binary), defaults to a length of 255, but can be set<br />                using the "length" property. Set the "fixed_length" property to true for fixed length (i.e. binary)<br />                behavior. Optional properties: "allow_null".<br />            </td><br />        </tr><br /><tr><br />            <td>Blob<br />            </td><br />            <td>Defines a large binary string field (i.e. MySQL's blob or MSSQL's varbinary[max]), defaults to the<br />                largest length binary string allowed by the underlying database. Optional properties: "allow_null".<br />            </td><br />        </tr><br /><tr><br />            <td>Float<br />            </td><br />            <td>Defines a standard float field. Use “scale" to set the number of desired decimal places to the right of<br />                the decimal point. Use “length” or "precision" to set the total number of digit positions. Optional<br />                properties: "allow_null".<br />            </td><br />        </tr><br /><tr><br />            <td>Decimal<br />            </td><br />            <td>Defines a standard decimal field. Use “scale" to set the number of desired decimal places to the right<br />                of the decimal point. Use “length” or "precision" to set the total number of digit positions. Optional<br />                properties: "allow_null.<br />            </td><br />        </tr><br /><tr><br />            <td>Datetime<br />            </td><br />            <td>A datetime field. Optional properties: "allow_null".<br />            </td><br />        </tr><br /><tr><br />            <td>Date<br />            </td><br />            <td>A date field. Optional properties: "allow_null".<br />            </td><br />        </tr><br /><tr><br />            <td>Time<br />            </td><br />            <td>A time field. Optional properties: "allow_null".<br />            </td><br />        </tr><br /></tbody><br />    </table><br /><div><br />Related tables can be created using the import JSON Schema. Once the JSON is imported press the Create Table<br />            Button. This interface in conjunction with REST and Database API will allow a developer to Alter, Update,<br />            Delete and Create table references.<br /><br /><img alt="DSP Manager Editor" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-schema-import.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    </div><br /></div><br /><br /><div id="admin-packages"><br /><div class="page-header"><br /><h3><br />Package Apps</h3><br /></div><br />Applications can be exported from your DSP as a DreamFactory Package. These packages can be shared between other<br />        DSP users, or stored in your version Control System.<br /><br />To Create your package select Package Apps from the navigation menu then select the Application you would like to<br />        package.<br /><br />Choose the database schema and the services that will be included in the package file.<br /><br /><img alt="DSP Package Export" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-pkgs-export.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />Press the Export App Button. The dfpkg file will be downloaded to your computer.<br /><br /><h4><br />Importing Package Applications</h4><br />From the Admin Console Click on Applications in the Navigation Menu. Press the Import New app button.<br /><br />Press the choose file button and locate your .dfpkg file. Once the file is located press the upload button.<br /><br /><img alt="DSP Package Import" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-pkgs-import.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />Your Application will now be available in the application drop down list.</div><br /><br /><div id="admin-sysconfig"><br /><div class="page-header"><br /><h3><br />System Config</h3><br /></div><br /><h4><br />CORS Access</h4><br />Cross Origin Resource Sharing (CORS) permits browsers to make AJAX requests cross-domain.<br /><br />To Enable CORS Access in your DSP press the System Config Navigation Menu. Under the CORS Access section press<br />        the New Host button. In the Host name you can enter * to allow access from all hosts, the Hostname or IP address<br />        can also be entered.<br /><br /><img alt="DSP CORS Access" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-sysconf-cors.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />If you would like to restrict which http Verbs can be used by remote server check the appropriate boxes.<br /><br /><h4><br />Guest Users</h4><br />Guest Users are used to allow access to DSP applications without having to provide user credentials. This<br />        functionality is useful if an application built inside your DSP needs to be available to users without requiring<br />        registration.<br /><br />For more information on CORS support please visit<br />        <ahref access_control_cors="" developer.mozilla.org="" docs="" en-us="" http="" https:="" style="color: #ff8907;">CORS OverviewFrom<br />        Mozilla Developer Network</ahref><br /><br />To control which applications and resources the guest account can access make sure that the Role assigned to the<br />        guest account is configured with the appropriate permissions. By default this functionality is disabled and must<br />        be setup and configured by an administrator.<br /><br /><img alt="DSP Guest Account Export" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-sysconf-guest.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />When the guest account functionality is enabled the applications assigned to the guest role will be presented on<br />        the DSP Login screen. To login into your DSP click on the Sign In button in the top right corner.<br /><br /><h4><br />Open Registration</h4><br />Open Registration allows a user to sign up to access a DSP without being invited by the administrator This means<br />        anyone with the URL can create an account to access the DSP.<br /><br />To control which applications and resources a open registration user can access make sure that the default role<br />        for open registration is setup with the appropriate permissions. By default this functionality is disabled and<br />        must be setup and configured by an administrator.<br /><br />To enable Open Registration access the System Config menu in the Admin Console. Check the box marked Allow Open<br />        Registration, Then Select the Default Role for Open registration users and press Save at the bottom of the<br />        screen.<br /><br /><img alt="DSP Open Registration" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-sysconf-openreg.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />On your DSP login screen there is now a Create Account button in the top right corner. When a user clicks on the<br />        Create Account button they will enter their Email Address, First and Last name, then press register.<br /><br /><img alt="DSP Package Import" class="df-image" src="https://s3.amazonaws.com/dfImages/dsp-sysconf-createacct.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />An email will be sent which will allow the user to set their password and provide access to the DSP.</div><br /></section><br /><br /><section><br /><h2><br />DSP in the Cloud</h2><br /><br /><div id="cloud-azure"><br /><div class="page-header"><br /><h3><br />Create a DSP on Windows Azure</h3><br /></div><br />Below are the instructions to create a DreamFactory Services Platform™ (DSP) in your Windows Azure account. You<br />        can either create your DSP through the management portal or via the Azure Command Line Tools. We'll cover both<br />        methods here. <br /><br />If you've just created your Windows Azure account or a new user for your DSP, you'll need to create and upload a<br />        management certificate. If you already have one, just skip the next section.<br /><br /><h2><br />Creating a Management Certificate </h2><br />This following information was taken from <a class="external text" href="http://msdn.microsoft.com/en-us/library/windowsazure/gg551722.aspx" rel="nofollow">here</a>.<br /><br /><div class="well well-large well-transparent"><br />A Windows Azure management certificate is an X.509 v3 certificate used to authenticate an agent, such as Visual<br />        Studio Tools for Windows Azure or a client application that uses the Service Management API, acting on behalf of<br />        the subscription owner to manage subscription resources. Windows Azure management certificates are uploaded to<br />        Windows Azure and stored at the subscription level. The management certificate store can hold up to 25<br />        certificates. These certificates are used to authenticate your Windows Azure deployment.<br />        <br /><br />Management certificates must have a key length of at least 2048 bits and should reside in thePersonal<br />        certificate store. When the certificate is installed on the client, it should contain the private key of the<br />        certificate. To upload to the certificate to the Windows Azure Management Portal, you must export it as a .cer<br />        format file that does not contain the private key.<br />    </div><br /><h3><br />Linux</h3><br />Creating a certificate in Linux is very straightforward. In Ubuntu, it does require the package <b>mono-devel</b><br />        for the <b>makecert</b> utility. Other flavors of Linux you're on your own at this time.<br /><br /><br /><br /><h4><br />Installing the mono-devel Package</h4><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1"> <span class="co4">$ </span><span class="kw2">sudo</span><span class="kw2">apt-get install</span> mono-devel<br />                </pre><br /></div><br /></div><br />The below examples were done on an Ubuntu 12.04.2 LTS machine.<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1">$ makecert -r -n "CN=[certificate-name]" -a sha1 "/path/to/[certificate-name].cer"<br />                    <br />Mono MakeCert - version 2.10.8.1X.509 Certificate Builder Copyright 2002, 2003 Motus Technologies. Copyright 2004-2008 Novell. BSD licensed.<br />                    <br />Success<br />                    </pre><br /></div><br /></div><br />Obviously, replace ```[certificate-name]``` with a name of your choosing.<br /><br /><h3><br />Windows</h3><br />To create your own self-signed management certificates, open a Visual Studio command prompt and execute the<br />        following command: <br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="winbatch source-winbatch"><br /><pre class="de1">makecert <span class="sy0">-</span>sky exchange <span class="sy0">-</span>r <span class="sy0">-</span>n <span class="st0">"CN=<CertificateName>"</span> <span class="sy0">-</span>pe <span class="sy0">-</span>a sha1 <span class="sy0">-</span>len <span class="nu0">2048</span> <span class="sy0">-</span>ss My <span class="st0">"<CertificateName>.cer"</span><br />                    </pre><br /></div><br /></div><br />For more complete information on generating a certificate, see <a class="external text" href="http://msdn.microsoft.com/en-us/library/windowsazure/gg432987.aspx" rel="nofollow">Create a Service Certificate for<br />        Windows Azure</a><br /><br /><div class="well well-large well-transparent"><br /><i class="icon-warning-sign icon-4x pull-left"></i><br />        The private key associated with certificate should be maintained in a secure location. After the .cer file is<br />        uploaded, anyone who has the private key can use the Service Management API to control the hosted service. This<br />        includes creating, deleting, and modifying services and storage accounts on your subscription that areassociated<br />        with certificate.<br />    </div><br /><h4><br />Using the Management Portal</h4><br />You must have, or have access to, the following in order to complete this: <br /><br /><ol><br /><li> a valid WindowsAzure account</li><br /><li> the <a class="external text" href="https://manage.windowsazure.com/" rel="nofollow">WindowsAzure<br />            managementportal</a></li><br /><li> the permissions to create a Virtual Machine</li><br /></ol><br /><h4><br />Preparation </h4><br />The first step is to pull the DreamFactory Services Platform™ image from the VM Depot into your storage account.<br />        If you've already copied the image to your storage account you may skip this step. <br /><br /><ol><br /><li> Go to the Virtual Machines section of your WindowsAzure portal</li><br /><li> Click on the "Images" sub-menu</li><br /><li> Click "Browse VM Depot"</li><br /><li> Search for, and choose, "DreamFactory DSP vx.x.x-azure"</li><br /><li> Choose a storage account, or create one, to house the image and click the check mark</li><br /></ol><br /><img alt="Azure Machine Configuration" class="df-image" src="https://s3.amazonaws.com/dfImages/cloud-azure-vm1.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br />On this panel you choose a name for your new DSP and a user name.<br /><br />The image is set up with a user called dsp_user already, but you still need to tell Azure about this user.<br /><br /><ol><br /><li> In the <b>NEW USER NAME</b> field, type: dsp_user</li><br /><li> In the <b>NEW PASSWORD</b> and <b>CONFIRM fields</b>, type: DSP!User</li><br /><li> Choose a size for your VM. <b>Extra Small</b> is perfect for a test drive.</li><br /><li><b>Optional</b>: Tick the box next to <b>UPLOAD COMPATIBLE SSH KEY FOR AUTHENTICATION</b> if you wish to<br />            enable SSH public key authentication<br />        </li><br /><li> Click the arrow on the bottom to continue.</li><br /></ol><br /><h4><br />Virtual Machine Mode</h4><br />On this panel, simply leave the default <b>standalone machine</b> and choose a DNS name for your DSP. This will<br />        be your public web address to your DSP. The domain for Azure VMs is <b>.cloudapp.net</b>. So if you choose <b>scooby-doo</b><br />        as your DNS name, you can reach your DSP via <a class="external free" href="http://scooby-doo.cloudapp.net/" rel="nofollow">http://scooby-doo.cloudapp.net</a>.<br /><br />After you've entered an acceptable value, click the arrow on the bottom to continue.<br /><br /><h4><br />Virtual Machine Options</h4><br />In this last panel of the Azure VM setup wizard, you are able to select an <b>Availability Set</b>. You can<br />        safely ignore this for now and click the check mark on the bottom to create your DSP VM.<br /><br /><h4><br />Post Spin-Up Steps</h4><br />There is one more thing you must do to reach your DSP once it has been created. This is to allow web traffic from<br />        the world into your VM.<br /><br />To do this, you need to create, what Azure calls, and <b>endpoint</b>.<br /><br /><ol><br /><li> Navigate to your new VM's dashboard</li><br /><li> Click the <b>Endpoints</b> submenu, and <b>Add Endpoint" from the footer menu. This will pop up the<br />            endpoint dialog.</b></li><br /><li> See the figure below for what to put in this form</li><br /></ol><br /><img alt="Azure Specify Endpoint" class="df-image" src="https://s3.amazonaws.com/dfImages/cloud-azure-vm2.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /></div><br /><br /><div id="cloud-ec2"><br /><div class="page-header"><br /><h3><br />Create a DSP on Amazon EC2</h3><br /></div><br /><br /><br />Below are the instructions to create a DreamFactory Services Platform™ (DSP) in your<br />        <ahref aws.amazon.com="" class="external text" http:="" rel="nofollow">Amazon EC2 account. You can either create your<br />        DSP through the EC2 management console or via the <a class="external text" href="http://docs.aws.amazon.com/AWSEC2/latest/CommandLineReference/Welcome.html" rel="nofollow">Amazon EC2 Command Line Tools</a>. This guide covers the creating your DSP from the<br />        management console.<br />    </ahref><br /><br /><h4><br />Using the EC2 Management Console </h4><br /><h4><br />Create the VM</h4><br />Our current Amazon AMI ID is <a class="external text" href="https://aws.amazon.com/amis/dsp-ami-v1.0.3" rel="nofollow">ami-ef583086</a> .<br /><br /><div class="well well-large well-transparent"><br /><i class="icon-warning-sign icon-4x pull-left"></i> The AMI ID may<br />        change in the future. Should you feel that this link and ID are not the latest version, simply search the public<br />        images for <b>dsp-ami</b>. Our images will be listed by version. Simply choose the one you want, and continue on<br />        to the next step.<br />    </div><br />Click the following link to launch a DSP in on Amazon EC2: <a class="external free" href="https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-ef583086" rel="nofollow">https://console.aws.amazon.com/ec2/home?region=us-east-1#launchAmi=ami-ef583086</a><br /><br />There are a few steps in starting your EC2 instance. They're outlined below.<br /><br /><h4><br />Instance Details</h4><br />Instance Details is a multi-step panel that allows you to modify the storage layouts for your DSP. You don't have<br />        to do any thing on this panel. Just click <b>Continue</b> until you're on the next step: <a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#Create_Key_Pair">#Create Key Pair</a>.<br /><br /><img alt="AWS EC2 Instance Type" class="df-image" src="https://s3.amazonaws.com/dfImages/cloud-aws-vm1.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <img alt="AWS EC2 Instance Monitoring " class="df-image" src="https://s3.amazonaws.com/dfImages/cloud-aws-vm2.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <img alt="AWS EC2 Instance Storage" class="df-image" src="https://s3.amazonaws.com/dfImages/cloud-aws-vm3.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <br /><br /><h4><br />Create Key Pair</h4><br />In order to access your DSP via SSH you'll need to create an SSH key pair. If you have one in your account you'd<br />        prefer to use, select it and click <b>Continue</b>. If not, read on...<br /><br /><h5><br />Create a new Key Pair</h5><br />In order to access your DSP via SSH you'll need to create an SSH key pair. If you have one in your account you'd<br />        prefer to use, select it and click <b>Continue</b>. If not, read on...<br /><br /><h5><br />Create a new Key Pair</h5><br />Click on the second section, <b>Create a new Key Pair</b> of the <b>Create Key Pair</b> panel, displaying the<br />        options.<br /><br /><ol><br /><li> Enter a name for your key pair.</li><br /><li> Click on the <b>Create & Download your Key Pair</b> link</li><br /></ol><br />At this point your private key file will be downloaded to you. Save it to your secret stash of keys, wherever<br />        that is. If you're on a linux system, you'll want to place it in your ~/.ssh directory. Save it to<br />        your-key-name.pem, replacing <b>your-key-name</b> with whatever name you chose in the prior step.<br /><br />Click the <b>Continue</b> button to <a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#Configure_Firewall">configure the firewall</a>.<br /><br /><img alt="Azure Specify Endpoint" class="df-image" src="https://s3.amazonaws.com/dfImages/cloud-aws-vm4.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <br /><br /><h5><br /> Using Your Key </h5><br />Once your DSP is up and running you can SSH into it with the following command on linux and Macs:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1"><span class="co4">$ </span><span class="kw2">ssh</span> <span class="re5">-i</span> ~<span class="sy0">/</span>.ssh<span class="sy0">/</span>your-key-name.pem dsp_user<span class="sy0">@</span>your-dsp-host-name.compute-<span class="nu0">1</span>.amazonaws.com<br />                    </pre><br /></div><br /></div><br /><h4><br />Configure Firewall</h4><br />By default, all DSPs start up with no ports open. You'll need to open up the SSH and HTTP ports. If you already<br />        have existing security groups defined that you prefer to use, select it from the list and press "Continue". To<br />        create a new security group for the DSP, follow these steps:<br /><br /><ol><br /><li> Click the <b>Create a new Security Group</b> section to display the options.</li><br /><li> Enter a <b>Group Name</b></li><br /><li> Enter a <b>Group Description</b></li><br /><li> Add the following two rules:<br />            <ol><br /><li> Select SSH from the <b>Create a new rule</b> dropdown</li><br /><li> Click <b>Add Rule</b></li><br /><li> Select HTTP from the <b>Create a new rule</b> dropdown</li><br /><li> Click <b>Add Rule</b></li><br /></ol><br /></li><br /><li> You should see these rules appear in the list of rules on the right side. If not, try again.</li><br /><li> Click <b>Continue</b> to <a href="http://www.blogger.com/blogger.g?blogID=3578917734776361640#Review_and_Launch">review your settings</a></li><br /></ol><br /><img alt="Azure Specify Endpoint" class="df-image" src="https://s3.amazonaws.com/dfImages/cloud-aws-vm5.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br />    <br /><br /><h4><br />Review and Launch</h4><br />Finally! After all that furious clicking, one last time. Click the <b>Launch</b> button to begin creating your<br />        DSP.<br /><br />Once your management console says that it is running, you can proceed to the next step.<br /><br /><img alt="Azure Specify Endpoint" class="df-image" src="https://s3.amazonaws.com/dfImages/cloud-aws-vm6.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /><br />    <br /><br /><h4><br /> Activate Your DSP </h4><br />Once your DSP is created, you'll need the IP address or DNS address of the new instance. This can be found on<br />        your EC2 management console.<br /><br /><ol><br /><li> From the list of your instances, click on the newly launched DSP instance</li><br /><li> Locate and copy your DNS address<br />            <ul><br /><li> The DNS address is shown in the bottom pane under the name of the instance. It looks something like<br />                    <b>ec2-22-34-65-153.compute-1.amazonaws.com</b>. Your IP address will obviously be different.<br />                </li><br /></ul><br /></li><br /><li> Start your favorite web browser and paste in the DNS address you just copied and go.</li><br /></ol><br /><br /><br />If all is well, you should see the DSP Activation page.<br /><br /><img alt="Azure Specify Endpoint" class="df-image" src="https://s3.amazonaws.com/dfImages/cloud-aws-vm7.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /></div><br /><br /><div id="cloud-vagrant"><br /><div class="page-header"><br /><h3><br /> Create a DSP VM using Vagrant</h3><br /></div><br /><br /><br />From the <a class="external text" href="http://vagrantup.com/" rel="nofollow">Vagrant</a> web site:<br /><br /><div class="well well-large well-transparent"><br />A Windows Azure management certificate is an X.509 v3 certificate used to authenticate an agent, such as Visual<br />        Studio Tools for Windows Azure or a client application that uses the Service Management API, acting on behalf of<br />        the subscription owner to manage subscription resources. Windows Azure management certificates are uploaded to<br />        Windows Azure and stored at the subscription level. The management certificate store can hold up to 25<br />        certificates. These certificates are used to authenticate your Windows Azure deployment.<br /><br />    <br /><br />Management certificates must have a key length of at least 2048 bits and should reside in thePersonal certificate<br />        store. When the certificate is installed on the client, it should contain the private key of the certificate. To<br />        upload to the certificate to the Windows Azure Management Portal, you must export it as a .cer format file that<br />        does not contain the private key.<br /><br />Vagrant is a tool for building complete development environments. With an easy-to-use workflow and focus on<br />        automation, Vagrant lowers development environment setup time, increases development/production parity, and<br />        makes the "works on my machine" excuse a relic of the past.<br /><br />Vagrant was started in January 2010 by Mitchell Hashimoto. For almost three years, Vagrant was a side-project for<br />        Mitchell, a project that he worked on in his free hours after his full time job. During this time, Vagrant grew<br />        to be trusted and used by a range of individuals to entire development teams in large companies.<br /><br />In November 2012, HashiCorp was formed by Mitchell to back the development of Vagrant full time. HashiCorp builds<br />        commercial additions and provides professional support and training for Vagrant.<br /><br />Vagrant remains and always will be a liberally licensed open source project. Each release of Vagrant is the work<br />        of hundreds of individuals' contributions to the open source project.</div><br /><h4><br /> Installation and Setup </h4><br />Installing and setting up <a class="external text" href="http://vagrantup.com/" rel="nofollow">vagrant</a> is beyond<br />    the scope of this guide. However, excellent resources are available on the <a class="external text" href="http://vagrantup.com/" rel="nofollow">Vagrant</a><br />    web site as well as the <a class="external text" href="http://google.com/" rel="nofollow">Google</a>.<br /><br />You are free to choose the distribution of your preference. Once set up, this guide will diverge to the appropriate<br />    package installation guide a little further down.<br /><br /><h4><br />Choosing a Distribution</h4><br />The examples on the vagrant web site use Ubuntu 12.04 LTS mostly, however you're free to choose any operating system<br />    that has a Vagrant Box available. You can even make your own. A list of public Vagrant boxes is available at <a class="external text" href="http://vagrantbox.es/" rel="nofollow">VagrantBox.es</a><br /><br /><h4><br />CentOS/Redhat</h4><br /><h4><br />Create the VM</h4><br />This step creates a new VM and downloads the box from Puppet Labs.<br /><br />First off create a new directory to house your vagrant configuration information:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1"><span class="co4">sandman@dreamfactory$ </span><span class="kw2">mkdir</span> centos6<br /><span class="co4">sandman@dreamfactory$ </span><span class="kw3">cd</span> centos6<br />            </pre><br /></div><br /></div><br />Now tell vagrant to initialize:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1">sandman@dreamfactory$ vagrant init centos6_dsp http://puppet-vagrant-boxes.puppetlabs.com/centos-64-x64-vbox4210-nocm.box<br />                <br />A Vagrantfile has been placed in this directory.<br />                <br />You are now ready to `vagrant up` your first virtual environment!<br />                <br />Please read the comments in the Vagrant file as well as documentation on `vagrantup.com` for more information on using Vagrant.<br />            </pre><br /></div><br /></div><br />This will create a file called <b>Vagrantfile</b>.<br /><br />We need to make one change to this file. It will tell vagrant to automatically set up a port forward to your DSP.<br /><br />With the text editor of your choice, edit this file and search for the the following text:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="ruby source-ruby"><br /><pre class="de1"># Create a forwarded port mapping which allows access to a specific port<br /># within the machine from a port on the host machine. In the example below,<br /># accessing "localhost:8080" will access port 80 on the guest machine.<br /># config.vm.network :forwarded_port, guest: 80, host: 8080<br />                    </pre><br /></div><br /></div><br />And uncomment the last line by removing the hash mark (<b>#</b>):<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="ruby source-ruby"><br /><pre class="de1"># Create a forwarded port mapping which allows access to a specific port<br /># within the machine from a port on the host machine. In the example below,<br /># accessing "localhost:8080" will access port 80 on the guest machine.<br />config.vm.network :forwarded_port, guest: 80, host: 8080<br />                </pre><br /></div><br /></div><br />Save the changes and start up the VM:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1">sandman@dreamfactory$ <b>vagrant up</b><br />Bringing machine 'default' up with 'virtualbox' provider...<br />[default] Box 'centos6_dsp' was not found. Fetching box from specified URL for<br />the provider 'virtualbox'. Note that if the URL does not have<br />a box for this provider, you should interrupt Vagrant now and add<br />the box yourself. Otherwise Vagrant will attempt to download the<br />full box prior to discovering this error.<br />Downloading or copying the box...<br />Extracting box...te: 2017k/s, Estimated time remaining: --:--:--)<br />Successfully added box 'centos6_dsp' with provider 'virtualbox'!<br />[default] Importing base box 'centos6_dsp'...<br />[default] Matching MAC address for NAT networking...<br />[default] Setting the name of the VM...<br />[default] Clearing any previously set forwarded ports...<br />[default] Creating shared folders metadata...<br />[default] Clearing any previously set network interfaces...<br />[default] Preparing network interfaces based on configuration...<br />[default] Forwarding ports...<br />[default] -- 22 => 2222 (adapter 1)<br />[default] -- 80 => 8080 (adapter 1)<br />[default] Booting VM...<br />[default] Waiting for VM to boot. This can take a few minutes.<br />[default] VM booted and ready for use!<br />[default] Configuring and enabling network interfaces...<br />[default] Mounting shared folders...<br />[default] -- /vagrant<br />                </pre><br /></div><br /></div><br />This creates a virtual machine based on the box that was just downloaded. SSH is available on port 2222 and a user<br />    named <b>vagrant</b> with a password of <b>vagrant</b> has been created that has sudo privileges.<br /><br />Now connect to your new VM to make sure everything's cool:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1">sandman@dreamfactory$ <b>vagrant ssh</b><br />Last login: Sun Apr 14 22:24:07 2013<br />Welcome to your Vagrant-built virtual machine.<br />vagrant@precise32:~$<br />                    </pre><br /></div><br /></div><br /><h4><br />Configuring the VM </h4><br />Now that the VM is created, we need to install the dependencies for the DSP package. These are detailed on the RPM<br />    package installation guide. Please install and enable the EPEL repository, it'll look similar, if not exactly like,<br />    the following:<br /><br /><div class="mw-geshi mw-code mw-content-ltr" title="remi.repo after"><br /><div class="bash source-bash"><br /><pre class="de1">vagrant@precise32:~$ <b>sudo apt-get install curl apache2 php5 php5-common php5-cli php5-curl php5-mcrypt php5-gd<br />                        php5-mysql mysql-server mysql-client</b><br />                    </pre><br /></div><br /></div><br />Please Note: The actual version and iteration numbers may vary as they will increase over time.<br /><br />Connect to MySQL and create a database and database user for the DSP. Please note, this example assumes that you did<br />    not assign a password to the MySQL root user during the above installation. If you did, you have to add a <b>-p</b><br />    to the command line below.<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="mysql source-mysql"><br /><pre class="de1">vagrant@precise32:~ $ <b>mysql -u root</b><br />Welcome to the MySQL monitor.  Commands end with ; or \g.<br />Your MySQL connection id is 41<br />Server version: 5.5.31-0ubuntu0.12.04.2 (Ubuntu)<br />         <br />Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.<br />         <br />Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.<br />         <br />Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.<br />         <br />mysql> <b>create database dreamfactory;</b><br />Query OK, 1 row affected (0.00 sec)<br />         <br />mysql> <b>grant all privileges on dreamfactory.* to 'dsp_user'@'localhost' identified by 'dsp_user';</b><br />Query OK, 0 rows affected (0.00 sec)<br />         <br />mysql> exit<br />Bye<br />                    </pre><br /></div><br /></div><br />At this point your VM is now configured and ready to install the DSP system.<br /><br /><h4><br /> Installing the DreamFactory Services Platform™ </h4><br />Grab a copy of the latest release from the release package repository. As of this writing, the current DSP version is<br />    <a class="external text" href="https://github.com/dreamfactorysoftware/platform-packages/tree/1.0.4" rel="nofollow">1.0.4</a>.<br /><br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1">vagrant@precise32:~$ <b>wget<br />                        https://raw.github.com/dreamfactorysoftware/platform-packages/1.0.4/dreamfactory-dsp_1.0.6-1_all.deb</b><br />                    </pre><br /></div><br /></div><br />And install it:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1">vagrant@precise32:~$ <b>sudo dpkg -i dreamfactory-dsp_1.0.6-1_all.deb</b><br />                    </pre><br /></div><br /></div><br />The package also runs the DSP install/update script. This sets up the directories and loads all non-system<br />    dependencies for you. It will take awhile on the stock vagrant VM as the memory footprint is quite small.<br /><br />There is one final thing that must be done. Because the packages are meant to be installed on systems that may or may<br />    not have other software, this package does not replace the default web site installed with the Apache web server. If<br />    this is a fresh install, you must disable the Apache default web site so the DSP will become the default web<br />    site.<br /><br />To disable the default Apache web site, do the following:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1">vagrant@precise32:/etc/apache2/sites-enabled$ <b>sudo a2dissite 000-default</b><br />Site default disabled.<br />To activate the new configuration, you need to run:<br />    service apache2 reload<br />vagrant@precise32:/etc/apache2/sites-enabled$ <b>sudo service apache2 reload</b><br />* Reloading web server config apache2<br />apache2: Could not reliably determine the server′s fully qualified domain name, using 127.0.1.1 for ServerName<br />                     </pre><br /></div><br /></div><br />That last bit about reliably determining the server's name, don't worry about it.<br /><br />The DSP is completely installed with all dependencies and ready for use.<br /><br />Open you favorite browser and go to <a class="external free" href="http://localhost:8080/" rel="nofollow">http://localhost:8080/</a>.<br />    This is the URL for the DSP we just installed.<br /><br /><img alt="Azure Specify Endpoint" class="df-image" src="https://s3.amazonaws.com/dfImages/cloud-vagrant-vm1.png" style="border-radius: 10px 10px 10px 10px; border: 3px solid #F06B36; margin: 20px;" /><br /></div><br /></section><br /><br /><section><br />    <br />    <div id="local-ubuntu"><br /><div class="page-header"><br /><h3><br />Debian or Ubuntu System</h3><br /></div><br /><br /><br />Below are the instructions to create the DreamFactory Services Platform™ (DSP) on an existing<br />            Debian/Ubuntu system. Obviously, it is assumed that you have root access to said machine and it is<br />            operational.<br /><br /><h4><br />Procurement</h4><br />You'll need a copy of the latest package from the official <a class="external text" href="https://github.com/dreamfactorysoftware/platform-packages" rel="nofollow">DreamFactory<br />            DSP repository</a>. There are also versions for CentOS and Redhat in the repository. You can also download<br />            the image by doing the following on your system:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1"><span class="co4">$ </span><span class="kw2">wget</span> https:<span class="sy0">//</span>github.com<span class="sy0">/</span>dreamfactorysoftware<span class="sy0">/</span>platform-packages<span class="sy0">/</span>raw<span class="sy0">/</span>master<span class="sy0">/</span>dreamfactory-dsp_1.1.2-0_all.deb<br />            </pre><br /></div><br /></div><br /><h4><br />Prerequisites</h4><br />If you are upgrading an existing installation, you may skip this section. This is only for new<br />            installations.<br /><br />The DreamFactory Services Platform™ requires the following packages to run:<br /><br /><ul><br /><li>curl</li><br /><li>apache2</li><br /><li>php5</li><br /><li>php5-common</li><br /><li>php5-cli</li><br /><li>php5-curl</li><br /><li>php5-mcrypt</li><br /><li>php5-gd</li><br /><li>php5-mysql</li><br /><li>mysql-server</li><br /><li>mysql-client</li><br /><li>git</li><br /></ul><br /><h4><br />Installation</h4><br />Once you've procured the package, it needs to be installed. If you are upgrading, the package manager will<br />            automatically upgrade your existing installation, otherwise it will install a fresh copy.<br /><br />To install or upgrade the package, type the following:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1"><span class="co4">$ </span><span class="kw2">sudo</span> <span class="kw2">dpkg</span> <span class="re5">-i</span> dreamfactory-dsp_1.1.2-0_all.deb<br />            </pre><br /></div><br /></div><br /></div><br /><br />    <div id="local-centos"><br /><div class="page-header"><br /><h3><br />CentOS or Redhat System</h3><br /></div><br /><br /><br />Below are the instructions to create t172.1he DreamFactory Services Platform™ (DSP) on an existing<br />            CentOS or Redhat system. Obviously, it is assumed that you have root access to said machine and it is<br />            operational.<br /><br /><h4><br />Procurement</h4><br />You'll need a copy of the latest package from the official <a class="external text" href="https://github.com/dreamfactorysoftware/platform-packages" rel="nofollow">DreamFactory<br />            DSP repository</a>. There are also versions for Debian and Ubuntu in the repository. You can also download<br />            the image by doing the following on your system:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1"><span class="co4">$ </span><span class="kw2">wget</span> https:<span class="sy0">//</span>github.com<span class="sy0">/</span>dreamfactorysoftware<span class="sy0">/</span>platform-packages<span class="sy0">/</span>raw<span class="sy0">/</span>master<span class="sy0">/</span>dreamfactory-dsp-1.1.2-0.noarch.rpm<br />            </pre><br /></div><br /></div><br /><h4><br />Prerequisites</h4><br />If you are upgrading an existing installation, you may skip this section. This is only for new<br />            installations.<br /><br />The DreamFactory Services Platform™ requires the following packages to run:<br /><br /><ul><br /><li>curl</li><br /><li>httpd</li><br /><li>php</li><br /><li>php-common</li><br /><li>php-cli</li><br /><li>php-curl</li><br /><li>php-mcrypt</li><br /><li>php-gd</li><br /><li>php-mysql</li><br /><li>php-posix</li><br /><li>mysql-server</li><br /><li>git</li><br /></ul><br />Please note that the <b>php-mcrypt</b> package isn't available is some package repositories. If this is the<br />            case, you can add the <a class="external text" href="http://fedoraproject.org/wiki/EPEL" rel="nofollow">RHEL<br />                EPEL</a> repository to your sources list. Instructions for doing this are available <a class="external text" href="http://www.rackspace.com/knowledge_center/article/installing-rhel-epel-repo-on-centos-5x-or-6x" rel="nofollow">here</a>.<br /><br /><h4><br />Configuring Your System</h4><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1"><span class="br0">[</span>thedude<span class="sy0">@</span>localhost:~<span class="br0">]</span>$ <span class="kw2">sudo</span> <span class="kw2">yum install</span> curl httpd php php-common php-cli php-curl php-mcrypt php-gd php-mysql mysql-server <span pre=""><br />            </span></pre><br /></div><br /></div><br /><h4><br />Installation</h4><br />Once you've procured the package, it needs to be installed. If you are upgrading, the package manager will<br />            automatically upgrade your existing installation, otherwise it will install a fresh copy.<br /><br />To install or upgrade the package, type the following:<br /><br /><div class="mw-geshi mw-code mw-content-ltr"><br /><div class="bash source-bash"><br /><pre class="de1"><span class="co4">$ </span><span class="kw2">sudo</span> rpm <span class="re5">-Uvh</span> dreamfactory-dsp-1.1.2-0.noarch.rpm<br />            </pre><br /></div><br /></div><br /></div><br /></section><br /></div><br /></div><br /><script type="text/javascript"><br />/*!<br /> * jQuery.ScrollTo<br /> * Copyright (c) 2007-2012 Ariel Flesler - aflesler(at)gmail(dot)com | http://flesler.blogspot.com<br /> * Dual licensed under MIT and GPL.<br /> * Date: 4/09/2012<br /> *<br /> * @projectDescription Easy element scrolling using jQuery.<br /> * http://flesler.blogspot.com/2007/10/jqueryscrollto.html<br /> * @author Ariel Flesler<br /> * @version 1.4.3.1<br /> *<br /> * @id jQuery.scrollTo<br /> * @id jQuery.fn.scrollTo<br /> * @param {String, Number, DOMElement, jQuery, Object} target Where to scroll the matched elements.<br /> *	  The different options for target are:<br /> *		- A number position (will be applied to all axes).<br /> *		- A string position ('44', '100px', '+=90', etc ) will be applied to all axes<br /> *		- A jQuery/DOM element ( logically, child of the element to scroll )<br /> *		- A string selector, that will be relative to the element to scroll ( 'li:eq(2)', etc )<br /> *		- A hash { top:x, left:y }, x and y can be any kind of number/string like above.<br /> *		- A percentage of the container's dimension/s, for example: 50% to go to the middle.<br /> *		- The string 'max' for go-to-end.<br /> * @param {Number, Function} duration The OVERALL length of the animation, this argument can be the settings object instead.<br /> * @param {Object,Function} settings Optional set of settings or the onAfter callback.<br /> *	 @option {String} axis Which axis must be scrolled, use 'x', 'y', 'xy' or 'yx'.<br /> *	 @option {Number, Function} duration The OVERALL length of the animation.<br /> *	 @option {String} easing The easing method for the animation.<br /> *	 @option {Boolean} margin If true, the margin of the target element will be deducted from the final position.<br /> *	 @option {Object, Number} offset Add/deduct from the end position. One number for both axes or { top:x, left:y }.<br /> *	 @option {Object, Number} over Add/deduct the height/width multiplied by 'over', can be { top:x, left:y } when using both axes.<br /> *	 @option {Boolean} queue If true, and both axis are given, the 2nd axis will only be animated after the first one ends.<br /> *	 @option {Function} onAfter Function to be called after the scrolling ends.<br /> *	 @option {Function} onAfterFirst If queuing is activated, this function will be called after the first scrolling ends.<br /> * @return {jQuery} Returns the same jQuery object, for chaining.<br /> *<br /> * @desc Scroll to a fixed position<br /> * @example $('div').scrollTo( 340 );<br /> *<br /> * @desc Scroll relatively to the actual position<br /> * @example $('div').scrollTo( '+=340px', { axis:'y' } );<br /> *<br /> * @desc Scroll using a selector (relative to the scrolled element)<br /> * @example $('div').scrollTo( 'p.paragraph:eq(2)', 500, { easing:'swing', queue:true, axis:'xy' } );<br /> *<br /> * @desc Scroll to a DOM element (same for jQuery object)<br /> * @example var second_child = document.getElementById('container').firstChild.nextSibling;<br /> *			$('#container').scrollTo( second_child, { duration:500, axis:'x', onAfter:function(){<br /> *				alert('scrolled!!');<br /> *			}});<br /> *<br /> * @desc Scroll on both axes, to different values<br /> * @example $('div').scrollTo( { top: 300, left:'+=200' }, { axis:'xy', offset:-20 } );<br /> */<br /><br />;<br />(function ($) {<br /><br />    var $scrollTo = $.scrollTo = function (target, duration, settings) {<br />        $(window).scrollTo(target, duration, settings);<br />    };<br /><br />    $scrollTo.defaults = {<br />        axis: 'xy',<br />        duration: parseFloat($.fn.jquery) >= 1.3 ? 0 : 1,<br />        limit: true<br />    };<br /><br />    // Returns the element that needs to be animated to scroll the window.<br />    // Kept for backwards compatibility (specially for localScroll & serialScroll)<br />    $scrollTo.window = function (scope) {<br />        return $(window)._scrollable();<br />    };<br /><br />    // Hack, hack, hack :)<br />    // Returns the real elements to scroll (supports window/iframes, documents and regular nodes)<br />    $.fn._scrollable = function () {<br />        return this.map(function () {<br />            var elem = this,<br />                    isWin = !elem.nodeName || $.inArray(elem.nodeName.toLowerCase(), ['iframe', '#document', 'html', 'body']) != -1;<br /><br />            if (!isWin)<br />                return elem;<br /><br />            var doc = (elem.contentWindow || elem).document || elem.ownerDocument || elem;<br /><br />            return /webkit/i.test(navigator.userAgent) || doc.compatMode == 'BackCompat' ?<br />                    doc.body :<br />                    doc.documentElement;<br />        });<br />    };<br /><br />    $.fn.scrollTo = function (target, duration, settings) {<br />        if (typeof duration == 'object') {<br />            settings = duration;<br />            duration = 0;<br />        }<br />        if (typeof settings == 'function')<br />            settings = { onAfter: settings };<br /><br />        if (target == 'max')<br />            target = 9e9;<br /><br />        settings = $.extend({}, $scrollTo.defaults, settings);<br />        // Speed is still recognized for backwards compatibility<br />        duration = duration || settings.duration;<br />        // Make sure the settings are given right<br />        settings.queue = settings.queue && settings.axis.length > 1;<br /><br />        if (settings.queue)<br />        // Let's keep the overall duration<br />            duration /= 2;<br />        settings.offset = both(settings.offset);<br />        settings.over = both(settings.over);<br /><br />        return this._scrollable().each(function () {<br />            // Null target yields nothing, just like jQuery does<br />            if (target == null) return;<br /><br />            var elem = this,<br />                    $elem = $(elem),<br />                    targ = target, toff, attr = {},<br />                    win = $elem.is('html,body');<br /><br />            switch (typeof targ) {<br />                // A number will pass the regex<br />                case 'number':<br />                case 'string':<br />                    if (/^([+-]=)?\d+(\.\d+)?(px|%)?$/.test(targ)) {<br />                        targ = both(targ);<br />                        // We are done<br />                        break;<br />                    }<br />                    // Relative selector, no break!<br />                    targ = $(targ, this);<br />                    if (!targ.length) return;<br />                case 'object':<br />                    // DOMElement / jQuery<br />                    if (targ.is || targ.style)<br />                    // Get the real position of the target<br />                        toff = (targ = $(targ)).offset();<br />            }<br />            $.each(settings.axis.split(''), function (i, axis) {<br />                var Pos = axis == 'x' ? 'Left' : 'Top',<br />                        pos = Pos.toLowerCase(),<br />                        key = 'scroll' + Pos,<br />                        old = elem[key],<br />                        max = $scrollTo.max(elem, axis);<br /><br />                if (toff) {// jQuery / DOMElement<br />                    attr[key] = toff[pos] + ( win ? 0 : old - $elem.offset()[pos] );<br /><br />                    // If it's a dom element, reduce the margin<br />                    if (settings.margin) {<br />                        attr[key] -= parseInt(targ.css('margin' + Pos)) || 0;<br />                        attr[key] -= parseInt(targ.css('border' + Pos + 'Width')) || 0;<br />                    }<br /><br />                    attr[key] += settings.offset[pos] || 0;<br /><br />                    if (settings.over[pos])<br />                    // Scroll to a fraction of its width/height<br />                        attr[key] += targ[axis == 'x' ? 'width' : 'height']() * settings.over[pos];<br />                } else {<br />                    var val = targ[pos];<br />                    // Handle percentage values<br />                    attr[key] = val.slice && val.slice(-1) == '%' ?<br />                            parseFloat(val) / 100 * max<br />                            : val;<br />                }<br /><br />                // Number or 'number'<br />                if (settings.limit && /^\d+$/.test(attr[key]))<br />                // Check the limits<br />                    attr[key] = attr[key] <= 0 ? 0 : Math.min(attr[key], max);<br /><br />                // Queueing axes<br />                if (!i && settings.queue) {<br />                    // Don't waste time animating, if there's no need.<br />                    if (old != attr[key])<br />                    // Intermediate animation<br />                        animate(settings.onAfterFirst);<br />                    // Don't animate this axis again in the next iteration.<br />                    delete attr[key];<br />                }<br />            });<br /><br />            animate(settings.onAfter);<br /><br />            function animate(callback) {<br />                $elem.animate(attr, duration, settings.easing, callback && function () {<br />                    callback.call(this, target, settings);<br />                });<br />            };<br /><br />        }).end();<br />    };<br /><br />    // Max scrolling position, works on quirks mode<br />    // It only fails (not too badly) on IE, quirks mode.<br />    $scrollTo.max = function (elem, axis) {<br />        var Dim = axis == 'x' ? 'Width' : 'Height',<br />                scroll = 'scroll' + Dim;<br /><br />        if (!$(elem).is('html,body'))<br />            return elem[scroll] - $(elem)[Dim.toLowerCase()]();<br /><br />        var size = 'client' + Dim,<br />                html = elem.ownerDocument.documentElement,<br />                body = elem.ownerDocument.body;<br /><br />        return Math.max(html[scroll], body[scroll])<br />                - Math.min(html[size], body[size]);<br />    };<br /><br />    function both(val) {<br />        return typeof val == 'object' ? val : { top: val, left: val };<br />    };<br /><br />})(jQuery);<br /></script><br /><script type="text/javascript"><br /><br />    $('[href=#]').click(function (e) {<br />        e.preventDefault()<br />    })<br /><br />    $('#leftMenu [href^=#]').on('click', function (e) {<br />        e.preventDefault(); // prevent browser scroll<br /><br />        var target = $(this.getAttribute('href'));<br />        $('#docDiv').scrollTo(target);<br />    });<br /><br />    /*<br />     $('#leftMenu').on('activate', 'ul.nav li', function()<br />     {<br /><br />     });<br />     */<br /><br /></script></div><br /></div><br /></div><br /><footer><br />                </footer><br />  <br />  <br /></article> <br /><br />                        </section><br />                    </div><br /><br /><a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseOne" data-toggle="collapse" href="http://www.blogger.com/null"> Dreamfactory Service Platform<br />                </a><br />            <br />            <br /><br /><div class="accordion-body in collapse" id="collapseOne" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#dreamfactory-services-platform"> Dreamfactory<br />                            Services Platform Overview</a></li><br /></ul><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseTwo" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     Developer Features<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseTwo" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#feature-cors"> CORS support</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#feature-NoSQL"> NoSQL Access</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#feature-provider"> Authentication Providers</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#feature-rfs"> Remote File Storage</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseThree" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     Live Rest API<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseThree" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list "><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#rest-api"> Swagger Live Rest API</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseFour" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     DSP Free Edition<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseFour" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#dsp-account"> Account Setup</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#dsp-access"> Creating Your DSP</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#dsp-management"> Manage Your DSP</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseFive" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     Admin Console User Guide<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseFive" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-overview"> Admin Console Overview</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#admin-apps"> Applications</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#admin-users"> Users</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-roles"> Roles</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-groups"> Groups</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-data"> Manage Data</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#admin-services"> Services</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#admin-files"> Files</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-schema"> Manage Schema</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#admin-packages"> Packages</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#admin-sysconfig"> System Config</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseSix" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     DSP on Your Cloud<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseSix" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#cloud-azure"> Windows Azure</a></li><br /><li class=""><a href="https://www.dreamfactory.com/developers/documentation/main#cloud-ec2"> Amazon EC2</a></li><br /><li class="active"><a href="https://www.dreamfactory.com/developers/documentation/main#cloud-vagrant"> Vagrant</a></li><br /></ul><br /></div><br /></div><br /></div><br /><div class="accordion-group"><br />            <div class="accordion-heading"><br />                <a class="accordion-toggle" data-parent="#leftMenu" data-target="#collapseSeven" data-toggle="collapse" href="http://www.blogger.com/null"><br />                     DSP on an Existing System<br />                </a><br />            </div><br /><div class="accordion-body in collapse" id="collapseSeven" style="height: auto;"><br />                <div class="accordion-inner"><br />                    <ul class="nav nav-list"><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#local-ubuntu"> Debian or Ubuntu System</a></li><br /><li><a href="https://www.dreamfactory.com/developers/documentation/main#local-centos"> CentOS or Redhat system</a></li><br /></ul><br /></div><br /></div><br /></div><br /></div><br />

dreamfactory documentation

Dreamfactory Service Platform Dreamfactory ...