CLI Reference > Server Administration Commands > im installsolution
im installsolution
installs a solution template
im installsolution [--[no]confirmPartial] [--conflictPrefix=value] [--[no]createData] [--groupMap=value] [--prefix=value] [--siProjectDir=value] [--solutionFile=value] [--userMap=value] [--user=name] [--hostname=server] [--password=password] [--port=number] [(-?|--usage)] [(-F file|--selectionFile=file)] [(-N|--no)] [(-Y|--yes)] [--[no]batch] [--quiet] [--cwd=directory] [--forceConfirm=[yes|no]] [-g|--gui] [--settingsUI=[gui|default]] [--status=[none|gui|default]]
im installsolution runs the installer that sets up a solution. For example:
im installsolution --createAdmins --prefix=RM_ --solutionFile=C:/MKS/rm2007.imt --groupMap=Administrators=everyone,Analysts=everyone,Integrations=everyone,Manager=everyone,Testers=everyone --userMap=administrator=guest,analyst=guest,developer=guest,integration=guest,manager=guest,tester=guest --siProjectDir=C:/RM_repo7
To successfully install a solution, you must specify the hidden option --createAdmins. If you do not specify this option, the installation fails and does not display an error message.
This command takes the universal options available to all im commands, as well as some general options. See the options reference page for descriptions.
specifies whether to be prompted to confirm the partial installation of the solution template when no prefix is specified.
specifies a conflict prefix to prepend to projects, states, fields, types, triggers, and other object names that may conflict with existing object names. This is most likely to occur if you are installing the solution without a prefix. Specifying a conflict prefix is optional.
specifies whether to create sample data when installing the solution. Sample data populates certain pre-defined configuration management projects. The sample data can be helpful if you intend to use the installation for evaluation and training; however, if you plan to use this installation for production work, PTC recommends that you clear the option and install without the sample data. Sample data is not easily deleted after installation.
specifies the mapping of the solution to local groups on the system in the format solutionGroup=localGroup[,...].
specifies the prefix to apply to projects, states, fields, types, triggers, and other objects set up by the installer. To distinguish the new objects from your existing ones, a prefix is applied to the newly created objects. For example, if you accept the default prefix of RM_, then states such as Reject and Defer are named instead RM_Reject and RM_Defer. If your current database is not already configured, then you may also choose to set a blank prefix; however, if you set a blank prefix, subsequent templates will require a prefix upon installation.
specifies the name of the target directory where the installer places sample data on the configuration management system.
specifies the name of the .imt file containing the solution. For example, for MKS Requirements the file name is rm_2007.imt.
specifies the mapping of the solution to the local user on the system in the form solutionUser=localUser[,...].
See Also
Miscellaneous: options