- WINDOWS VISTA - Zionworx V2.6 Readme File

[webmaster]

-----------------------------------------------------------
ZionWorx 2.6 Readme File
-----------------------------------------------------------

Known Issue: Single Monitor with Windows Vista
--------------------------------------------
When running ZionWorx on a Windows Vista computer with a single monitor, presumably for testing purposes, there is an issue when opening service lists and PowerPoint presentations. The Open File Dialog causes the presentation screen to jump in front of the main ZionWorx application window. Popup hints have been disabled when running in Vista as well as they caused the same issue, albeit this was more confusing from a user point of view. The hint text still shows in the status bar at the bottom of the main application form.

This is an existing integration problem between the programming language used for ZionWorx and a Vista setting that we are unable to resolve. As it does not interfere with normal two monitor usage this shouldn't be a problem for standard usage.



UPGRADING ZIONWORX
-----------------------------------------------------------

Windows Vista: Importing Songs from Version 2.5
-----------------------------------------------
ZionWorx 2.5 by default stored the song database under the installation directory which typically would be the default windows location "C:\Program Files\". When songs were added or edited this is the database that is updated. However Vista enforces better security by not allowing programs to make changes in the Program Files directory. Rather it implements what is called 'Virtualization' that makes it look like the files are updated however they are physically in a different location on the computer.

Because of this when you upgrade ZionWorx on Windows Vista where the program is installed in the default windows location you may not see any songs in the database or just the initial list of public domain songs. This is because the installation program is unable to access the users virtual store to copy them to the new location. You will need to manually import the songs from the data in the VirtualStore

To import songs follow the following steps. Note that you will have to change the folder settings in Windows Vista to allow hidden files and folders to be viewed.
1) Open ZionWorx application
2) Unlock database if not already unlocked
3) Go to the Database->Import... menu
4) Select the database folder within the users 'VirtualStore'. Typically this is "C:\Users\<User Name>\AppData\Local\VirtualStore\Program Files\ZionWorx\Data"
5) Choose the songs to import and press the Import button

Alternatively if you are confident enough with Windows you can manually copy the contents of the Data directory within the VirtualStore folder to the new data location under the Windows User Data. By default this is "C:\ProgramData\ZionWorx\2.6\Data"


Configuration Files
-------------------
Because of Windows Vista security not allowing files to be updated in the C:\Program Files\ directory the ZionWorx configuration files have been moved to the more appropriate Windows User Data location. By default this is "C:\Documents and Settings\All Users\Application Data\ZionWorx\2.6\" on Windows XP and earlier versions and in "C:\ProgramData\ZionWorx\2.6\" on Windows Vista.

Because of the upgrade these files have also been renamed to have a prefix 'ZW' on the front as well. When ZionWorx is started for the first time it will check if previous configuration files exist (because of Virtualization) and updates the new configuration files with any settings that have been modified since installation.
This may cause problems if you have more than one user on the computer who open ZionWorx as subsequent users running ZionWorx run the risk of overwriting previously updated configuration files.

To avoid this once the configuration files have been updated - delete any copies of the configuration files within the individual user's VirtualStore directories

[peter60]

Because I have multiple users and was aware of the "Virtual Store" issue, I placed the database into a public folder. Does that mean that I can upgrade from 2.5 to 2.6 seamlessly?

[ChrisClark]

The upgrade installer looks at the location of the ZionWorx.exe file to determine whether to create a new directory for ZW under "Windows User Data". So if the application was installed in 'Program Files' then the new directory will be created and any database, backgrounds and settings files in the default directory moved. If the application was installed elsewhere from 'Program Files' the installation should be seamless.

When the actual application starts it does try checking to see if old configuration files exist and then updates the new configuration files (at least the main settings file) from them. I am unsure with ZW now not requiring 'virtualization' whether it will still pick up the old config files in the virtual directories. It would probably pay to make a copy of them anyway before upgrading. You may end up needing to copy the contents of the old 'Settings.ini', 'Margins.ini', 'Styles.ini' to the newly named 'ZWSettings.ini', 'ZWMargins.ini', 'ZWStyles.ini' files.

If you have the database in a different location from the default installation then ZionWorx should pick up the database correctly. Check the ZWSettings.ini file has the correct database path (though this will also show on the Preferences form)

As with all upgrades it is recommended to take a backup of all the ZionWorx files - database, backgrounds, configuration files before upgrading the application.

[brainier]

I have a script that migrates settings from the current users virtualization folder to the new folder. Works under Vista only (not needed of course if you upgrade 2.5 to 2.6 on XP). To use this script download the compressed file and extract migrate.vbs from the zip and double-click the migrate.vbs file. This script will copy the virtualised Data folder to the actual Data folder and copy and rename the settings, styles and margins files (if they do not exist already). So this script will not migrate settings files if Zionworx 2.6 has been run already, but will always copy the database.

migrate.zip

Unzip to use

(1.14 KiB) Downloaded 899 times