Step-by-step installation instructions for the Kangas Sound Editor

Firstly, dont panic! We know the following looks like a long list, but it really isn't as long as it looks, and if you get stuck on any of the steps, you can use the forums or contact Roo or Joey directly (see links on the KangaSound home page) to get help. You may wish to consider downloading and installing the new Kangas Sound Editor QI instead, which has a quicker installation procedure.

  1. If this is the Kangas Sound Editor for Windows, you can skip this step (go to step 2). Download and install version 6 of the Java Runtime Environment from http://java.sun.com/javase/downloads/index.jsp. Read the link Installation Instructions (also on that web-page) for details of how to do this. If you are a Mac user, there is limited support for Java SE 6 - see support web-site for details.
  2. Download, install, and configure MySQL 5.0 Community Edition database server and client from http://dev.mysql.com/downloads/mysql/5.0.html. Download the version appropriate to your platform (Windows, Linux etc.). Read the relevant platform notes , also on this page, to help guide you in this task. On Windows, we recommend installing 'The Essentials Package', which includes a Configuration wizard to help get you started. On selection of a download, you are given options to login, create a new login account, or if you are pressed for time, go straight to the downloads. The Kangas Sound Editor uses INNO DB, so select an option that allows this when the wizard asks.
  3. Download and install MySQL Administrator and Query Browser from http://dev.mysql.com/downloads/gui-tools/5.0.html
  4. Startup the MySQL server, if it isn't already. On Windows this may involve starting a service for it using Control Panel -> Administative Tools -> Services.
  5. Download the Kangas Sound Editor database setup script archive (.zip file) (an ASCII text file) from SourceForge or KangaSound. Extract the .sql text file 'kangas-sound-editor-2.6.0.db.sql' contained within it using a utility such as Winzip (Windows) or Stuffit (Mac). and save it to a memorable location on your machine.
  6. Start-up and login to the MySQL administrator program. If 'Server Host' is blank, enter localhost. Note that 'root' is the initial user created by the MySQL configuration wizard, the root password can be reset using the MySql instance configuration wizard on Windows, note this password.
  7. Choose the 'Restore' option of that program.
  8. Press the 'Open Backup File' button.
  9. In the dialog that results, select the database script (ie 'kangas-sound-editor-2.6.0.db.sql') you saved in step 5.
  10. Press 'Start Restore'.
  11. After the restore has completed, select 'Catalogs'. Check that 'soundeditor' appears in the bottom left pane of MySQL administrator, and that you can see 20 database tables when 'soundeditor' is selected: anti_harmonic, anti_harmonic_base, anti_harmonic_base_index, anti_harmonic_factor, chord_group, composition, entity, graph, graph_segment, harmonic, harmonic_factor, instrument, interval2, recorded_sound, repetition_group, sequence, sound, track, variation, variation_params.
  12. If you haven't already done so, download the Kangas Sound Editor installation program. This can be done from the download link under software on the Kangas Sound Editor download page, or from a download site such as SourceForge.net
  13. If this is the Kangas Sound Editor for Windows, you should skip this step. Rename the downloaded installation program if necessary to have a file extension of .jar (on IE6 on Windows it is currently downloaded with an extension of .zip).
  14. Run the Kangas Sound Editor installation program by (double) clicking on it.
  15. On Windows, the opportunity to create icons is given. On other operating systems, this has to be done manually (although the installation program will help you by providing a file containing short-cut information).
  16. On Windows, we recommend changing the target properties for the Kangas Sound Editor to allow it to use more memory. For example, prepending 'javaw.exe -jar -Xmx640m' before the soundeditor.jar file will allow upto 640MB to be used by the JVM (Java Virtual Machine). It is not advisable for the number of MB to exceed 70% of the physical memory of the machine (We use 640m with 1GB of physical memory).
  17. Start the Kangas Sound Editor by clicking on it's icon, or invoking from the start menu (depending on what options you selected during installation).
  18. Select Configure->Other parameters from the menu. Set the database user and password to the MySql user (maybe 'root') and password you set up earlier.
  19. Select the Graph->Create menu option. Now click on the finder icon next to the 'Base on graph:' field. In the finder dialog that results, click on 'Show graphs', and then press 'Go'. If a number of graphs appear without errors, it is likely that installation has been successful. Well done Sport!

Home