soamunreg

Unregisters an application and deletes the application profile, preventing more sessions from being started for this application.

Synopsis

soamunreg application_name [-f] [-s] [-u user_name] [-x password]
soamunreg -h | -V

Description

Use soamunreg to unregister an application.

Unregistering an application does the following:

  • Terminates existing sessions and tasks (running and suspended)

  • Disables the application

  • Releases all resources allocated to the application

  • Removes the application profile from the system

After unregistering the application, remove the application files in $EGO_CONFDIR/../../profiles on Linux, %EGO_CONFDIR%\..\..\profiles on Windows.

You can optionally save historic data associated with the application

-h

Prints command usage to stdout and exits.

-V

Prints product version to stdout and exits.

Options

application_name

Specifies the name of the application. The application name is the same as it appears in the application profile. Enclose the application name in double quotes (" ") if it contains spaces. Precede the application name with two dashes (--) if it starts with a dash.

You can view the application name using soamview app.

-f

Forces the action, bypassing prompts to unregister an enabled application with running workload and to save the historical data. This option assumes you want to unregister the application immediately.

-s

Saves the application historical data.

-u user _name

Specifies the name of the user to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the user name specified here overrides the user name entered in soamlogon.

-x password

Specifies the user password to connect to Symphony for this command. If you are already logged on to Symphony using soamlogon, for this command only the password specified here overrides the password entered in soamlogon.

Unregister an application

Unregister an application, sampleApp:

soamunreg sampleApp
Related reference
soamreg