Changeset 218

Show
Ignore:
Timestamp:
03/13/07 07:55:52 (2 years ago)
Author:
breese
Message:

Completely revised the installation instructions for Media Manager.

Files:

Legend:

Unmodified
Added
Removed
Modified
Copied
Moved

  • trunk/MediaManager/MEDIAMANAGER-INSTALL.txt

    r217 r218  
    2121INSTALLATION 
    2222 
    23 1) To install Media Manager navigate to MT's home directory (where you 
     231) Install Media Manager's files. 
     24 
     25   To install Media Manager navigate to MT's home directory (where you 
    2426   will find mt.cgi) and unpack the Media Manager archive. 
    2527 
    2628   This will place the Media Manager plugin files into: 
    27    $MT_HOME/plugins/MediaManager 
     29 
     30     $MT_HOME/plugins/MediaManager 
     31 
    2832   Media Manager's static files into: 
    29    $MT_HOME/mt-static/plugins/mmanager 
    30    And Media Manager alternative templates into: 
    31    $MT_HOME/alt-tmpl/cms 
    3233 
    33 2) Edit your Movable Type configuration file: 
     34     $MT_HOME/mt-static/plugins/MediaManager 
    3435 
    35    a) Make sure StaticWebPath is set properly in mt-config.cgi. If you have 
    36       not yet migrated your MT installation to mt-config.cgi vs. mt.cfg, you 
    37       are strongly encouraged to do so. (note: it is recommended that 
    38       the value of StaticWebPath have any trailing slashes removed.) 
     36   In the event that you are unable to unpack Media Manager's archive 
     37   directly on the server, you may need to install the files manually. 
     38   To do this, each of Media Manager's files needs to be placed in a 
     39   specific directory, as outlined below: 
    3940 
    40    b) The default value of AltTemplatePath is './alt-tmpl'. Make sure that 
    41       either AltTemplatePath is to its default, or AltTemplatePath is 
    42       commented out, or that you have copied the contents of  
    43       $MT_HOME/alt-tmpl into the directory in which you store alternative 
    44       templates. 
     41     plugins/MediaManager/docs/tagref.html     
     42           ==> $MTHOME/plugins/MediaManager/docs/tagref.html 
     43     plugins/MediaManager/lib/MediaManager/*   
     44           ==> $MTHOME/plugins/MediaManager/lib/MediaManager/ 
     45     plugins/MediaManager/lib/MTAmazon3/*      
     46           ==> $MTHOME/plugins/MediaManager/lib/MTAmazon3/ 
     47     plugins/MediaManager/lib/XML/*            
     48           ==> $MTHOME/plugins/MediaManager/lib/XML/ 
     49     plugins/MediaManager/tmpl/*               
     50           ==> $MTHOME/plugins/MediaManager/tmpl/ 
     51     plugins/MediaManager/mmanager.cgi         
     52           ==> $MTHOME/plugins/MediaManager/mmanager.cgi 
     53     plugins/MediaManager/mtamazon.cgi         
     54           ==> $MTHOME/plugins/MediaManager/mtamazon.cgi 
     55     plugins/MediaManager/MediaManager.pl      
     56           ==> $MTHOME/plugins/MediaManager/MediaManager.pl 
     57     plugins/MediaManager/MTAmazon.pl          
     58           ==> $MTHOME/plugins/MediaManager/MTAmazon.pl 
     59     plugins/MediaManager/MTAmazon.pl          
     60           ==> $MTHOME/plugins/MediaManager/MTAmazon.pl 
    4561 
    46       # AltTemplatePath ./alt-tmpl 
     62     The following files are static files and must be placed in your static 
     63     web path. By default this is $MTHOME/mt-static. 
    4764 
    48 3) Obtain an Amazon Web Services Subscription ID. If you have an Amazon 
    49    Developer Token you still need to obtain a "Subscription ID." 
    50    Developer Tokens are considered relatively "deprecated" by Amazon, 
    51    and a Subscription Id is required to make calls to their newer 
    52    services that Media Manager takes advantage of. 
     65     mt-static/plugins/MediaManager/images/* 
     66           ==> $MTHOME/mt-static/plugins/MediaManager/images 
     67     mt-static/plugins/MediaManager/js/* 
     68           ==> $MTHOME/mt-static/plugins/MediaManager/js 
     69     mt-static/plugins/MediaManager/styles/* 
     70           ==> $MTHOME/mt-static/plugins/MediaManager/styles 
     71     mt-static/plugins/MediaManager/lightbox/* 
     72           ==> $MTHOME/mt-static/plugins/MediaManager/lightbox 
    5373 
    54      http://www.amazon.com/gp/aws/registration/registration-form.html 
     742) Set Your StaticWebPath. 
    5575 
    56    FYI - Any place you have used a Developer Token in the past, you 
    57    may now use a Subscription Id. They are 100% backwards compatible 
    58    and allow you to obtain more detailed reports and statistics from 
    59    Amazon's Web Services program. 
     76   Media Manager has a number of javascript, css and image files that must 
     77   be accessible via a web browser. If Media Manager appears unstyled, or 
     78   if you are receiving javascript errors, it may be the result of your 
     79   static web path not being set properly. 
    6080 
    61 4) Login to MovableType and confirm that Media Manager is appearing 
    62    as an "Registered Plugin" among the other plugins from the System 
    63    Overview Plugins screen. 
     81   To change your static web path, open up your mt-config.cgi file and look  
     82   for the following lines: 
    6483 
    65 UPGRADING BOOKQUEUETOO 
     84     # If you place all of your MT files in a cgi-bin directory, you 
     85     # will need to place the directory containing your static files 
     86     # (mt-static) elsewhere, so that the webserver will not try to execute 
     87     # them.  StaticWebPath is the path to your mt-static directory. 
     88     # 
     89     # StaticWebPath http://www.example.com/mt-static 
    6690 
    67 1) As of Media Manager 1.0 Beta 9 users upgrading from BookQueue or  
    68    BookQueueToo will be prompted automatically if they wish to upgrade 
    69    to Media Manager. Doing so will migrate all BookQueue data to the 
    70    new Media Manager system. It will NOT delete your BookQueue data. 
     91   Set the value of StaticWebPath to the fully qualified URL of your 
     92   mt-static directory. 
    7193 
    72    Once you are comfortable with the new software, then you are free 
    73    to completely uninstall the older version of BookQueueToo first.  
    74    To do so, remove the following files and directories from your  
    75    server: 
     943) Get an Amazon Web Services account.  
    7695 
    77    > MT_HOME/plugins/BookQueueToo 
    78    > MT_HOME/images/BookQueueToo 
    79    > MT_HOME/tmpl/BookQueueToo 
    80    > MT_HOME/extlib/MTPlugins/BookQueueToo.pm 
     96   Visit the following URL and sign up for an Amazon Web Services  
     97   account. 
    8198 
    82 2) Then follow the installation instructions above. 
     99   Once you signed up, you will need to retrieve your "AWS Access  
     100   Identifiers." Specifically you will need your "Access Key ID." Your 
     101   Access Key ID should be a 20 character string, similar to the 
     102   following: 
    83103 
    84 UPGRADING MEDIA MANAGER 
     104     4FNWS2WS61241WGETX83 
    85105 
    86 If you are upgrading from any previous version of Media Manager (not 
    87 BookQueueToo) then it should be sufficient to simply re-install  
    88 Media Manager over the previous instance, allowing it to copy newer  
    89 files over older one. To confirm an upgrade has taken place properly, check 
    90 MovableType's System Overview for MediaManager among the list of installed 
    91 plug-ins, and its version number in the list of active plugins at  
    92 the bottom of the page. 
     106   Save this Access Key ID to your clipboard. You will need it again 
     107   when configuring Media Manager. 
    93108 
     1094) When you access Movable Type for the first time after successfully 
     110   installing Media Manager, Movable Type will prompt you to upgrade 
     111   or install Media Manager. Click "Continue" until you are finished 
     112   and Movable Type returns you to the application. 
     113 
     1145) Configure Media Manager and MTAmazon. 
     115 
     116   Finally, you will need to navigate to the Plugins tab located 
     117   under your System or Blog "Settings" menu area. From there you 
     118   can find MTAmazon among your list of plugins (located in the 
     119   list as a "Media Manager Plugin Set"). Click "Show Settings" and  
     120   enter values for the following as appropriate: 
     121 
     122     * Amazon Associates ID 
     123     * Amazon Access Key ID 
     124     * Your Locale (US, Japan, France, etc) 
     125 
     1266) Access Media Manager 
     127 
     128   Now that everything is setup properly, click on the link labeled 
     129   "Edit My Media Queue" listed under "Plugin Actions" on the main 
     130   menu for any blog. 
     131 
     132   Alternatively, you can click the "Media Manager" menu item in the 
     133   left hand nav bar listed under "Utilities."