User Guide  for  Hauptwerk
About Hauptwerk
Welcome
What is it?
What is it used for?
Licensing
Installation
Prerequisites
Background
Installing
Upgrading
Backups
Quick start
Stand-alone
MIDI sequencing
VSTi plug-in
Background
Tour of a pipe organ
Using Hauptwerk
The virtual console
Settings screens
Menus
The File menu
Loading sample sets
Combination files
The registration sequencer
Temperaments
Audio routing and multi-channel audio
Activation and reset
Capture mode
Recording audio
Master tuning
The transposer
MIDI input
MIDI output
Re-directable inputs
Component installer
Importing v1 organs
MIDI organ consoles
MIDI sequencing
Organ design tools
Performance tuning
General options
Sample set options
Voicing
Reference
MIDI implementation
Troubleshooting
Creating sample sets

Upgrading or re-installing Hauptwerk


These instructions apply if you already have Hauptwerk version 2 or above installed on a computer. If not, please instead see the installation section. You can check the version currently installed by selecting Hauptwerk | About Hauptwerk if you have an Apple Mac or Help | About Hauptwerk if you have a Windows PC from the Hauptwerk menu.

Note that you do not need to re-install Hauptwerk if you have previously installed an evaluation copy of this version of Hauptwerk and then subsequently buy a licence for Hauptwerk; simply connect the USB dongle to the computer whilst Hauptwerk is not running.

It is only possible to have one copy of Hauptwerk installed on a given computer. If the installer detects that Hauptwerk is already installed, it will only allow that copy to be upgraded or re-installed.

No settings or installed components (sample sets, temperaments, licences, etc.) will be lost by upgrading or re-installing. However, it is good practice to make a backup of your HauptwerkUserData folder, which contains all of your settings, before any upgrade. We recommend writing a copy of the folder to DVD/CD as a backup and keeping that backup safely. Please be very careful not to move any of Hauptwerk's folders, otherwise your Hauptwerk installation will be broken.

Please note that it might take longer to load each organ the first time (only) after some upgrades, since the sample set data caches need to be regenerated for some new versions (not all).

Important: If your licence is for version 2 and you do not update your licence for the current version before installing, Hauptwerk will revert to running in evaluation mode but allow you to apply the licence upgrade at any time to restore full licensed functionality. A computer can only have one version of Hauptwerk installed on it at any one time (unless you have multiple operating system disk partitions). Once a new version has been installed it is not possible to revert to a previous version without un-installing Hauptwerk completely (selecting the option to remove all files) then re-installing the older version, which would wipe any existing settings. Hence there is no easy way to revert to a licensed installation once version 3 has been installed other than by purchasing a licence upgrade.


Upgrade/re-installation steps on an Apple Mac computer

Step 1. Please make sure that all current OS X updates are applied. (There were some serious OS X bugs that affected Hauptwerk or its installer, which are fixed by making sure that the latest OS X updates are applied.)

Step 2. Please make sure that the latest drivers are installed for your audio/MIDI interface(s). Check their manufacturers' websites for the latest versions.

Step 3. If your existing licence is for version 2, for simplicity we recommend that you purchase the necessary licence upgrade and apply the resulting update to your USB licence key dongle before upgrading Hauptwerk itself. You will be sent the necessary instructions to update the dongle once the licence upgrade has been ordered. However, if your licence is for version 2 and you do not update your licence for the current version before installing, Hauptwerk will simply revert to running in evaluation mode but allow you to apply the licence upgrade at any time to restore full licensed functionality.

Step 4. If you are installing Hauptwerk from a CD, insert the CD and then use Finder to navigate to the Install folder on the CD. If instead you downloaded Hauptwerk, navigate to your downloaded file (by default, it will have been placed on your desktop).

Step 5. In Finder, double-click on the Hauptwerk installation .dmg (disk image) file. Please do not skip the (important) verification stage. If any checksum or other errors are reported, and you had downloaded Hauptwerk, please try downloading it again. If any errors are reported and you are installing from CD, please check the CD for dirt or scratches, and contact your Hauptwerk vendor for a replacement if necessary.

Step 6. Double-click on the InstallHauptwerk icon that appears in the disk image's window, launching Hauptwerk's installer. A screen will appear stating that you need an administrator password to install the software. Click on the lock icon and enter the administrator password for your computer (if you have only one account on the computer, you should just enter your computer password). Follow the instructions in the installer to complete the installation process.

Important: Please don't cancel the installer after you have clicked Install on the its final summary screen, otherwise a partial, broken installation may result. Please also ensure that you don't re-launch the installer for at least one minute after it has finished, since running two instances of the installer may also result in a corrupted installation. (The installer might keep running in the background for a few moments after it appears to have closed.)

Step 7. If you are using Mac OS X 10.4 ('Tiger'), please now reboot the computer (otherwise the Hauptwerk icons on your desktop might not work properly for the next step). This is not necessary on OS X 10.5 ('Leopard').

