Installing, reinstalling, or uninstalling codeless applications

After you create the deployment packages for a codeless application, you can install the install package from BMC Helix Innovation Studio. You can also reinstall an application that was modified by using Maven archetype or an earlier version of the application. You can also uninstall the unnecessary applications from BMC Helix Innovation Studio.

Related topics

Developing-codeless-applications

Deploying-codeless-applications

Before you begin

Make sure that you complete the following actions:

  • Create a codeless application in Innovation Studio. 

  • Create an install package or an update package from BMC Helix Innovation Studio.

    Important

    If you want to view the deployment package contents, use the 7 Zip utility to extract the contents of the ZIP file. You cannot extract the contents of the install ZIP file using the Windows Zip utility or Mac archive utility.

  • Download the install package or update package from the version control system used by your project.

To install applications in BMC Helix Innovation Studio

As an administrator, you can install a package by using BMC Helix Innovation Studio. An install package enables you to deploy the application for the first time to development, test, or production environments. If an application is already installed, installing a full install package of the same application overwrites the application data.

  1. Log in to BMC Helix Innovation Studio and navigate to the Workspace tab. 
  2. Click Install.  

  3. Browse and select the ZIP file of the install package that you downloaded to your local computer.

    Browse and select the ZIP file of the deployment package that you copied to the environment.
    The status of the installation process is displayed in the Install dialog box. After the process is completed, click Close.

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.


The application is installed in BMC Helix Innovation Studio and is displayed in the Workspace. You can then customize the application by adding record definitions, view definitions, processes, or rules.

If the installation fails, see Troubleshooting-codeless-application-deployment-issues for information about the error and workaround.

To reinstall codeless applications in BMC Helix Innovation Studio

You can reinstall an earlier version of the application. During reinstallation, BMC Helix Innovation Studio overwrites the definitions in the existing application. The record definitions are retained; however, data of newly added record fields is lost. The application version is overwritten with the reinstalled application's version, which is specified during packaging and exporting the application or in Maven archetype. 

  1. Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
    221_Workspace.png
  2. Select the codeless application that you want to reinstall.
    The application details are displayed.
  3. Select Actions > Reinstall application.
    221_Reinstall IS app.png
  4. In the Warning dialog box, click Yes to proceed.
    221_Reinstall IS app_Warning.png
  5. Browse and select the ZIP file of the install package or update package that you want to reinstall.
    The status of the installation process is displayed in the Reinstall dialog box.

  6. After the process is completed, click Close. 

    If the reinstallation fails, see Troubleshooting-codeless-application-deployment-issues.

The codeless application is reinstalled in BMC Helix Innovation Studio. You can then modify the codeless application by adding record definitions, view definitions, processes, or rules.

To uninstall codeless applications or libraries from BMC Helix Innovation Studio

You can un-deploy or uninstall the tenant-specific applications only.

  1. Log in to BMC Helix Innovation Studio and navigate to the Workspace tab.
    221_Workspace.png
  2. Select the codeless application or library that you want to uninstall.
    The application details are displayed.
  3. Select Actions > Uninstall application.
    221_Uninstall IS app.png
  4. In the Warning dialog box, click Yes to proceed.BMC Helix Innovation Studio starts uninstalling the application. The status of the installation process is displayed in the Uninstall dialog box.
  5. After the process is completed, click Close. If the uninstallation fails, see Troubleshooting-codeless-application-deployment-issues.

The codeless application is uninstalled from BMC Helix Innovation Studio.


 

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