Difference between revisions of "Installation"

From ModWiki
Jump to: navigation, search
 
(26 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
NOTICE:  Currently, use of the installer for current Live versions (9>) isn't really supported.  Although I have updated the installer for MacOS sometime in the last year, I haven't been maintaining it.  Consequently, I'd recommend manual installation for any new users.  You can find information about where each file goes here:
 +
 +
[[Manual Installation|Manual Installation]]
 +
 +
----
 +
 +
 
Before installing Monomodular, make sure you have the most current versions of MaxMSP and Ableton Live installed on your computer.  You will also need a license to use MaxforLive (although it is possible to use everything here in Demo Mode).
 
Before installing Monomodular, make sure you have the most current versions of MaxMSP and Ableton Live installed on your computer.  You will also need a license to use MaxforLive (although it is possible to use everything here in Demo Mode).
  
−
To install the entire Monomodular suite on OSX:
+
You may have navigated here from the installer itself, and you're wondering what its all about.
 +
 
 +
To install all the Monomodular software, just follow the instructions printed in the console window of the Installer patch. 
 +
 
 +
'''MAKE SURE LIVE'S AUDIO ENGINE IS TURNED ON BEFORE LOADING THE INSTALLER'''
 +
 
 +
There are four fields that need to be correct in order for the installation to proceed.  They display the file paths to the locations that the files will be copied on your system.  If they are correct, the field will be white.  If the path couldn't automatically be found, it will say so in red, and you can locate it manually by either clicking on the text or dropping the file/folder onto the box on the left of the text.  The default paths for the files:
 +
 
 +
'''IF YOU ARE USING WINDOWS 7, SEE BELOW FOR SPECIAL INSTRUCTIONS.'''
 +
 
 +
==Installation Package (all platforms):==
 +
 
 +
This is the data that the installer will copy to your computer.  If you downloaded the bundle, it should have been autodetected if you launched the installer from inside that bundles folder.  If not, you can either drag the folder from its location to the box on the left side of the text indicating the path, or you can click on the path and choose it from a file browser.
 +
 
 +
If you are installing from SVN (not available with b993 yet), you must press the "Subversion" button on the right side of the interface, and you will be given a choice of a temp folder where the installer will download the package from its subversion repository.  You can delete this folder manually after the installation is complete, or leave it in place until the next time you update Monomodular with the installer (however, its path is not stored....it will need to be reselected the next time you run the installer).
 +
 
 +
These are the default locations that the installer is looking for.  Under most circumstances, this is where things will be:
 +
 
 +
Here's a video from astarte describing the installation. He's using a Launchpad with Monomodular in the video:
 +
 
 +
[http://www.youtube.com/watch?v=70sBh41X3qw&feature=plcp Astarte's video]
 +
 
 +
----
 +
 
 +
====MacOS====
 +
 
 +
Live.app                       = ~/Applications/Live 8.x.x/Live.app
 +
 
 +
or                                     ~/Applications/Ableton Live 8.app  (version 8.3.x and greater)
 +
 
 +
MaxMSP Folder    = ~/Applications/Max 5
 +
 
 +
Live Library             = ~/Library/Preferences/Live 8.x.x/Library
 +
 
 +
 
 +
----
 +
 
 +
====Windows (pre win7)====
 +
 
 +
Live Folder        = \Program Files\Ableton\Live 8.x.x
 +
 
 +
MaxMSP Folder = \Program Files\Cycling '74\Max 5.x
 +
 
 +
Live Library      =\Documents and Settings\USER\Documents\Ableton
 +
 
 +
 
 +
----
 +
 
 +
====Windows 7====
 +
 
 +
Live Folder = \Program Files\Ableton\Live 8.x.x
 +
 
 +
MaxMSP Folder = \Program Files\Cycling '74\Max 5.x
 +
 
 +
Live Library = \users\username\documents\ableton\Library
 +
 
 +
(see further Win7 specific instructions below)
 +
----
 +
 
 +
Once the installer has verified that the installation paths that you've chosen to be valid places to put its files, you can press the "Install" button to begin moving files to their proper places.  The terminal window on the right will indicate exactly what is being sent to the [shell] object in the patch, and if you are on MacOS, the return result from the shell will be displayed. 
 +
 
 +
The installer will copy its payload to new folders if the correct folders don't already exist.  For every new revision, a new set of folders will be generated.  This is good and bad.  It means that none your old installation will be harmed, so there will be no 'broken' sets when you upgrade.  It also means, however, that if you upgrade as often as revisions are made, you will end up with a bunch of deprecated folders.  For now, you will have to delete these manually.  You can refer to the [[Manual Installation]] page to see what files go where, and what you can delete. 
 +
 
 +
The good news is that Monomodular takes up very little room, so the only downside is a bitter of clutter (mostly in the Control Surface Scripts folder inside your Live installation....this can be a bit frustrating if you change things around often, but otherwise, is completely harmless).
 +
 
 +
If you try to install a Monomodular revision over that same revision, the installer will not overwrite any files.  It should, however, replace any files that might have gone missing through erroneous deletion or movement.
 +
 
 +
Once the installer is finished, it will indicate that you need to restart Live.  So....restart Live already.
 +
 
  
−
The installer is a single .amxd file, and can install all the necessary Monomodular files from within Live itself (the first m4l patch of its kind). The installer is able to place all the files in the Monodular package in their proper directories.  It is also capable of downloading the most recent revision of the beta suite from SVN and installing it's tree to the correct directories (this is the recommended method).
+
====WINDOWS 7 INSTALLATION====
  
−
The link to the Monodular installer file:
+
The installer should be able to autodetect the file locations in the b993 installer, but it probably won't be able to copy them unless you run Live with Administrator priveleges.  You can do this by right-clicking Live's application and choosing "Run as Administator". 
  
−
(placeholder)
+
However, this causes its own set of difficulties, because you can't move files into Live by dragging and dropping while its running as Admin.  If you run into these problems, its best to run Live regularly first, drop the installer into Live's Presets (under Max MIDI Device), then restart Live running it as Admin, and run the installer at that point.  You'll still have to select the installer payload, but it should autodetect everything else.
  
−
You may also download the entire package (but it may not be as current):
+
Sheesh.
  
−
(placeholder)
+
== Limitations ==
  
−
In order to use the installer, merely place it in Live's Library, under 'Presets/MIDI Effects/Max MIDI Effect/'.  The easiest way to do this is to drag it from the Finder into Live's device browser.   
+
All I can really say is:  '''READ THE DIRECTIONS.''' I've done my best to make the installation as painless as possible, and I've included as much documentation both with the Installer patches and in this Wiki as I can think to.   
  
−
Next, drag the 'Monomodular Installer" device from Live's device browser into a MIDI track.
+
That said, this is the first 'm4l Native' installer that I've seen in the wild, and I'm doing all I can to make it compatible with as many systems as possible.  Worst case scenario with this installer is that you have to choose your own paths before you hit the "Install" button, which still eases the process of having to manually install all of the files.
  
−
If you plan on installing from SVN, click on the "Subversion" button. A dialog will appear asking you for a directory location so that the installer has a place to put the files its going to download from svn.  You can either choose an existing directory or create a new one from the browser dialog.
+
The newest installation will get tagged with the revision number (e.g. blahblahb992'''r030112''') , the suffix being the date that it was compiled for release. That means it should add to/overwrite any old data.   
  
−
The installer will now download all of the current files.  The darwin's output will be displayed in the terminal window on the right as it makes progress.  Any errors should show up there.
+
Currently, we're still testing out the Installer on different systems to see what works and what won't.  There may be problems with Lion and Win7, because I don't have an installation of either at the moment and I'm therefore relying on end user input to work out the details.  If you have one of these operating systems and want to help out, please contact me via email and we'll work on it.  
  
−
When it is finished, it is quite possible that everything is ready to go.  The installer uses Live's log.txt file to try and decide where it should put the files it will install.  However, if you have multiple Library's installed (which is a frequent occurence), it may get these locations wrong. No worries, the installer won't overwrite anything that is already on your computer, but it might get the locations wrong.
+
Otherwise, unless your system is "REALLY" weird, the installer should work fine.  I have no experience with trying to install to external partitions, but you should have all this stuff on the root partition anyway. Regardless, let me know how this works out (or doesn't).
  
−
If you've already downloaded the package, just make sure to select it's location in the top path, next to the box that says 'Installation Package'.  You can also drop the folder on that box.
+
== Python Persistence ==
  
−
Its a good idea to double check to make sure everything looks right. The proper locations should be as follows:
+
One of the things I've learned about Python and Live recently is that it caches all the modules on load, and likes to fill in the gaps of missing data with what it has cached.  This means if there are more than one module with the same name in its search paths, things can get tricky.  For this reason, I highly recommend that when installing new versions of the betas, you clean out the old ones from your MIDI Remote Scripts directory.  Nine times out of ten it won't make a bit of difference, but if you're having problems with things not working the way they are supposed to, it is the first thing I'd try to get things back to normal.
  
−
Installation package:  this should point to the Monomodular files that are about to be installed.  If you downloaded the current subversion revision, then the folder should automatically be chosen (it is the folder that you specified when you told the installer to download from svn).  If you are installing from a downloaded package, just make sure this points to the folder containing the Monomodular package.  If the package is in the same place as the installer, it should be automatically found.
+
== Live Crashes ==
  
−
Live.app: this is the Application bundle for Live.  You can drag and drop Live's app onto the box to the right of the patch, or click on the path and choose it from the dialog.  This should be the actual application, not the folder containing it.
+
I've experienced on several occasions (in OSX) that the installer will crash Live if the log.txt file is either too long or has bad file references.  If the installer is crashing Live on your system, you might try deleting Live's log.txt file.  It won't hurt anything, and its solved the only crashes that I've ever encountered using the installer.  Live will create a new log.txt file the next time you start Live, and the installer will be able to do its thing without problems.
  
−
MaxMSP Folder:  this is the folder containing the MaxMSP application.  It should be automatically chosen.  If for some reason it wasn't, its possible that certain subfolders may be missing from it.
+
== Root Volume ==
  
−
Live Library: this is the folder containing the MaxforLive patches in Live's current Library. It's generic location is '~/Library/Application Support/Ableton/Library', but it could be elsewhere if you've moved things around.
+
Don't expect the installer to work on Windows if you've got your base installation on a drive other than C:\.   It just probably won't.
  
−
If all of the locations are valid installations, their paths should be colored white.  Otherwise, they will be red and you need to choose them manually.
+
== Manual Installation ==
  
−
To install the files to the chosen locations, press the install button.  The paths will be rechecked, and if valid, the installer will begin moving files.  Progress is indicated by the bar on the bottom right.
+
If the installer just doesn't work for you for whatever reason, you can always put the files where they go manually.  Here's some more information on how to do that:
  
−
After installation, it is necessary to restart Live in order for it to recognize the new Python files that were installed inside its application bundle.
+
[[Manual Installation|Manual Installation]]

Latest revision as of 16:15, 5 January 2014

NOTICE: Currently, use of the installer for current Live versions (9>) isn't really supported. Although I have updated the installer for MacOS sometime in the last year, I haven't been maintaining it. Consequently, I'd recommend manual installation for any new users. You can find information about where each file goes here:

Manual Installation


Before installing Monomodular, make sure you have the most current versions of MaxMSP and Ableton Live installed on your computer. You will also need a license to use MaxforLive (although it is possible to use everything here in Demo Mode).

You may have navigated here from the installer itself, and you're wondering what its all about.

To install all the Monomodular software, just follow the instructions printed in the console window of the Installer patch.

MAKE SURE LIVE'S AUDIO ENGINE IS TURNED ON BEFORE LOADING THE INSTALLER

There are four fields that need to be correct in order for the installation to proceed. They display the file paths to the locations that the files will be copied on your system. If they are correct, the field will be white. If the path couldn't automatically be found, it will say so in red, and you can locate it manually by either clicking on the text or dropping the file/folder onto the box on the left of the text. The default paths for the files:

IF YOU ARE USING WINDOWS 7, SEE BELOW FOR SPECIAL INSTRUCTIONS.

Installation Package (all platforms):

This is the data that the installer will copy to your computer. If you downloaded the bundle, it should have been autodetected if you launched the installer from inside that bundles folder. If not, you can either drag the folder from its location to the box on the left side of the text indicating the path, or you can click on the path and choose it from a file browser.

If you are installing from SVN (not available with b993 yet), you must press the "Subversion" button on the right side of the interface, and you will be given a choice of a temp folder where the installer will download the package from its subversion repository. You can delete this folder manually after the installation is complete, or leave it in place until the next time you update Monomodular with the installer (however, its path is not stored....it will need to be reselected the next time you run the installer).

These are the default locations that the installer is looking for. Under most circumstances, this is where things will be:

Here's a video from astarte describing the installation. He's using a Launchpad with Monomodular in the video:

Astarte's video

MacOS

Live.app             = ~/Applications/Live 8.x.x/Live.app

or                 ~/Applications/Ableton Live 8.app (version 8.3.x and greater)

MaxMSP Folder   = ~/Applications/Max 5

Live Library       = ~/Library/Preferences/Live 8.x.x/Library


Windows (pre win7)

Live Folder = \Program Files\Ableton\Live 8.x.x

MaxMSP Folder = \Program Files\Cycling '74\Max 5.x

Live Library =\Documents and Settings\USER\Documents\Ableton


Windows 7

Live Folder = \Program Files\Ableton\Live 8.x.x

MaxMSP Folder = \Program Files\Cycling '74\Max 5.x

Live Library = \users\username\documents\ableton\Library

(see further Win7 specific instructions below)

Once the installer has verified that the installation paths that you've chosen to be valid places to put its files, you can press the "Install" button to begin moving files to their proper places. The terminal window on the right will indicate exactly what is being sent to the [shell] object in the patch, and if you are on MacOS, the return result from the shell will be displayed.

The installer will copy its payload to new folders if the correct folders don't already exist. For every new revision, a new set of folders will be generated. This is good and bad. It means that none your old installation will be harmed, so there will be no 'broken' sets when you upgrade. It also means, however, that if you upgrade as often as revisions are made, you will end up with a bunch of deprecated folders. For now, you will have to delete these manually. You can refer to the Manual Installation page to see what files go where, and what you can delete.

The good news is that Monomodular takes up very little room, so the only downside is a bitter of clutter (mostly in the Control Surface Scripts folder inside your Live installation....this can be a bit frustrating if you change things around often, but otherwise, is completely harmless).

If you try to install a Monomodular revision over that same revision, the installer will not overwrite any files. It should, however, replace any files that might have gone missing through erroneous deletion or movement.

Once the installer is finished, it will indicate that you need to restart Live. So....restart Live already.


WINDOWS 7 INSTALLATION

The installer should be able to autodetect the file locations in the b993 installer, but it probably won't be able to copy them unless you run Live with Administrator priveleges. You can do this by right-clicking Live's application and choosing "Run as Administator".

However, this causes its own set of difficulties, because you can't move files into Live by dragging and dropping while its running as Admin. If you run into these problems, its best to run Live regularly first, drop the installer into Live's Presets (under Max MIDI Device), then restart Live running it as Admin, and run the installer at that point. You'll still have to select the installer payload, but it should autodetect everything else.

Sheesh.

Limitations

All I can really say is: READ THE DIRECTIONS. I've done my best to make the installation as painless as possible, and I've included as much documentation both with the Installer patches and in this Wiki as I can think to.

That said, this is the first 'm4l Native' installer that I've seen in the wild, and I'm doing all I can to make it compatible with as many systems as possible. Worst case scenario with this installer is that you have to choose your own paths before you hit the "Install" button, which still eases the process of having to manually install all of the files.

The newest installation will get tagged with the revision number (e.g. blahblahb992r030112) , the suffix being the date that it was compiled for release. That means it should add to/overwrite any old data.

Currently, we're still testing out the Installer on different systems to see what works and what won't. There may be problems with Lion and Win7, because I don't have an installation of either at the moment and I'm therefore relying on end user input to work out the details. If you have one of these operating systems and want to help out, please contact me via email and we'll work on it.

Otherwise, unless your system is "REALLY" weird, the installer should work fine. I have no experience with trying to install to external partitions, but you should have all this stuff on the root partition anyway. Regardless, let me know how this works out (or doesn't).

Python Persistence

One of the things I've learned about Python and Live recently is that it caches all the modules on load, and likes to fill in the gaps of missing data with what it has cached. This means if there are more than one module with the same name in its search paths, things can get tricky. For this reason, I highly recommend that when installing new versions of the betas, you clean out the old ones from your MIDI Remote Scripts directory. Nine times out of ten it won't make a bit of difference, but if you're having problems with things not working the way they are supposed to, it is the first thing I'd try to get things back to normal.

Live Crashes

I've experienced on several occasions (in OSX) that the installer will crash Live if the log.txt file is either too long or has bad file references. If the installer is crashing Live on your system, you might try deleting Live's log.txt file. It won't hurt anything, and its solved the only crashes that I've ever encountered using the installer. Live will create a new log.txt file the next time you start Live, and the installer will be able to do its thing without problems.

Root Volume

Don't expect the installer to work on Windows if you've got your base installation on a drive other than C:\. It just probably won't.

Manual Installation

If the installer just doesn't work for you for whatever reason, you can always put the files where they go manually. Here's some more information on how to do that:

Manual Installation

Retrieved from "https://aumhaa.com/wiki/index.php?title=Installation&oldid=716"