Kaltura MediaSpace TM Enterprise 2.0 Requirements and Installatin Updated Aug 30, 2011 Server Requirements Hardware The hardware requirements are mstly dependent n the number f cncurrent users yu expect fr yur MediaSpace setup. Assuming yu assign a dedicated server t it (nt strictly required), here is what yu can expect: Sftware CPU: basically a nn-issue with all mdern servers this applicatin is nt CPU intensive Strage: a nn-issue - the entire applicatin, with caching turned n, shuld cnsume less than 10 megabytes f hard disk space. Any server OS Apache 2+ Memry: we estimate that a typical plain server with 3GB f memry culd supprt 100 cncurrent requests. Since nt all users are making requests every single mment they are n the system, we feel it is safe t assume that this wuld be enugh fr 1,000 cncurrent users. Examples: lading a new gallery creates a request but paging thrugh an already laded gallery des nt; clicking n a thumbnail in the gallery (lading a vide int the player) creates a request, but btaining an embed cde fr that vide des nt. Imprtant nte: the nly real measure is requests and the number f users is really a guesstimate/ assumptin. After installing MediaSpace, make sure Apache has read and write permissins fr the fllwing MediaSpace directries and files: cache, lgs, cnfig, cnfig/backup, cnfig/cnfig.ini.php, cnfig/usercmments.txt Apache must nt be set t disregard.htaccess files. PHP 5.2.x r 5.3.x PHP lib curl (http://php.net/manual/en/bk.curl.php) Ensure PHP has the XSL mdule activated (required fr the new Custm Metadata feature): Yu can find ut if it is activated by typing php m in yur server cnsle and search fr "xsl" in the listed results On mst Linux machines, yu can activate this mdule by typing sud apt-get install php5-xsl in yur server cnsle and restarting Apache 2011 Kaltura Inc. All rights reserved. Page 1 f 5
Installatin 1. Check ut the cde t a directry n yur server that is accessible via a web brwser Checkut frm: svn+ssh://mediaspace@kelev.kaltura.cm/usr/lcal/kalsurce/prjects/ mediaspace/scial/branches/production/website/. Include the space and dt at the end t avid checking ut the "website" directry itself (nt applicable when using Trtise SVN n Windws) The read-nly passwrd fr this lcatin is: ahthaeh1 (yu will have t enter it twice) Surce files fr graphics and additinal dcumentatin is available at svn+ssh://mediaspace@kelev.kaltura.cm/usr/lcal/kalsurce/prjects/ mediaspace/scial/branches/production/surce_files 2. Place the cnfig.ini.php file prvided t yu by yur Kaltura Prject Manager in the /cnfig directry 3. Apply the read/write permissins specified under "Requirements > Sftware" abve 4. MediaSpace is nw ready t be used Cnfiguratin Manager This assumes that the required categries have been set up in the KMC (Kaltura Management Cnsle) read mre abut setting up the KMC fr MediaSpace at the end f this dcument. MediaSpace Enterprise 2.0 includes a graphical user interface fr cnfiguring the applicatin. Access it by brwsing t /admin/cnfig and entering yur KMC credentials. This interface allws yu t set apprximately 100 different settings fr yur applicatin such as basic settings regarding yur particular Kaltura accunt, the lk and behavir f yur applicatin, enabling/ disabling features, defining user rles and authenticatin methd, etc. Each item has a help icn next t it. Placing yur muse cursr ver it will shw the help in a tltip that will disappear after a cuple f secnds). Clicking n it will shw the help in an alert bx (which yu will have t clse). Every time yu click save, the changes are saved t /cnfig/cnfig.ini.php and a backup is saved t /cnfig/backup. User Management MediaSpace cmes with several built in ptins fr user authenticatin as well as supprt fr writing yur wn authenticatin class. The user authenticatin methd is set via the authclass cnfig setting (AUTH & LOGIN tab in the Cnfiguratin Manager). Kaltura users, KMC credentials and MediaSpace credentials: KMC credentials are required fr lgin t the Cnfiguratin Manager and User Management mdules f MediaSpace but cannt be used t lgin t MediaSpace itself as a user. 2011 Kaltura Inc. All rights reserved. Page 2 f 5
User Management, Cnt'd The first time a user wh is lgged int MediaSpace creates cntent frm within MediaSpace, a Kaltura user is autmatically created fr them based n the user name they are lgged in with. Annymus mde: MediaSpace supprts an annymus mde which allws fr brwsing f galleries and viewing f media withut perfrming lgin. This ptin is disabled by default and is set in the AUTH & LOGIN tab in the Cnfiguratin Manager. Authenticatin ptins: DemAuth: MediaSpace is cnfigured by default t use this unsecure methd, allwing yu quick access t the applicatin immediately after installatin. This methd is insecure: whatever user name is entered is accepted and a passwrd is nt required. All users are lgged in with the rle f adminrle which is permitted t d everything pssible in the applicatin (thugh sme features are disabled by default / can be disabled in the Cnfiguratin Manager). KalturaAuth: this methd enables MediaSpace's built-in User Management mdule allwing yu t create users and assign rles frm within MediaSpace Access the User Management mdule at /admin/users and lg in using yur KMC credentials. Use this methd if yu d nt have an external mechanism/ system fr managing users and d nt need t manage many users (anything beynd 100-200 users prbably starts making this methd impractical). Users are created and authenticated using the Kaltura User Object and API (n lcal database). SSOAuth: a generic authenticatin methd which requires yu t write sme cde n yur wn based n yur knwledge f yur wn system and prvides yu an easy way t pass lgged in users int MediaSpace. See sample cde and read mre abut SSOAuth in svn+ssh://mediaspace@kelev.kaltura.cm/usr/lcal/kalsurce/pr jects/mediaspace/scial/branches/production/surce_files LDAP and Shibbleth: MediaSpace als has generic authenticatin classes fr LDAP and Shibbleth but we have fund that these typically require additinal custmizatins fr each particular setup. Cnsult yur Kaltura Prject Manager abut csts f MediaSpace Prfessinal Services. 2011 Kaltura Inc. All rights reserved. Page 3 f 5
KMC Setup As a minimum yu need t create the fllwing categries (in KMC > Cntent > Manage): 1. Rt Categry. A categry under which all the MediaSpace categries and cntent will be placed. 2. Subcategries: This shuld match rtcategry cnfig whse default value is "MediaSpace". The rtcategry cnfig can be fund in the BASICS tab in the Cnfiguratin Manager. The Cnfiguratin Manager is accessible at admin/cnfig and the lgin credentials are yur KMC credentials. Under the Rt Categry yu must create at least ne sub categry. Each f these sub categries must themselves have at least ne sub categry (as per abve image). 3. Private Categry. A categry fr cntent upladed via MediaSpace but nt published within MediaSpace: The categry name shuld match the privatecategry cnfig and is "kmsprivate" by default. This categry shuld NOT be placed under the MediaSpace Rt Categry and shuld be a tp-level categry in the KMC. Cntent is left unpublished and placed in the Private Categry directry if: 2011 Kaltura Inc. All rights reserved. Page 4 f 5
KMC Setup, Cnt'd Useful Tips fr Setup: Srting categries: 1. A user checks the "Nt Published" checkbx in the Edit Details frm (which is displayed immediately after uplad r when clicking n the Edit Details link in the Details tab, belw the vide player). Yu can hide the "Nt Published" ptin by setting the allwprivate cnfig t "false" (in the BEHAVIOR tab in the Cnfiguratin Manager) 2. The user is assigned the privateonlyrle (in which case s/he is nt presented with the Categries selectr in the Edit Details frm). Categries are srted alphabetically. T affect the srt rder f yur categries and subcategries yu can add a prefix made up f a number plus an underscre befre the categry name like s: 111_My Categry name. Placing cntent: Mre Inf If yu have a lt f categries t srt, we recmmend yu start with 111 and skip ten at a time t leave rm fr adding mre categries later (i.e. 111, 121, 131, etc.) Nte that since the srting is alphabetical and nt numerical 10 will appear befre 2, 29 will appear befre 3, etc. (which is why we recmmend starting with 111). Fr best results, place yur cntent n the bttm-mst subcategries in each categry tree (als knwn as "leaves"). See these vide tutrials t learn mre abut setting up and using MediaSpace. 2011 Kaltura Inc. All rights reserved. Page 5 f 5