Managing deployed solutions by running solutionManager

The solutionManager script helps you to manage deployed solutions. You can revert to a previous solution version, list all of the currently deployed solutions, activate a specific version of a solution, set, and override solution properties.

About this task

Several versions of a solution can be deployed to Insight Server, but only one version is the active or current version that is receiving and emitting events. The current solution version includes all of the active agents and global aggregates. When you deploy a solution for the first time, it must be complete with all of its projects. All the bundles that are contained in the solution have the same version. Subsequent solution deployments might include an agent or an aggregate that has a different micro version. The solution manifest file, solution.mf, stores the version information, and references all the bundles in the solution.

Run the solutionManager commands from the <InstallDir>/runtime/ia/bin directory, or make sure that this directory is included in the system path. You must provide administrator credentials to run the setproperty command.

Tip: Many of the commands have optional parameters. The default value in some of the parameters uses cisDev as the name of the server. Be sure to specify the name of your development server or names of your runtime servers if you are not using the samples server.
  • Listing deployed solutions
    To display a list of all the solutions that are deployed, run the solutionManager list command. You can also determine whether a specific solution is deployed by running the solutionManager script with the isdeployed command.
  • Listing the current version of a solution
    Run the solutionManager getcurrentversion command to display the current version of a specific solution.
  • Reverting to the previous version of a solution
    You can revert the current version of a solution to the previous version by running the solutionManager revert command. This command sets the previous version as the active solution version.
  • Creating and overriding the properties of a solution
    You can add custom properties to a solution project by editing the solution_properties.xml file where you define a name and value for each property. If a property includes the override_required parameter, the value of the property must be modified by running the solutionManager setproperty command.
  • Modifying user authentication properties
    Run the solutionManager setproperty command to modify the value of user authentication properties, such as a user name or password, for a solution project. To determine the current value of a property, run the getproperty command.
  • Encoding the value of properties
    To protect the value of a property, such as a password, you can include the encoded value of the property in the solution_properties.xml file. Add the encoded="true" parameter to the property element to indicate that the property value is encoded.
Parent topic: Managing deployed solutions