Upgrading Kaltura MediaSpace TM Enterprise 1.0 t Kaltura MediaSpace TM Enterprise 2.0 Assumptins: The existing cde was checked ut f: svn+ssh://mediaspace@kelev.kaltura.cm/usr/lcal/kalsurce/prjects/m ediaspace/scial/branches/production/website/. Cnfirm this by ging t the directry where MediaSpace is installed and typing svn inf. The infrmatin yu are lking fr shuld be in the secnd line that begins with "URL:" Prerequisites: 1. Send yur current cnfig.ini.php file t yur Kaltura Prject Manager / Accunt Manager/ Custmer Supprt s that it can be updated and returned t yu This is nt strictly required but will make yur life easier 2. Ensure that yur PHP installatin has the XSL mdule activated (required fr the new custm metadata feature) Yu can find this ut by typing php m in yur server cnsle and search fr "xsl" in the listed results If it is nt present, ask yur IT t activate PHP's XSL mdule (fr instance n mst Linux machines, yu can d it by running sud apt-get install php5-xsl and restarting Apache) 3. If yur MediaSpace installatin is already live, yu shuld first update a staging envirnment: If yu dn't have a staging envirnment set up, yu can simply cpy all the cde (including.svn directries) t a new lcatin and that will create a staging envirnment cnnected t the prper SVN repsitry A pssible prblem when running the staging and prductin instances ff f the same dmain: A user wh is using the same brwser t view bth instances (prbably yu) culd have the sessins f bth instances get mixed up (s fr example if yu are lgged in t ne instance yu becme lgged in t the ther, etc.) This is fixable by setting the php_sessin_name cnfig t a different value n each instance. This prblem des nt ccur if the instances use different subdmains. 2011 Kaltura Inc. All rights reserved. 1
Updating the cde: If Yu Did NOT Change MediaSpace (ther than changing cnfig.ini.php): 1. Back up yur cnfig.ini.php file 2. Using yur server cnsle, g t the directry where MediaSpace is installed: Delete the cntents f the /cache directry run svn up (the passwrd is ahthaeh1 and needs t be entered twice) 3. Place the new cnfig.ini.php file yu received frm Kaltura in the /cnfig directry 4. Give Apache read and write permissins fr the fllwing MediaSpace directries and files: Cache Lgs Cnfig cnfig/backup cnfig/cnfig.ini.php cnfig/usercmments.txt 5. MediaSpace Enterprise 2.0 is ready fr use Read Imprtant Ntes further dwn this dcument fr mre infrmatin abut changes t the cnfiguratin that culd affect yu Read abut the new Cnfiguratin Manager further dwn this dcument If Yu Made Changes T MediaSpace (have mdified any f the files that came with MediaSpace): If all yu changed was adding a custm authclass, yu can still fllw the simpler prcess utlined abve (Read abut using yur authclass in the Cnfiguratin Manager in the "Imprtant Ntes" belw). If yu custmized an existing authclass withut changing its name, either fllw the steps belw r: 1. Back up the file 2. Fllw the steps abve 3. Ignre the cnflict n that file if yu get ne 4. After updating, verwrite the file with the ne yu backed up 5. Read abut using yur authclass in the Cnfiguratin Manager in the "Imprtant Ntes" belw Recmmended Upgrade Path If Yu Have Made Other Changes t MediaSpace: 2011 Kaltura Inc. All rights reserved. 2
A General Nte: While yu culd fllw the path f ding svn up and then reslving cnflicts, we feel that the crrect path t take is t d a clean checkut and then cmpare the tw versins and re-implement yur changes. This will end up being the same amunt f wrk but instead f starting with smething brken and fixing it yu start with smething wrking and enhance it. Imprtant Ntes: 1. Fllw the steps in "Kaltura MediaSpace TM Enterprise 2.0 Requirements and Installatin" dcument and d a clean install f MediaSpace Enterprise 2.0 This will nw be yur staging envirnment 2. G t the directry where MediaSpace Enterprise 1.0 is installed and type svn status t find ut which files yu have changed lcally 3. Start diffing the files ne by ne t re- implement yur changes int MediaSpace Enterprise 2.0 1. New Header Theme: If yu have CSS r JavaScript changes, implement them int new.css/.js files and have them lad int MediaSpace by using the cnfigs in the "OTHER" tab f the Cnfiguratin Manager: Lad custm CSS file/s using the extracss cnfig Lad custm JavaScript file/s using the bttmladextrajs and the tpladextrajs cnfigs Using external files fr custm CSS and JS will save yu time next time yu need t update MediaSpace. MediaSpace Enterprise 2.0 supprts bth a "dark" and "light" theme fr the header. The default is "dark" s yur existing lg which was prbably made t wrk with a white backgrund will likely lk ut f place. Slve this by either replacing the image yu use fr the lg, pinting the lgimage cnfig t a new lg r changing the headertheme cnfig t "light" (bth are in the "HEADER" tab f the Cnfiguratin Manager) 2. New Cnfigurable Header Menu: MediaSpace nw supprts a fully cnfigurable header menu ( headermenu in "HEADER" tab f the Cnfiguratin Manager): The helplinks[] cnfig has been deprecated - if yu had previusly filled ut the helplinks[] cnfig, yu will need t recreate the help menu using the headermenu cnfig: 2011 Kaltura Inc. All rights reserved. 3
T make the transitin easier we precnfigured headermenu with an item fr a help menu ("type" is set t "menu" and "label" is set t "Help"). This will be clearer when yu see it in the Cnfiguratin Manager. 3. Using a Custm Authenticatin Class in MediaSpace Enterprise 2.0 If yu use yur wn authclass in MediaSpace Enterprise 1.0 it will be included in the new cnfig.ini.php file Kaltura prvided yu with and will appear in the Cnfiguratin Manager. If yu then select anther authclass in the "AUTH & LOGIN" tab f the Cnfiguratin Manager and click "save", yur custm authclass will n lnger appear in the Cnfiguratin Manager. T change back t yur custm authclass, add it manually t /cnfig/cnfig.ini.php. Once yu d it will als reappear in the Cnfiguratin Manager. If yur authclass uses custm cnfig settings added by yu, yu will need t add them manually t the updated cnfig.ini.php file prvided t yu by Kaltura. 4. Deprecated and Changed Cnfigs: Deprecated: shwmixes, shwlivestreams, autcntinue, shwnwplayingplaylist, helplinks[] (functinality maintained via new headermenu cnfig) Having these cnfigs remain in yur cnfig.,ini.php file shuld nt have any effect ne way r the ther If yu used any f the functinality assciated with the abve cnfigs, please infrm yur Kaltura Prject Manager Changed: allwedmediatypes[] will n lnger effect which media types are presented in gallery - all are shwn by default. All it des nw is cntrl which types can filtered using the "Shw" filter abve the gallery. The Kaltura Cntributin Wizard (defined via the kcwid cnfig) can be changed t cntrl which media types can be upladed (ask Yur Kaltura Prject Manager fr help) The new Cnfiguratin Manager: MediaSpace Enterprise 2.0 includes a graphical user interface fr cnfiguring MediaSpace (the Cnfiguratin Manager). Access it using yur brwser at /admin/cnfig and use yur KMC credentials t lg in. It lks best using Firefx but shuld be functinal using ther brwsers. Next t each item is a [?] which shws the instructins fr that item bth as a tltip n muse-ver and as an alert bx when clicked. 2011 Kaltura Inc. All rights reserved. 4
Remember that yur new cnfig.ini.php file is nw lcated in the /cnfig directry If yu did an update (as ppsed t a new install), the ld cnfig.ini.php file is still in the rt directry but is nt being used r updated (yu can delete it r keep it there as a reference) Every time yu click save in the Cnfiguratin Manager a backup is saved t /cnfig/backup Yu can update the cnfig file manually using a text editr but it is best and safest t use the Cnfiguratin Manager Saving new cmments and retrieving cmments frm the ld cnfig.ini.php file: Yu can save yur wn cmments in the Cmments tab f the Cnfiguratin Manager If yu had cmmented lines in the ld cnfig.ini.php file (like paths t staging vs prductin, etc.), they did nt carry ver t the new cnfig 2011 Kaltura Inc. All rights reserved. 5