Purge Alarms at a Command Prompt

About this task

This topic describes how to purge alarms at a command prompt. You can also purge them using the Proficy Historian Alarm and Event Data Migration utility.

Before you begin

Ensure that you are a member of the ihsecurityAdmins security group.

Procedure

  1. Run the ihPurgeAlarms.exe file. By default, it is located at C:\Program Files\Proficy\ProficyHistorian\Server\ihPurgeAlarms.exe.
  2. Use the following parameters to purge alarms.
    Parameter Description
    -s <Historian server> The Historian server on which you want to access archive data. If you do not provide this parameter, the local machine is considered.
    -u <username> The username to connect to the archiver.
    -p <password> The password to connect to the archiver.
    -b "<file path>" The file path where you want to place the backup file of the purged alarms. If the path is not specified, the default backup path of the archive is considered.
    Note: You must enter the file path in double quotes (for example, "C:\\backup\\").
    -z 1 <file name> The name of the backup file in the .zip file format. For example, if you want to purge alarms older than 36 hours, but want to back up the data in a .zip file format, enter:
    ihPurgeAlarms.exe -h 36 -z 1
    If you run this command, the backup file will be created in the default archive backup folder.
    -d <number of Days prior to the current time> Indicates the time in days till the current date for which you want to purge alarms. For example, to purge alarms older than seven days, enter:
    -d 7
    -h <number of hours prior to the current time> Indicates the time in hours till the current time for which you want to purge alarms. For example, to purge alarms older than two and half days, enter:
    -d 2 -h 12
    -m <number of minutes prior to the current time> Indicates the time in minutes till the current time for which you want to purge alarms. For example, to purge alarms older than 3 hours 15 minutes, enter:
    -h 3 -m 15
    -sec <number of seconds prior to the current time> Indicates the time in seconds till the current time for which you want to purge alarms. For example, to purge alarms older than 30 seconds, enter:
    -sec 30
    The alarms are purged, and an audit log is created at ..\Proficy Historian Data\LogFilesfolder.