Deploying your 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 library) development.


To manage the data for the application (or library), you should deploy the deployment package to the BMC Helix Innovation Studio.

The following video (5:07) provides you with the information to deploy the Maven project to the BMC Helix Innovation Studio.

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


icon_play.png https://youtu.be/A7B6xXoElw0

Related topic

Developing-and-deploying-code-based-applications

To deploy a package

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

 mvn clean install -Pdeploy

For example:

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

Important

The com.bmc.* namespace is reserved for lines of business and BMC-specific bundles. Do not use this namespace in your Group ID because it might lead to performance issues. If your package bundle is either empty or contains only localized-string.def file and has com.bmc.* as Group ID, the following warning message is displayed during deployment:

Deploying a non-BMC application or library with a com.bmc.* group ID might result in performance, upgrade, and server availability issues.

Important

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, after you complete the initial deployment,  run the following command to export the application: mvn install -Pexport.

When you deploy the package to the BMC Helix Innovation Studio:

  • The deployment package is created as a zip file; for example, com.example.suggestion-box1.0SNAPSHOT.zip.
    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>
    • code <jar file>
    • package manifest file -  The name of this file is in the following format: <Bundle ID>.manifest
      For example: com.assocuation.ConfigData.manifest

    The .jar file stores the code for your application. The .def files store definitions for your application. 

  • You can access the application in BMC Helix Innovation Studio.

    Important

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

In the BMC Helix Innovation Studio, on the Workspace tab, select deployed application. To launch the application, click Visit deployed application.

You can import the bundle project in Eclipse. Eclipse enables you to modify and test the Java 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.

1802_Import+Maven+Project.png

Important

You cannot rename the bundle after importing it to Eclipse.

Where to go from here

Using-components-from-another-application-or-library

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*