Troubleshooting issues when developing code-based applications - Documentation for BMC Helix Innovation Studio 22.1

Issue symptomIssue scopeResolution

The following error is displayed:

Failed to execute goal org.apache.maven.plugins:maven-archetype-plugin:3.2.0:generate (default-cli) on project standalone-pom: Execution default-cli of goal org.apache.maven.plugins:maven-arch lugin:3.2.0:generate failed: A required class was missing while executing org.apache.maven.plugins:maven-archetype-plugin:3.2.0:generate: org/apache/commons/lang/StringUtils

To create a project for application development, you run the following command:

mvn archetype:generate -DarchetypeGroupId=com.bmc.arsys -DarchetypeArtifactId=rx-sdk-archetype-application -DarchetypeCatalog=local

1. Delete the local .m2/repository contents.
2. Install BMC Helix Innovation Studio SDK.
3. Run the command to create a project for application development.

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

After you complete the initial deployment, if you deploy the package multiple times by using the following command:

mvn clean install -Pdeploy

After you complete the initial deployment, export the application by using the following command:

mvn install -Pexport

The following errors are displayed:

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.0:compile (default-compile) on project hello-world: Fatal error compiling: invalid target release: 11 -> [Help 1]

[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.

[ERROR] Re-run Maven using the -X switch to enable full debug logging.

You install BMC Helix Innovation Studio SDK and the components required to develop applications. 

Create a JAVA_HOME environment variable pointing to C:\Tools\Java\ jdk-11.0.7.

For more information, see Setting up your IDE and installing BMC Helix Innovation Studio SDK.

The following errors are displayed:

[INFO] Authenticating User developer

[ERROR] User [developer] is not authenticated.

javax.ws.rs.NotAuthorizedException: HTTP 401 Unauthorized

To deploy the package, you run the following command:

mvn clean install -Pdeploy

1. Open the parent pom.xml file located in project folder. For example, projects\work-order-lib\pom.xml.

2. Enter the correct developer username that you created while requesting a sandbox.

For more information, see Creating a Project using Maven and the Archetype.

The REST Resource is not found at run-time.

If you have bundled REST resources with the deployed application or library. 

Register the REST resource in the application bundle. 

registerRestfulResource(new <bundleClass>());

The bundle deployment fails with the following error:

6616 Invalid version range specified for import packages in the bundle JAR manifest.

When you deploy a custom code-based bundle where the bundle version is not within the specified range of [0-999).

For the deployed code-based bundle, update the MANIFEST.MF file to remove the bundle version. To update the the MANIFEST.MF file, perform the following steps:

1. From /bundle/target folder open the <your-application>SHOT.jar file.
2. From the .jar file, open the MANIFEST.MF file.
3. Copy the comma-separated list of packages from the <Import-Package> tag.

4. Open the /bundle/pom.xml file located in the project folder.

5. In the <Import-Package> tag, for each package copied from MANIFEST.MF file, add the following content:

   <Import-Package>	<package-name>;version=!,	<package-name>;version=!
   <Import-Package>

   For example: 

   <Import-Package>	com.bmc.arsys*;version=!,	org.glassfish;version=!,	javax.annotation*;version=!	*;version=!;resolution:=optional,
   </Import-Package>