This documentation supports the 22.1 version of BMC Helix Innovation Studio.To view an earlier version, select the version from the Product version menu.

Troubleshooting issues when developing code-based applications


This topic describes how to resolve issues that you might encounter while developing code-based applications.

Issue symptom

Issue scope

Resolution

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>

 

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