How to: Add an Application to a Deployed Instance of Notification Services (Command Prompt)

  • Article

To add an application to an existing instance, you must modify the instance configuration and then update the instance. The following procedure shows what to modify and how to then perform the update by using command-line utilities.

Note

The following procedure assumes you are configuring the instance of Notification Services by using an instance configuration file (ICF) and application definition files (ADFs). If you are using Notification Services Management Objects (NMO), use methods of the Microsoft.SqlServer.Management.Nmo.Instance class to update the instance of Notification Services.

To add an application to a deployed instance of Notification Services

  1. Create or obtain the ADF for the new application.

  2. In the ICF, do the following:

    • Add an Application node for the application.
    • Add any custom protocols used by the application to the Protocols node and any additional delivery channels to the DeliveryChannels node.
    • Modify the ParameterDefaults node as necessary.

  3. Back up the instance and application databases. For more information, see Backing Up and Recovering Notification Services.

  4. On the Start menu, point to All Programs\Microsoft SQL Server 2005\Configuration Tools, and then click Notification Services Command Prompt to open a command prompt window.

  5. Type the following command to disable the instance:

    nscontrol disable -nameinstanceName

  6. Type the following command to apply the changes made in the configuration file:

    nscontrol update -inconfigurationFile

    If the instance or application requires command-line parameters, your nscontrol update command will contain additional arguments. For more information, see nscontrol update Command.

  7. To update performance counters, reregister the instance of Notification Services using only the -name and -server arguments. If you do not use the performance counters or do not need them to be updated, do not perform this step. Type the following commands to reregister the instance.

    1. **net stop ns$**instanceName

    2. nscontrol register -nameinstanceName-serverdatabaseServer
      When using Microsoft SQL Server Authentication or argument encryption, you will need to supply additional parameters. For more information, see nscontrol register Command.

    3. **net start ns$**instanceName

      Note

      If the instance of Notification Services is scaled-out across multiple servers, reregister the instance on each server.

  8. Type the following command to enable the instance:

    nscontrol enable -nameinstanceName

See Also

Tasks

How to: Add an Application to a Deployed Instance of Notification Services (SQL Server Management Studio)

Concepts

Adding an Application to an Instance

Other Resources

Managing Instances and Applications How-to Topics (Notification Services)

Help and Information

Getting SQL Server 2005 Assistance