Skip to end of metadata
Go to start of metadata


Page Contents

TopBraid projects are workspace directories that contain multiple resources, such as asset collections, teamwork settings and working copies, and various configurations, etc. This section describes three methods for deploying projects to a TopBraid Suite server (i.e., EDG, EVN, or TBL) from three different project sources: (1) a TopBraid Composer IDE - Maestro Edition (TBC-ME), (2) a .zip file of a project (directory), or (3) another TopBraid server.

TopBraid Composer Export

Developers can design and test semantic content and web applications using TBC-ME, and then deploy those projects to a TopBraid (Live) server (i.e., EDG, EVN, TBL). TBC-ME has a custom Export wizard that deploys projects from its workspace into an existing TopBraid server. In TBC-ME, select a project (in a Project Explorer or Navigator view), and then either right-click the project or use File and select Export... > TopBraid Composer > Deploy Project to TopBraid Live Server.

 

Click next in this wizard:

Check the Send necessary connection credentials checkbox (to include the database credentials of the RDBMS connection in secured storage). Clicking Finish will zip up the entire selected project with all the RDBMS connection files, and other project files, and send it to the server specified in the ‘Server URL’. And it will unzip it at the destination server in the workspace directory.

Upload Project to Server

Users can click the ‘Project Upload’ link from the admin page.

First create a zip file for the project folder (including the .project file) in your system. And click the ‘Choose file’ button to select such zip file. It should upload the zip file into the server, and unzip it properly in its workspace directory. This method will not create any database credentials in the server.

Send Projects between Servers

TBL administrators can send projects from one TBL server to another one, e.g., from a test server to a production server. From the Admin page, select Server Administration > Send Projects to Another Server. NOTE: Before using this feature please make sure to have a recent backup on both the sending and receiving servers.

Projects to Send

This provides a list of all projects able to be sent to another server. Click the dropdown arrow to the left of the project to select individual graphs you would like to send.

Options

"Also send database triples" will send the database triples. Leaving this option unchecked will only send the connector files.

"Clear the target project of triples before sending triples" will clear the data from the receiving server before sending the project. 

Appendix: Web Services For Deployment

We also provide REST web service to perform HTTP requests for the following tasks if you have such needs to do so. You can perform the followings using simple HTTP requests, this can help with initially setting up a server.

The following tables show the exact HTTP requests and parameters required to perform the specified tasks. The bold words are required system keyword, whereas the italics words (e.g. ${xxx}) should be replaced with your specific details.

  • To create a new TBL Project, use the createProjectService to create a new vocab by specifying a new vocab name and new vocab name space.

Send this http request to the destination server

Http requestGET request
Pathtbl/tbl/swp
Parameters: 
_viewClass http://topbraid.org/teamwork#CreateProjectService
_snippettrue
projectType http://tbl.topbraidlive.org/tblprojects#ProjectType
owlImports http://www.w3.org/2004/02/skos/core
spinImports http://topbraid.org/spin/tblconstraints
name${newVocabName}
defaultNamespace${newVocabNameSpace}
  • To load rdf file into the vocab Use importRDFFileService to load a .ttl file into an existing vocab.

send this http request to the destination server

Http requestPOST request
Pathtbl/tbl/swp
Parameters:(use Multipart-form data) 
_viewClass http://topbraid.org/teamwork#ImportRDFFileService
_base

urn:x-evn-master:${vocabName} 

projectGraph

urn:x-evn-master:${vocabName} 

formatturtle
recordtrue
file${RDFFileName} (should be the absolute path to that ttl file e.g. C:\Users\user1\Downloads\DBPediaCountryCapitals.sms.ttl, mime-type is application/octet-stream)
  • To deploy a project Use unzipProject service to deploy a project (in .zip file) to a destination server.

create a zip file of the directory of the project first, and send this http request to the destination server

Http requestPOST request
Pathtbl/tbl/unzipProject
Parameters: (use Multipart-form data) 
old_projectupdate
projectName${ProjectName}
project${ProjectName.zip} (the absolute path to that zip file location.
  • To delete a project Use deleteProject service to delete a project in the server.

Http requestPOST request
Pathtbl/tbl/deleteProject
Parameters: 
appName${project name}
delNameproject
  • To send triples for a baseURI Use sendTriples service to send triples for a baseURI from the source server to the destination server

send this http request to the source server, this will send triples from the source graph store to the destination server

Http requestPOST request
Pathtbl/tbl/sendTriples
Parameters: (use Multipart-form data) 
graphURI${baseURI}
serverURL${destURL} (e.g. http://black.tqinc.info:7080/tbl/tbl/)
userName${destUserName}
password${destPassword}


  • No labels