Installing and Running the Queue

The Millennium Reporting Server installation will deliver all of the components that are necessary to run the Millennium reporting Queue as either a Windows Service or as an application.

Installing and Running the Queue as a Service

The following information describes the purpose and procedures for running a reporting Queue as a Windows Service. (As an alternative, the Queue can be run in the foreground as an application.)

Millennium Queue Service

Milqueue.exe is the Millennium Queue Service. This service ensures that the Millennium Queue (Queue.exe) is always available on the Reporting Server computer so that reports can run successfully. When the Queue operates as a service, the status will not display on the Windows task bar when a report is run.

Queue Administration Program

QueueAdmin.exe is the Queue Administration Program. This program is installed along with the reporting queue and is stored in the Queue directory, which is C:\QUEUE by default. The QueueAdmin.exe program installs and maintains the Millennium Queue Service.

For the Millennium Queue Service to run properly, the QueueAdmin program must use a user account to initialize the Millennium Queue Service. You can specify either a domain account or a local account based on the configuration and location of the Millennium Web Server (IIS), Database Server, and Reporting Servers. The Queue Admin program creates the user account as specified and verifies that the Millennium Queue Service is properly installed and running. The user account is created with only the privileges needed to run the Millennium Queue Service. Use this user account only for running the Millennium Queue Service.

Note: If you receive an error installing the Queue service, manually add the Queue User to the Reporting Server’s Local Administrators group, and try installing again.

To install the Millennium Queue Service:

1. Verify that your Reporting Server computer meets or exceeds the system requirements. The latest Millennium system requirements are available at:

   https://www.communitybrands.com/products/millennium.

2. Log on to the Reporting Server as an administrator who has Read and Write permissions to the JSI FundRaising Systems, Inc. registry key on the Reporting Server.

   If you are going to create accounts on more than one computer at the same time, then log on as a user with Domain Admin privileges.

3. In the queue directory (this is C:\QUEUE by default), run the QueueAdmin.exe executable as an administrator.
4. Click New User.
5. If you want to create a local account, leave the Compute Name radio button set.
6. If you want to create a domain account, select the Domain option, and enter the name of the domain.
7. Enter a User Name and Password.
8. If you want to create a local account, enter the IIS Server Name in the Additional Computer field. The intention here is create the Queue User on the Web Server (IIS) computer so that they have access to write reports to the Web Server (IIS) computer.
9. Click OK.
10. Verify the password by typing it again and clicking OK.
11. The program creates the users as necessary and reports success or failure via a message box. If the Local Account option is chosen, two message boxes will appear, confirming the creation of the Queue Account and the IIS Account. Click OK to close the message box.
12. Upon returning to the Millennium Queue Administrator dialog box, the User Name and Password fields will change, based on the New User that was created. Verify that the Install the Millennium Queue Service radio button is selected. Click OK to Install the Queue Service. A status bar above the OK button will display certain Status messages. After the service has been installed, a message box will appear stating the successful completion on the Queue Service Installation. Click OK, and the Millennium Queue Administrator program closed. The Queue Service starts, and the Queue is available for reporting.

The QueueAdmin.exe program creates the QueueAdmin.log file in the queue directory (which is C:\QUEUE by default).

The Milqueue.exe program creates the Milqueue.log file in the queue directory (which is C:\QUEUE by default) when it starts the queue service. If a log on failure occurs, it is recorded in this log file.

The following registry key on the Reporting Server contains settings for the Milqueue.exe program to use each time it starts:

• HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\JSI FundRaising Systems, Inc.\Queue Service

Running the Queue as an Application

If you run the Queue as an application, navigate to your X:\Queue folder on the Reporting Server and double-click on Queue.exe to start the application.