22/2/2017 HowtochangeadevicenameandassociatetheolddatawiththenewdevicenameinIONEnterprise5.0/5.5/5.6/6.0.

|FAQs|SchneiderElectricEstonia

Howtochangeadevicenameandassociatetheolddata
withthenewdevicenameinIONEnterprise
5.0/5.5/5.6/6.0.
GoalsandSymptoms
Background:TheIONEnterpriseManagementConsoleallowsausertoeasilychangethenameofadevice.Until
version6.0,theuserwasgivennoindicationoftheeffectthatthiswouldhaveonhistoricaldataaccessforthe
renameddevice.IfadeviceisrenamedwhiletheIONLogInserterserviceisrunning,theLogInserterwillcreatea
newsourceintheION_Datadatabase,andallhistoricaldatacollectedafterthedeviceisrenamedisassignedto
thisnewsourcename.Ifitisnecessarytorenameadevice,itisbesttoshutdowntheIONLogInserterfirst.
Thisarticledescribesthestepsrequiredtoproperlyrenameanexistingdevicethatisprovidinghistoricaldata.It
assumesthatthegoalistorenamethedevicesuchthatexistinghistoricaldatawillbeassignedtothisnewmeter
name.

CAUTION:Thisprocedurerequiresmanualchangestothedatabases.BackuptheION_DataandION_Network
databasesbeforeproceeding.

Keywords:device,meter,rename,changename
FactsandChanges
Thesimplestwaytorenameadevicesuchthatpreexistinghistoricaldataisassignedtothenewdevicenameisto:
1. ShutdowntheIONLogInserterservice,
2. RenamethedeviceintheManagementConsole,then
3. ExecuteaseriesSQLqueriestopropagatethisnamechangetospecificdatabasetables.

IftheLogInserterisleftrunningwhenthedeviceisrenamedintheManagementConsole,amorecomplicated
seriesofstepsisrequiredtoensurethatpreexistinghistoricaldataisassociatedwiththenewdevicename.This
articledescribesbothscenarios,andaddressesallversionsofIONEnterprise(5.0,5.5,5.6and6.0)
CausesandFixes
ItisveryimportantthatyouentertheSQLcommandsdescribedinthisarticlecorrectly.Pleasereadallofthe
instructionscarefullybeforeproceeding.Makesurethatyoubackupthedatabasesbeforebeginningthis
procedure.

WheninstructedtoexecuteSQLqueries,youcanuseeithertheSQLServerManagementConsole(preferred)orthe
IONDatabaseManagerSQLEditor.

Scenario1TheIONLogInserterserviceisshutdownbeforethedeviceisrenamed.
1. ShutdowntheIONLogInserterandIONQueryServerservices.
2. TakenoteoftheoriginaldevicenameasitappearsintheManagementConsole.Forthepurposesofthese
instructions,let'scallit'My.OldDeviceName'
3. StarttheManagementConsoleandchangethedevicename(inIONEnterprise6.0,youwillseeawarning
dialog.Whenaskedifyouwanttoproceed,chooseYes).Forthisexample,let'srenameitfrom
My.OldDeviceNametoMy.NewDeviceName.ChangingthedevicenameintheManagementConsolewillonly
changeitsnameintheDevicetableinION_Network.YouwillalsoneedtochangethenameintheSource
tableinION_Data,andintheIAS_Sourcetable(IONEnterprise5.5)orintheSRC_Sourcetable(ION
Enterprise5.6andgreater)

ION_DataDatabaseAllIONEnterpriseversionsUpdatedevicenameintheSourcetable:
UpdatethenameintheSourcetabletoreflectthenamechangebyexecutingthefollowingSQLquery

UPDATESourceSETname='My.NewDeviceName'whereID=(SELECTIDFROMSourceWHEREName=
'My.OldDeviceName')

ION_NetworkDatabaseIONEnterprise5.6andgreaterUpdatethedevicenameinSRC_Source
UpdatethenameintheSRC_SourcetableinION_NetworkbyrunningthefollowingSQLcommandagainstthe
ION_Networkdatabase:

UPDATESRC_SourceSETname='My.NewDeviceName'whereSourceID=(SELECTSourceIDFROM
SRC_SOURCEWHEREName='My.OldDeviceName')

ION_NetworkDatabaseIONEnterprise5.5onlyUpdatethedevicenameinIAS_Source
UpdatethenameintheIAS_SourcetableintheION_NetworkdatabasebyrunningthefollowingSQLcommand
againsttheION_Networkdatabase:
http://www.schneiderelectric.ee/sites/estonia/et/support/faq/faq_main.page?page=content&country=EE&lang=en&locale=en_US&id=FA212001&redirect=true 1/3
22/2/2017 HowtochangeadevicenameandassociatetheolddatawiththenewdevicenameinIONEnterprise5.0/5.5/5.6/6.0.|FAQs|SchneiderElectricEstonia

UPDATEIAS_SourceSETname='My.NewDeviceName'whereSourceID=(SELECTSourceIDFROM
SRC_SOURCEWHEREName='My.OldDeviceName')

