Deploy

BusinessEvents application archives might be deployed directly to an appropriate Silver Fabric engine (TIBCO Logical Machine) by calling the REST method. In this document cURL syntax is used to show REST inputs in a generic form:

curl -u UserName:Password \
     -X POST \
     -H "Accept:application/json" \
     -H "Content-Type: multipart/form-data" \
     -F "archiveFile=@YourArchiveName.zip" \
     -F "deploymentFile=@YourDeploymentFileName.properties" \
    [-F "LogicalAnd=false"]
     -v "http://YourSFBroker.com:<port>/livecluster/rest/v1/sf/engines/archives"
    [-F "AppName=YourDirABC/YourAppName"]
    [-F "AppSettings.element1.element2=SomeValue"]
    [-F "ArchiveSettings.element1.element2=SomeValue"]
    [-F "Archives=Archive_A,Archive_B,Archive_X"]
    [-F "CDD=ApplicationCDDName.cdd"]
    [-F "configurationFile=YourConfigurationfile.xml"]
    [-F "ForceDeploy=true"]
    [-F "GV=globalVariableA=123,globalVarB=SomeString"]
    [-F "InstanceSettings.element1.element2=SomeValue"]
    [-F "NoDeploy=true"]
    [-F "NoStart=true"]
    [-F "NAME=value"]
    [-F "JMX_PORT=value"]
    [-F "GLOBAL_FILE=/opt/qa/config.cfg"]
    [-F "NoStop=true"]
    [-F "PUID=PUID_Value"]
    [-F "VariableProvider=Provider_A, Provider_B, Provider_X"]
    [-F "StreamBase.ServerURI=StreamBase_Server_URI"]
    [-F "StreamBase.UserName=User_Name"]
    [-F "StreamBase.Password=Password"]

Where inputs bounded by square brackets are optional. File names, elements, variable names, and any values shown in italics should be substituted by your implementation values.

Tip: In a cURL statement all values must be URL-encoded so that special characters such as spaces, for example, are converted to "%20". Other special characters like forward slashes "/" must also be converted to"%2F" or their respective URL encoded values so they can be sent and received properly.

Expressions in the generic form cURL expression, shown in the previous syntax were separated by line breaks to help with readability, but normally a string is submitted in the execution as shown in the following example:

A cURL archives deploy statement:

curl -u admin:admin -X POST -H "Accept:application/json" -H "Content-Type: multipart/form-data" -v http://MySFBroker.com:8080/livecluster/rest/v1/sf/engines/archives -F "archiveFile=@MyProcessOrder.ear" -F "AppName=MyOrders/MyProcOrder" -F "CDD=ApplicationCDDName.cdd" -F "PUID=PUID_Value" -F "deploymentFile=@MyDeployCriteria.properties"

Where the user specified by -u must have Silver Fabric administrator level permissions, and the form-data fields (-F "property=value") are specified in any order.