Scribd
Upload
263 views10 pages

Wonderware System Platform Cleanup Guide

This document provides guidance on cleaning up files in a Wonderware Galaxy system to improve performance. It recommends deleting temporary export files, backup directories, deployed application directories, and application copy directories when applications are undeployed. It also recommends clearing old entries from the change log table and shrinking the transaction log files in the Galaxy database. Running the Galaxy Database Scrubber utility can further clean unused packages and transaction logs.

Uploaded by

Ben Sahraoui
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
263 views10 pages

Wonderware System Platform Cleanup Guide

This document provides guidance on cleaning up files in a Wonderware Galaxy system to improve performance. It recommends deleting temporary export files, backup directories, deployed application directories, and application copy directories when applications are undeployed. It also recommends clearing old entries from the change log table and shrinking the transaction log files in the Galaxy database. Running the Galaxy Database Scrubber utility can further clean unused packages and transaction logs.

Uploaded by

Ben Sahraoui
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 10

Wonderware System Platform Clean-up Guide

Tech Note 930


Wonderware System Platform Clean-up Guide

All Tech Notes, Tech Alerts and KBCD documents and software are provided "as is" without warranty of any kind. See the Terms of Use for more information.

Topic#: 002746
Created: February 2013

Introduction
When working with a Galaxy, some of the Galaxy-related files can become quite large, impacting system performance. Investigation and
continued testing has confirmed that "cleaning up" certain file sets provides the following benefits:

Improves time to open templates and objects.

Improves time to check-in objects and templates.

Deploying the InTouch app is faster.

Restoring a Galaxy is faster.

Backup was faster and smaller.

You can delete the files listed in the following sections. Doing so can shrink the Galaxy size dramatically. Although some of the
directories can safely be deleted even while the Galaxy is deployed, it is strongly recommended that any deletions should be done when
all the display nodes of a Galaxy have been un-deployed, (i.e. during an upgrade). When all the display nodes of a Galaxy are un-
deployed, none of these directories should exist, so they can all be deleted.

Important: Always make backups before you delete anything!

Application Versions
Wonderware Application Server 3.1 and later

Assumptions
This Tech Note assumes you are familiar with the following:

Galaxy operations such as Deploy, Un-deploy, Object Export, Backup/Restore, etc.

SQL Server Database management operations.

Delete $$ExportTempFolders
file:///C|/inetpub/wwwroot/t002746/t002746.htm[2/27/2013 7:39:45 AM]
Wonderware System Platform Clean-up Guide

The $$$ExportTempFolders are created when you do an Object Export from the Galaxy. These files are normally automatically deleted
on completion. If the export fails or something goes wrong during the export, these directories are not deleted and remain there. All the
$$ExportTempFolders directories can be deleted.

FiGuRe 1: $$$EXPORtTeMPFOLDeRS

Delete BAK Directories


The BAK directories are created when you make a backup of an InTouch Application when opening the application from within the IDE
using WindowMaker. The default directory is in the application directory itself, so it permanently doubles the size of the application.

When a backup is required, specify an alternate directory and do not use the default. You can delete all the BAK directories.

file:///C|/inetpub/wwwroot/t002746/t002746.htm[2/27/2013 7:39:45 AM]


Wonderware System Platform Clean-up Guide

FiGuRe 2: BAK DiReCtORY CONteNtS

Delete Deployed Directories

Important! These files should only be deleted after all the display nodes of the Galaxy are un-deployed.

The Deployed directories are sometimes created when you deploys an InTouch application, but are not always deleted again when the
application is un-deployed. These files can build up over time.

Un-deploy all the display nodes, and then delete all the directories left over. Afterwards deploy all the InTouch Applications again.

file:///C|/inetpub/wwwroot/t002746/t002746.htm[2/27/2013 7:39:45 AM]


Wonderware System Platform Clean-up Guide

FiGuRe 3: DePLOYeD DiReCtORieS

Delete InTouch Application Directories

Important! These should only be deleted when all the display nodes of the Galaxy have been un-deployed.

For each deployed InTouch Application, a copy is created in this directory.

Various scenarios can result in these directories building up over time (Backing up and restoring the Galaxy, running Platform remove on
a node that hasn't been un-deployed, etc).

Un-deploy all the display nodes, and then delete all the directories that are left over. Afterwards deploy all the InTouch
Applications again.

file:///C|/inetpub/wwwroot/t002746/t002746.htm[2/27/2013 7:39:45 AM]


Wonderware System Platform Clean-up Guide

FiGuRe 4: INTOuCH APPLiCatiON DiReCtORY COPieS

Clear GOBJECT_CHANGE_LOG Table


The size of the table in the MSSQL Galaxy Database called dbo.GOBJECT_CHANGE_LOG can become very large over time when there
is a large amount of development. This table can be cleaned up by executing the following script on the database:

USE {Galaxy_Name – eg KH_G}


DELETE FROM gobject_change_log
WHERE change_date <= DATEADD(dd,-15,GetDate())

This query deletes all the entries in the change log more than 15 days old.

file:///C|/inetpub/wwwroot/t002746/t002746.htm[2/27/2013 7:39:45 AM]


Wonderware System Platform Clean-up Guide

FiGuRe 5: CLeaR tHe CHaNGe LOG

Shrink Transaction Log Files


You can shrink the Database Log Files. In SQL Server Management Studio, select the Database which corresponds to the Galaxy Name
(e.g. KH_G).

1. Right-click on the Database, then click Tasks.

2. Click Shrink, then Files (Figure 6 below).

file:///C|/inetpub/wwwroot/t002746/t002746.htm[2/27/2013 7:39:45 AM]


Wonderware System Platform Clean-up Guide

FiGuRe 6: SHRiNk DatabaSe LOG FiLeS

3. In the File type dropdown list, select Log, leave all other defaults and click OK:

file:///C|/inetpub/wwwroot/t002746/t002746.htm[2/27/2013 7:39:45 AM]


Wonderware System Platform Clean-up Guide

FiGuRe 7: SHRiNk LOG FiLe TYPe

In this example, the original allocated space was 1310.25 MB. After shrinking, it is reduced to 0.49 MB:

file:///C|/inetpub/wwwroot/t002746/t002746.htm[2/27/2013 7:39:45 AM]


Wonderware System Platform Clean-up Guide

FiGuRe 8: SHRiNk FiLe ALLOCateD SPaCe

Run Galaxy Database Scrubber on Database


The Wonderware Galaxy Database Scrubber utility should only be run on Galaxies that have been completely un-deployed and backed
up. This scrubber utility will delete all Unused Packages in the database and clean the Transaction Log files.

1. Double-click GalaxyDatabaseScrubber.exe to start the scrubber. Please take note of the warning pop-up:

file:///C|/inetpub/wwwroot/t002746/t002746.htm[2/27/2013 7:39:45 AM]


Wonderware System Platform Clean-up Guide

FiGuRe 9: GaLaXY SCRubbeR WaRNiNG MeSSaGe at StaRtuP

2. Select the Galaxy that needs to be scrubbed and click Connect.

3. Click the Scrub Database button and wait until it is finished.

Wonderware South Africa

Tech Notes are published occasionally by Wonderware Technical Support. Publisher: Invensys Systems, Inc., 26561 Rancho Parkway South, Lake Forest, CA 92630. There is also
technical information on our software products at Wonderware Technical Support.

For technical support questions, send an e-mail to [email protected].

Back to top

©2013 Invensys Systems, Inc. All rights reserved. No part of the material protected by this copyright may be reproduced or utilized in any form or by any means, electronic or
mechanical, including photocopying, recording, broadcasting, or by anyinformation storage and retrieval system, without permission in writing from Invensys Systems, Inc.
Terms of Use.

file:///C|/inetpub/wwwroot/t002746/t002746.htm[2/27/2013 7:39:45 AM]

You might also like