Chat now with support
Chat with Support

MessageStats 7.8.1 - Upgrade Guide

Upgrading MessageStats Overview

•
MessageStats upgrade paths
•
About task migration
•
How the task migration tool works

MessageStats upgrade paths

MessageStats 7.8.1 supports an in-place upgrade from 7.4 or later. If you have an earlier version (6.5.1 to 7.3) of MessageStats, you must first upgrade to 7.4.1 and then upgrade 7.4.1 to 7.8.1.

After you have upgraded to 7.4.1, you can perform an in-place upgrade to MessageStats 7.8.1.

About task migration

About task migration

When upgrading MessageStats, you are prompted to initiate task migration.

Depending on how your MessageStats Scheduler Service is configured and on the number of existing tasks that you have to migrate, task migration can take several hours. If you choose to cancel task migration during the installation process, you can run it separately at a later time.

You cannot use the upgraded MessageStats release until the existing tasks have been migrated.

To run the task migration tool separately
•
On a computer on which the MessageStats console is installed, navigate to
C:\Program Files (x86)\Quest\MessageStats and run the MigrateTasks.exe tool.
The task migration progress is displayed while the task files are being migrated.
How the task migration tool works

When you run the MigrateTasks.exe tool, it performs the following tasks:

1
Connects to the Quest MessageStats Scheduler Service to determine the database location.
2
Verifies that no tasks are currently running.
If the scheduler service is running tasks, the tool waits for one minute and tries again. If the scheduler service is running tasks continually for 60 minutes, the task migration tool fails to run.
3
Stops and disables the MessageStats Scheduler Service.
4
Connects to task storage and task instance storage.
5
Migrates the tasks and the task instances to the database.
6
Archives the tasks and task instances in a compressed file named as follows:
tasksarchiveYYYYMMDDHHMMSS.zip
By default, the file is located in the following path C:/Program Files (x86)/Quest/MessageStats/tasks.
7
Deletes the processed task instance files from the MessageStats tasks folder.
8
Enables and restarts the MessageStats Scheduler Service.
Troubleshooting task migration

The following error conditions might be reported during task migration:

 
Table 1. Troubleshooting the task migration tool.

Error Message

What It Means

Problem migrating task

Problem migrating task instance

Problem updating occurrence status of task instance

These errors can appear if you deleted any task files in the MessageStats tasks folder. The task migration continues but the status of occurrences related to the missing task documents will be inaccurate.

Problem migrating property X of task

Problem migrating property x of task instance

Problem updating status of task instance

Problem updating progress of task instance

These errors can appear if there are errors in the task documents, or if there were errors during database installation. Task migration is not performed for the problematic information, but will otherwise continue.

If task migration is stopped unexpectedly, the Quest MessageStats Scheduler Service might be left in a disabled state. In this situation, you must enable the scheduler service before you can restart task migration.

Typical MessageStats Upgrade Scenarios

•
About SQL Security Permissions for Upgrading the Database
•
Upgrading a Complete (Single Server) MessageStats Installation
•
Upgrading a Distributed Installation with a Separate Database Server
•
1a. Upgrading the MessageStats Database on a Separate Server
•
1b. Manually Upgrading the MessageStats Database on a Separate Server
•
2. Upgrading the MessageStats Reports and the MessageStats Server
Self Service Tools
Knowledge Base
Notifications & Alerts
Product Support
Software Downloads
Technical Documentation
User Forums
Video Tutorials
RSS Feed
Contact Us
Licensing Assistance
Technical Support
View All

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating