Phased rollout

 

This version of the software is currently available only to early adopter SaaS customers as the first step in our phased rollout. Click here to view an earlier version.

Deploying your Digital Service application for the first time to start working in BMC Helix Innovation Studio

Before you begin make sure that you create a project for an application (or smart library) development. To manage the data for the application (or smart library), you should deploy the deployment package to the BMC Helix Innovation Studio server.

To deploy a package

Navigate to the <artifactId> directory (parent folder) of your application project (or smart library project) and run the following command: 

 mvn clean install -Pdeploy 

The following video (5:07) provides details on how to deploy the Maven project to BMC Helix Innovation Studio server.

The video shows an older version of BMC Helix Innovation Studio. The previous product name was BMC Helix Innovation Suite. Although there might be minor changes in the UI, the overall functionality remains the same.

 https://youtu.be/A7B6xXoElw0

For example:

\projects> cd suggestion-box
\projects\suggestion-box> mvn clean install -Pdeploy 

Important

As a developer, after you complete the initial deployment, if you deploy the package multiple times using the command mvn clean install -Pdeploy duplicate log configurations are created for the application and the following error occurs:

DeploymentPackage [packageDeployStatus=Error, packageName=com.example.test-smart-app, packageVersion=1.0.00-SNAPSHOT,  currentServersInSync=true, newlyAddedServers=[], jarToServerDeployStatusMap={onbmc-s=ReadyDeploy}, ErrorMessages=PARSE_DEF_IMPORT_STATUS:
IMPORTING_SERVER:onbmc-s:10.133.77.92
IMPORT_APPLICATION_ERROR: ERROR (382): The value(s) for this entry violate a unique index that has been defined for this form;  Error importing record 1: FormName: AppLocalConfig_ComponentBase
WARNING (55): The following item was not imported

As a workaround, export the application after you complete the initial deployment, by using the command mvn install -Pexport.

When you deploy the package to BMC Helix Innovation Studio server,

  • The deployment package is a zip file (for example, com.example.suggestion-box1.0SNAPSHOT.zip) is created. It is located in the target directory in the application package directory (for example, \projects\suggestion-box\package\target\com.example.suggestion-box1.0SNAPSHOT.zip).
    The zip file consists of the following folders and files:
    • db
      • record
        • <record-definition-name1>.def
        • <record-definition-name2>.def
        • <record-definition-name3>.def
        • <record-definition-name3>.options
        • <record-definition-name3>.data
        • <record-definition-name3>.delete
      • process
        • <process-definition-name1>.def
        • <process-definition-name2>.def
      • rule
        • <rule-definition-name>.def
      • association
      • view
        • <view-definition-name>.def
      • named-list
        • <named-list-definition-name1>.def
        • <named-list-definition-name2>.def
      • localized-string
        • <localized-strings.def>
      • configuration.data

      • role.data

    • code <jar file>
    • manifest file
    The .jar file is used to store the code for your application and the .def files are used to store definitions for your application. 
  • You can access the application in BMC Helix Innovation Studio.

    Important

    You must  login to BMC Helix Innovation Studio by using the credentials of the developer account. A developer account is set with an administrator role. The developer account does not require the domain identifier to log in. You can login to BMC Helix Innovation Studio with just the user name without the developer.com domain.

  • In the BMC Helix Innovation Studio, from the Workspace > deployed application page, you can launch the application by using the Visit Deployed Application link .

  • You can import the bundle project in Eclipse. By using Eclipse you can modify the Java code and test the code.
    To import the application to Eclipse, you should import the POM file to Eclipse using the Import command (File > Import> General > Maven Projects) and set the root folder to the bundle directory of the project.

    Important

    You cannot rename the bundle after importing it to Eclipse.

Where to go from here

Using components from another application or library

Was this page helpful? Yes No Submitting... Thank you

Comments