Working with Services

Service Installation

To add a new service for installation, you can use the "New Service" option. This can be accessed through the toolbar button, context menu item, or by pressing the Insert key while the "Install and Control" panel is focused. A file picker dialog will appear, allowing you to select the file that contains the service.

When configuring a service in Advanced Installer, you can fine-tune its behavior and characteristics using a range of properties. Here are the key properties you can set:

• Service Name: This property specifies the service's unique identifier within the Windows API functions.
• Display Name: The display name is the friendly name that users will see. It can be translated into multiple languages.
• Description: You can provide a detailed description of the service in the description field. It, like the display name, can be localized.
• Service File: This property specifies the service's source file. You can navigate through your project files and choose the appropriate file.
• Service Type: You can run a Win32 service in its own process or a Win32 service that shares a process.
• Allow the service to interact with the desktop: This option specifies whether the service may interact with the user by displaying a user interface. It should be noted that this option is not recommended for services installed on Windows Vista or later.
• Start Type: You can configure the service to start automatically when the operating system boots, start on demand when the user initiates it, or disable it entirely.
• Error Control: This property defines the system's behavior when the service fails to start.
• The service is vital for installation: If this option is selected, the package installation will be aborted if the service fails to install.
• Load Order Group: If the service belongs to a specific group, you can specify the group's name. Otherwise, leave this field empty.
• Dependencies: In this field, you can specify any active applications or services that need to be running before this service starts. Use [~] as a separator for multiple dependencies.
• Arguments: This property allows you to pass command line arguments to the service when it starts.
• Account: You can specify the user account under which the service will run. If left empty, the service will run under the LocalSystem account. Use the specified format (<Domain_Name><User_name>) for user accounts, and use a dot (.) as the domain name for local user accounts.

Services which interact with the desktop can use only the LocalSystem account.

• Password: If applicable, you can provide the password for the service user account. Note that the LocalSystem account does not require a password.
• Set "Log on as a service" policy: Enabling this option sets the "Log on as a service" policy for the specified user account.

If you want to install a service for a specific user, you must take specific steps. These steps are detailed in the How-To Install a Service for a Custom User.

Control and Configure Operations

Service control operations allow you to have full control over the behavior of services after they are installed using Advanced Installer. With these operations, you can start, stop, or delete services based on your installation package's requirements.

Advanced Installer's service control operation section includes the following properties:

• Service Name: This field contains the name of the service you wish to manage. You can either select a service from the combo box or type the name of a service that is already installed on the target machine. The service name and installer properties can both be localized.
• Attached Component: You can specify the component that will house the control operation here. This enables you to link the operation to a specific component in your package. Simply select the desired component from the drop-down list box that contains all of the components in your package.

After the service is installed, you have three available options:

• Start: The service will be started automatically.
• Stop: The service will be stopped.
• Delete: The service will be removed.

If all three options are selected, the existing service will be stopped and removed, and the service in the package will be installed and started.

During the uninstallation of your package, you can specify the behavior for the service:

• Start: The service will be started.
• Stop: The service will be stopped.
• Delete: The service will be removed.

For uninstallation, you can only start a service that will still be present on the target machine after the uninstallation is complete.

In the service parameters section, you can provide a list of arguments separated by [~] that will be executed when the service starts. These arguments can be localized, and the field accepts formatted types, allowing you to perform advanced editing with installer properties and smart edit control.

Enabling the “Wait until the Service Completes“ option instructs the installer to wait for a maximum of 30 seconds for the service to complete before proceeding. This is useful when critical events must be completed before proceeding with the installation. If this option is disabled, the installer will not proceed until the Service Control Manager (SCM) reports that the service is in a pending state.

Several attributes for Merge Module projects can be made configurable at merge time. These are the name, the events, the argument, and the wait. This adaptability enables you to tailor the behavior of service control operations during the merge process.

Also, service configure operations in Advanced Installer allow you to modify the settings of services that are already installed or being installed by your current package. With these operations, you can make changes to service configurations to ensure they meet your application's specific requirements.

The service configure operation section in Advanced Installer provides the following properties:

• Service Name: This field contains the service name that you want to configure. You can either select a service from the combo box or type the name of a service that is already installed on the target machine. The service name and installer properties can both be localized.
• Attached Component: You can specify which component will contain the configure operation here. You have fine-grained control over when and how the configuration changes are applied by associating the operation with a specific component within your package. Simply select the desired component from the drop-down list box that contains all of the components in your package.

The "Configure On" property determines when the service configuration changes should be applied. You can select one or more options from the following:

• Install: Configure the service during the installation of the component.
• Uninstall: Configure the service during the uninstallation of the component.
• Reinstall: Configure the service during the reinstallation of the component.

By combining these options, you can precisely control when the service configuration changes are applied.

In the “Setting To Change” section, you can specify the changes to be made to the service configuration. You can dynamically configure the service by setting specific values or using installer properties. You can easily select a property to assign the desired value by clicking the "Property..." button..

"Time delay of an auto-start service" is applied only on auto-start services or services installed by the package configured with Automatic Start Type from the "Parameters" field in the Service Properties page.

Failure Operations

Failure actions are an essential aspect of managing services, ensuring that they respond appropriately in case of failures. Advanced Installer provides a comprehensive set of tools to configure failure actions for services, whether they are already installed or being installed by your current package. The "New Service Failure Operation" option allows you to define failure actions for services. This feature enables you to specify actions to be taken when a service fails to start or encounters errors. You can define custom actions, such as restarting the service or sending error notifications, to ensure smooth operation and prompt error handling.

Advanced Installer's service failure operation section includes the following properties:

• Service Name: This field contains the name of the service for which the failure actions are to be configured. You can either choose a service from the combo box or manually enter the name of a service that is already installed on the target machine. The service name and installer properties can both be localized.
• Attached Component: You can specify which component will contain the failure operation here. You have fine-grained control over when the failure actions are applied by associating the operation with a specific component within your package. Simply select the desired component from the drop-down list box that contains all of the components in your package.

The "Configure On" property determines when the service failure actions should be configured. You can select one or more options from the following:

• Install: Configure the failure actions during the installation of the component.
• Uninstall: Configure the failure actions during the uninstallation of the component.
• Reinstall: Configure the failure actions during the reinstallation of the component.

By combining these options, you can precisely control when the failure actions are applied.

In the “Failure Actions” section, you can specify the actions to be taken if the service fails. The following properties are available:

- Reset failure count after: The Service Control Manager (SCM) keeps track of how many times each service has failed since the system began. When the specified number of times the service fails, the system executes the action with the corresponding index in the "Failure Actions" list. You can specify a time (in minutes) when the failure count should be reset.

You can specify a message to be sent to network users before restarting the computer in response to a "Restart the computer" action specified in the "Failure Actions" list in the "Reboot Message" section. You have the option of sending a reboot message or deleting the current message and sending no message.

You can specify a program to run in response to a "Run a program" action specified in the "Failure Actions" list in the "Run Program" section. When the service fails, you can use a formatted string to delete the current command and run no program. You can leave this field blank to continue using the current run program.

Any changes made to the failure actions will take effect the next time the system is started.