Rename tags using the tag rename utility

Important: After connecting to the database, the Tag Rename Utility will check for the Runtime database version and will proceed only if you are using version 11.5 or higher.

To rename tags:

1. Open the Tag Rename Utility.

2. Provide authentication information in either of these ways:

   • Use Windows authentication. With this method, you are not required to provide a username and password. You will be connected with the credentials that you have already used to log onto the computer.

   • Use SQL Server authentication. With this method, you must provide the username and password for the SQL Server.

     

     Important: SQL Server authentication is provided for backward compatibility only. For improved security, we recommend that you use Windows authentication.
     
     Note: For either authentication method to work, you must have administrator privileges on the SQL Server Runtime database.

3. Click Connect to connect to the Historian Runtime database.

4. Click Add Tag to specify the tag you want to rename.

   

5. In Old Tag Name, type the current tag name.

   

6. In New Tag Name, type a new name for the tag. The tag names may contain letters, numbers, and the special characters "_" and "$", but no spaces. Click OK.

7. Repeat steps 4 through 6 for each tag you want to rename.

8. Click Rename Tags. A screen like this displays your tags:

   

   You may see both red and green outcomes as a result of renaming the tags.

   • Green indicates that the Tag Rename Utility has successfully renamed the tag in the Runtime database.

   • Red indicates that the rename was not successful. This typically happens because the connection failed, the old tag did not exist, or the new tag name was a duplicate. The Details column shows the reasons for any failure.

     Note: You can also rename several tags at a time by clicking Add CSV, and then specifying a .CSV file that contains an old tag name and a new tag name consecutively in each row.

9. After using the Tag Rename Utility, enable and start the Historian.

   For more information, see Starting and Stopping AVEVA Historian.

   Your tags will be updated to the new tag name and contain the history associated with the old tag.

10. If applicable, open the System Platform IDE and deploy the Galaxies.

    For more information, see the Application Server documentation.