IONEnterprise5.0onlynochangesarenecessaryintheION_Networkdatabase.

FinalSteps:
1. RestarttheIONLogInserterandQueryServerservices
2. UseVistatoverifythatthehistoricaldatafromthebeforethedevicerenamingiscontinuouswiththehistorical
datafromaftertherenaming.
3. YoumayhavetodosomeVistadiagrameditstoreflectthenamechange
4. IfyouareusingIONEnterpriseasadatacollectionsystemforIONEEM,seeRESL197993onwhatneedstobe
doneinIONEEMafterrenamingadeviceinIONEnterprise.

Scenario2ThedeviceisrenamedintheManagementConsolewhiletheIONLogInserterserviceisrunning

IfadeviceisrenamedintheManagementConsolewhiletheLogInserterisstillrunning,anewsourcewillbe
createdintheSourcetableintheION_Datadatabase.Historicaldatauploadedfromthisdevice,onceithasbeen
renamed,willbeassignedtothisnewsource.ItisnecessarytorunaseriesofSQLqueriestoconnectthepre
existingdataassignedtotheolddevicenametothenewdatathatwillbeassignedtothenewsourcename.To
proceed:
1. ShutdowntheIONLogInserterservice.
2. Forthisexample,assumethetheoriginaldevicenamewasMy.OldDeviceandthenewnameisMy.NewDevice

AllIONEnterpriseversions:

ION_Data
1.UpdatetheDataLogStamp/EventLog/WaveformLogtablestousethesourceIDcreatedforthenewdevicename
forthepreexistinghistoricaldata.RunthefollowingSQLqueriesagainsttheION_Datadatabase:

UPDATEDataLogStampSETSourceID=(SELECTIDFROMSourceWHEREName='My.NewDevice')WHERE
SourceID=(SELECTIDFROMSourceWHEREName='My.OldDevice')
////NOTE:ForSPM7.0uptobutnotincluding7.2.2,changeDataLogStamptoDataLog2forSPM7.2.2andnewer,
thisoperationisunnecessary////

UPDATEEventLogSETSourceID=(SELECTIDFROMSourceWHEREName='My.NewDevice')WHERE
SourceID=(SELECTIDFROMSourceWHEREName='My.OldDevice')

UPDATEWaveformLogSETSourceID=(SELECTIDFROMSourceWHEREName='My.NewDevice')WHERE
SourceID=(SELECTIDFROMSourceWHEREName='My.OldDevice')

2.Deletetheobsoletesource,i.e.My.OldDevicefromtheION_Datadatabasenowthatallofthehistoricaldatahas
beenassociatedwiththenewdevicenameseeRESL191111

IONEnterprise5.6andgreater:

ION_Network
1. Deletetheobsoletesource,i.e.My.OldDevicefromtheION_Networkdatabase.TheLogInserterwillhave
correctedalltherequiredentriesforthenewsourcenameseeRESL191111besuretofollowthesteps
correspondingtoyourversionofIONEnterprise.

FinalSteps:
1. RestarttheIONLogInserterservice.
2. CheckthecontinuityofyourdatausingVista.
3. UseWebReportertoverifythatonlythenewsourcenameappearsinthesourcelist.

Itisimportanttonotethatevenafterasuccessfuldevicerenamethatthetreefileforthedeviceisstillpresentwithin
theconfig/treesfolder.ThisdevicewillstillappearwithintheDiagnosticsviewerwithacomment"Devicedoesnot
existinthesystem".TheIONServiceswillneedtobestoppedandthetreefiledeletedormovedinordertoremoveit
fromtheDiagnosticsViewer.

BCPMSpecific:
AsingleBCPMdevicedefinedintheManagementConsolewillhaveasmanyas42channelsmappedasunique
sourcesinthedatabases,thustheprocedureforchangethenameofaBCPMdevicerequiresremappingmany
sources.Theattachedsqlscriptfileshouldmakethisprocesslesspainful,Thescriptwillneedtobeeditedtoreflect
yourspecificdevicesnames,botholdandnew.

http://www.schneiderelectric.ee/sites/estonia/et/support/faq/faq_main.page?page=content&country=EE&lang=en&locale=en_US&id=FA212001&redirect=true 2/3
22/2/2017 HowtochangeadevicenameandassociatetheolddatawiththenewdevicenameinIONEnterprise5.0/5.5/5.6/6.0.|FAQs|SchneiderElectricEstonia

DateCreated:November13,2007
LastRevised:July30,2010byJM
Public
OriginalAuthor:MN
Allcontent19922010SchneiderElectric
LegacyKBSystem(APS)Data:RESL189159V8.0,OriginallyauthoredbyKBAdPMon11/14/2007,LastEditedby
ChMuon11/15/2013
Relatedranges:IONEnterpriseV6.0,IONEnterpriseV5.6,IONEnterpriseV5.5,IONEnterpriseV5.0

FA212001|12Dec2016

http://www.schneiderelectric.ee/sites/estonia/et/support/faq/faq_main.page?page=content&country=EE&lang=en&locale=en_US&id=FA212001&redirect=true 3/3