Step 8. Launch Hauptwerk by clicking on the relevant icon on your desktop. Please now make a backup of your Hauptwerk settings and data following the step-by-step 'How to make a backup' instructions in the backups section of the guide. Doing so should allow you to get your current settings back in case your computer ever needs to be re-installed in the future.

The current version of Hauptwerk is now ready to use.


Upgrade/re-installation steps on a Windows PC

Important note: Please do not use Windows System Restore after installing Hauptwerk, since it often deletes or reverts some of Hauptwerk's files and not others, and can leave Hauptwerk in an unusable condition, whilst also preventing Hauptwerk's installer from being able to run to repair the installation.

Step 1. Please make sure that all current Windows updates and service packs are applied.

Step 2. Please make sure that the latest drivers are installed for your audio/MIDI interface(s). Check their manufacturers' websites for the latest versions.

Step 3. If your existing licence is for version 2, for simplicity we recommend that you purchase the necessary licence upgrade and apply the resulting update to your USB licence key dongle before upgrading Hauptwerk itself. You will be sent the necessary instructions to update the dongle once the licence upgrade has been ordered. However, if your licence is for version 2 and you do not update your licence for the current version before installing, Hauptwerk will simply revert to running in evaluation mode but allow you to apply the licence upgrade at any time to restore full licensed functionality.

Step 4. Make sure that you are logged onto Windows with a computer account that has administrator privileges (such as the default computer account). If not, log out and log on again using such an account.

Step 5. Important: If you had previously disabled the Windows page file (which was recommended for Hauptwerk 2 and earlier versions) or had adjusted Windows virtual memory settings in any other way, please make sure the page file is re-enabled and set specifically back to its default of 'system managed size'. Having it disabled or set to an inappropriate size can cause stability problems, performance problems, or other severe problems with Hauptwerk, other applications, or Windows itself, especially if 4 GB or more of memory is installed. On Windows XP use Start | Settings | Control Panel | System, then click on the Performance | Settings button on the Advanced tab. Select Adjust for best performance, then click the Advanced tab. Leave Processor scheduling and Memory usage both set to favour Programs. Click Virtual memory: Change and select System managed size for the hard-disk you want Windows to use for its virtual memory, then click Set. Finally click OK on all of the windows and re-boot the computer if you changed any settings.

Step 6. If you are installing Hauptwerk from a CD, insert the CD and then use Windows Explorer to navigate to the Install folder on the CD. Please note that, depending on the speed of your CD/DVD drive, it may take several minutes for the installer to open after double-clicking on it (in the next step), or for the installer file to appear in Windows Explorer, due to its size. During this time the drive activity light will remain lit. Please don't double-click on the installer multiple times in the meantime, since running two instances of the installer simultaneously can lead to a corrupted installation. If instead you downloaded Hauptwerk, navigate to your downloaded file.

Step 7. In Windows Explorer, double-click on the Hauptwerk installation .exe file. If any 'CRC' or 'unexpected end of archive' errors are reported, and you had downloaded Hauptwerk, please try downloading it again. If any 'CRC' or 'unexpected end of archive' errors are reported and you are installing from CD, please check the CD for dirt or scratches, and contact your Hauptwerk vendor for a replacement if necessary.

Step 8. Once the main installer screen has appeared, simply follow the instructions in the installer to complete the installation process.

Important: Please don't cancel the installer after you have clicked Install on the its final summary screen, otherwise a partial, broken installation may result. Please also ensure that you don't re-launch the installer for at least one minute after it has finished, since running two instances of the installer may also result in a corrupted installation. (The installer might keep running in the background for a few moments after it appears to have closed.)

[Near the end of the installation process the USB dongle driver is installed or upgraded automatically. Please note that you will need to acknowledge a message indicating whether it completed succssesfully, which may not be the uppermost window if you have switched to another application during installation. If the installation appears to have frozen whilst waiting for the driver installation to complete, please press Alt+Tab to verify whether the message is visible behind Hauptwerk's installer window, and simply acknowledge it if so.]

Step 9. Launch Hauptwerk by clicking on the relevant icon on your desktop. Please now make a backup of your Hauptwerk settings and data following the step-by-step 'How to make a backup' instructions in the backups section of the guide. Doing so should allow you to get your current settings back in case your computer ever needs to be re-installed in the future.

The current version of Hauptwerk is now ready to use.

Step 10. When you have loaded each of the sample sets that you normally use, we recommend de-fragmenting your computer's hard-disk(s), since this can significantly reduce the time required to load a sample set into Hauptwerk. On Windows XP systems, open Windows Explorer and right-click on the icon for your hard-disk, then select Properties | Tools | Defragment Now, then click the Defragment button. Defragmenting can take several hours, so you may wish to allow this to run overnight. You can do this later if you prefer.


Visit Crumhorn Labs on the Internet
© Crumhorn Labs Ltd 2001-2008

Hauptwerk, Hauptwerk virtual pipe organ, Crumhorn Labs and the Crumhorn Labs and Hauptwerk logos are trademarks of Crumhorn Labs Ltd.