LATEST VERSION: 9.1.1 - CHANGELOG
Pivotal GemFire® v9.1

pdx rename

Renames PDX types in an offline disk store.

Any PDX types that are renamed will be listed in the output. If no renames are done or the disk-store is online, then this command will fail.

Availability: Offline.

Syntax:

pdx rename --old=value --new=value --disk-store=value --disk-dirs=value(,value)*
Name Description
--old Required. If a PDX type’s fully qualified class name has a word that matches this text then it will be renamed. Words are delimited by ’.’ and ’$’.
--new Required. The text to replace the word that matched old.
‑‑disk‑store Required. Name of the disk store to operate on.
--disk-dirs Required. Directories which contain the disk store files.

Example Commands:

Change all packages that start with “com.gemstone” to “com.pivotal”:

gfsh>pdx rename --old=com.gemstone --new=com.pivotal --disk-store=ds1 --disk-dirs=/diskDir1

Change a class named “MyClassName” to “YourClassName”:

gfsh>pdx rename --old=MyClassName --new=YourClassName --disk-store=ds1 --disk-dirs=/diskDir1

Change the FQCN “com.target.app1.OldClass” to “com.target.app2.NewClass”:

gfsh>pdx rename --old=com.target.app1.OldClass --new=com.target.app2.NewClass --disk-store=ds1 --disk-dirs=/diskDir1

Sample Output:

gfsh>pdx rename --old=PortfolioPdx --new=StockPdx --disk-store=DiskStore1 --disk-dirs=/DiskDir1
Successfully renamed pdx types:
  com.app.data.StockPdx: id=2
  com.app.data.StockPdx$Day.Monday

Error Messages:

If no types match, you may receive the following error message:

gfsh>pdx rename --old=gemstone --new=pivotal --disk-store=DiskStore1 --disk-dirs=/DiskDir1
Could not process command due to GemFire error. No Pdx types found to rename.

If the disk-store where the PDX types are stored is online, you will receive the following error message:

gfsh>pdx rename --old=StockPdx --new=PortfolioPdx --disk-store=DiskStore1 --disk-dirs=/DiskDir1
Could not process command due to GemFire error. Error renaming pdx types :
GemFireCache[id = 484629896; isClosing = false; isShutDownAll = false;
closingGatewayHubsByShutdownAll = false; created = Wed Jan 07 10:29:45 PST 2015;
server = false; copyOnRead = false; lockLease = 120; lockTimeout = 60]: An open cache
already exists.