Premise Backing Up Premise and Importing Modules

Motorola Premise

video321

Active Member
Is the best way to backup Premise to just copy the entire SYS directory? If I have to do a complete restore can I just delete the SYS directory and copy the backup in or do I need to do a manual backup (.xdo) as well? Do I also need to export the plugins if I'm backing up the SYS directory?

Also, when you import a module - where do they go? I know that if I copy a module to the modules directory I can choose addins and see what's there. But, if I import a module why doesn't it get imported to the modules directory? Where is it?
 
There's a simpler way to create backups rather than make copies of the SYS directory.

Open Builder and select "File > Backup to Client ... " and supply a name. The resulting XDO file will contain everything needed to restore your Premise configuration. The file includes what you see in Premise Home, Modules, related images, and the current state of all properties. The file is in XML format and, if you're curious, it can be viewed using a web-browser or text-editor.

What's nice about it being in XML format is that the backup file is not a 'black-box' and can be viewed and, in the event of corrupted data, potentially corrected. If you load a corrupted XML file into a browser, like IE, it will halt at the offending line thereby giving you an idea of where to fix the problem. Its appearance seems a bit overwhelming at first but its really not too bad because it is structured data (XML) after all. The chances of needing to fix a backup file are slim to none.

The Premise Server Service also performs periodic backups. Look in \Premise\SYS\Backups and you'll find ten files (backup000.xdo to backup009.xdo). The server saves ten snapshots, from 000 to 009, and then starts all over again. If you restart the Premise Server Service, it'll attempt to load the most recent backupNNN.xdo file. If it fails, it falls back to an older backup.

Another useful thing to do is periodically export the entire Modules section. If you run into trouble during the installation of a Module you can restore the entire Module section to its previous state.

The "Modules" directory that you described is simply a parking lot for Module files (XDO's). It is a 'convenience folder' intended for storing custom Modules in one place. Whatever you park there will appear in the File > AddIns > Modules check-list; however, they are just files on your disk and not part of Premise just yet. Using the check-list, you select the Modules you wish to use, click OK, and then Premise imports them. The imported Module will appear in Builder's Modules view. Now they are part of Premise. To uninstall it, return to File > AddIns > Modules and deselect the Module in the list. This is the 'organized way' of installing/uninstalling a Module.

In practice, you are not obliged to park Module files in the Modules directory. Your Module files can reside wherever you please. To import them, simply select File > Import, navigate to the desired Module file, wherever it resides, and click OK. The Module file will be imported and will appear in Builder's Modules view. To uninstall a Module, just delete it manually from Builder's module. This is the 'expedient' way to install/uninstall Modules.

If you buy into 'organized way', you should resist the temptation to use the 'expedient' uninstall technique. If you delete the Module manually, that nice check-list, in File > AddIns > Modules, continues to show a check-mark next to the Module you just blew away. Now you have the extra step to uncheck it order to restore order to the world.

FWIW, I use the 'expedient' method.
 
While not pretty, I had a working configuration that I made a backup of. When I went to restore it I found that MiniBrowser didn't work at all and my changes to AutomationBrowser to allow 6-digit codes was reset to 4.

What about the Elk M1 .mdb file that the instructions say to copy to the modules directory? Is that just referenced during the initial importing of the module and not use from there on out? I have no idea if the file in the modules directory was being used before I blew away the configuration and later went to restore the backup since the .mdb file doesn't get restored there.

....oh and I found the master .xdo file - don't know how I missed that!
 
I guess the honeymoon is over and now its time to talk about some of Premise's odd habits. Backups and restores do work but Premise handles the backup of certain Modules in a peculiar way.Read this first to learn more about its strangeness.

A backup does contain everything in the Modules folder but when you restore it, Premise seems to install a stock version of the AutomationBrowser (that's why your 4/6 digit modification disappeared), MiniBrowser, Plugins and Themes modules. That's why I like to export the whole Modules section just to be safe.

I'll be honest and admit I've rarely ever needed to restore from a backup so the details of how I overcame Premise's quirkiness are a bit foggy. Seems to me that restarting the Premise Server Service immediately after restoring the backup was part of the solution but I'm not 100% certain that was all I did. I'll have to carry out a few experiments and get back to you.

The MDB file is an external reference file used by the ELK M1 module. It contains the words used by the M1's speech engine. The ELK M1 Module's instructions indicate to park the file there because that's where the module will come looking for it.

slsserver.xdo represents the 'live data' used by Premise. slsserver.xdo is what gets periodically copied to backupNNN.xdo.
 
Thanks, I had read that thread. But still, I have a new very basic configuration and made a .xdo backup of it. When I restored it, it didn't function correctly. I then tried to import the plugins module which I had backed up when importing the advanced security panel (the last of my changes) and that didn't help either. So I stopped the service and blew away the SYS folder, copied back a zipped up copy and everything worked perfectly.

I don't recall what didn't work correctly, but I can try it again later today.

Edit....Well, my issue was right here in my post! I tried to import the plugins module that was backed up before installing the enhanced security panel which was part of the bakup :blush:
I guess that's what happens when you are falling asleep on the couch working in a VM on your laptop and not the same machine you were using during the day when tackling this! I lost track of what was what when I dumped the files on my server to access from my laptop.
 
Back
Top