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 Digital Service 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 Platform 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 Platform server.
The video shows an older version of BMC Helix Platform. The previous product name was BMC Helix Innovation Suite. Although there might be minor changes in the UI, the overall functionality remains the same.
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 Platform 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
- record
- code <jar file>
- manifest file
- db
You can access the application in BMC Helix Innovation Studio.
Note
You must login to BMC Helix Innovation Studio 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 application page, you can launch the application using the Launch Deployed Application link .
You can import the bundle project in Eclipse. 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.Note
You cannot rename the bundle after importing it to Eclipse.
Comments
Log in or register to comment.