Cchost draft - Revision history

Fourstones at 00:18, 31 August 2006

2006-08-31T00:18:10Z

← Older revision		Revision as of 00:18, 31 August 2006
Line 42:		Line 42:

	If you have basic knowledge of using FTP and you are comfortable at a terminal command line you can use these steps to before, during and after installation. Many of these can be filed under "you'll be glad you did" by the time you get to the browser-based installation steps later on.		If you have basic knowledge of using FTP and you are comfortable at a terminal command line you can use these steps to before, during and after installation. Many of these can be filed under "you'll be glad you did" by the time you get to the browser-based installation steps later on.

	~~==== General Requirements ====~~
	* A web server.
	* PHP 4/5 (PHP 5 requires ccHost 3.0 or above.)
	* MySQL 4/5 (MySQL 5 requires ccHost 3.0 or above.)
	* Tested on: Firefox 1.0+ Mac/PC/Linux, IE 6+ PC, Safari Mac
	* Cookies enabled in one's browser.
	* Most skins (that people would want to use) require Javascript enabled

	==== Enabling 'Pretty URLs' ====		==== Enabling 'Pretty URLs' ====
Line 251:		Line 243:
	Besides its focus on sharing content, ccHost differniates itself from other multi-media hosting programs by emphasizing the '''reuse''' (a.k.a. remixing) of content between artists, not only between artists on any given installation of ccHost, but between all installations across the web and any web site that implements the Creative Commons [http://ccmixter.org/media/viewfile/pool_api_doc.xml Sample Pool API], including non-ccHost sites such as the [http://freesound.iua.upf.edu/ freesound project].		Besides its focus on sharing content, ccHost differniates itself from other multi-media hosting programs by emphasizing the '''reuse''' (a.k.a. remixing) of content between artists, not only between artists on any given installation of ccHost, but between all installations across the web and any web site that implements the Creative Commons [http://ccmixter.org/media/viewfile/pool_api_doc.xml Sample Pool API], including non-ccHost sites such as the [http://freesound.iua.upf.edu/ freesound project].

			=== Press ===

	=== [[CcHost Release Notes\|Release Notes]] ===		==== [[CcHost Release Notes\|Release Notes]] ====

	=== [[CcHost Press Releases\|Press Releases]] ===		==== [[CcHost Press Releases\|Press Releases]] ====

	=== Sound Bites ===		==== Sound Bites ====

	* "ccHost enables you to '''run your own flickr or youtube while having an infrastructure for legally sharing audio, video, text, and other media.''" [[User:Jon Phillips\|Jon Phillips]] 22:50, 25 August 2006 (UTC)		* "ccHost enables you to '''run your own flickr or youtube while having an infrastructure for legally sharing audio, video, text, and other media.''" [[User:Jon Phillips\|Jon Phillips]] 22:50, 25 August 2006 (UTC)
Line 262:		Line 255:
	''Please add your own sound bite...''		''Please add your own sound bite...''

	=== [[ccHost Screenshots\|Screenshots]] ===		==== [[ccHost Screenshots\|Screenshots]] ====

	* The text for the front page can be changed by editing ccfiles/home.xml. The other menu functions and so on are generally modified using the admin functions of the site.		* The text for the front page can be changed by editing ccfiles/home.xml. The other menu functions and so on are generally modified using the admin functions of the site.

Fourstones at 00:13, 31 August 2006

2006-08-31T00:13:41Z

← Older revision		Revision as of 00:13, 31 August 2006
Line 196:		Line 196:
	= Development =		= Development =

	=== Source ~~and~~ Code Documentation ===		=== Source Code & Documentation ===

	* [http://svn.sourceforge.net/viewcvs.cgi/cctools/cchost/trunk/ Browsable Source Code (Anonymous)]		* [http://svn.sourceforge.net/viewcvs.cgi/cctools/cchost/trunk/ Browsable Source Code (Anonymous)]
Line 216:		Line 216:
	=== Submitting Code ===		=== Submitting Code ===

	Before going too far down ~~that~~ road you definitely want to hop on the [https://lists.sourceforge.net/mailman/listinfo/cctools-cchost dev mailing list]. If you are shy ask to speak with Victor or Jon in private.		Before going too far down this road you definitely want to hop on the [https://lists.sourceforge.net/mailman/listinfo/cctools-cchost dev mailing list]. If you are shy ask to speak with Victor or Jon in private.

			[[HOWTO Patch\|Submit Patches]]

	=== Bugs and Feature Requests ===		=== Bugs and Feature Requests ===
Line 225:		Line 226:
	* [https://sourceforge.net/tracker/?atid=559966&group_id=80503&func=browse Report Bugs]		* [https://sourceforge.net/tracker/?atid=559966&group_id=80503&func=browse Report Bugs]
	* [https://sourceforge.net/tracker/?group_id=80503&atid=559969 Request Features]		* [https://sourceforge.net/tracker/?group_id=80503&atid=559969 Request Features]
	* [[HOWTO Patch\|Submit Patches]]

	~~==== XAMPP ====~~
	Windows developers without Apache, mySQL and PHP already installed may want to considering using [http://www.apachefriends.org/en/xampp.html XAMPP] for Windows, which provides an easy install of Apache web server, MySQL database server, and PHP and perl programming languages. This is an easy way to get up and running, with the underlying technology necessary to use ccHost.

	~~Follow the instructions for installation of XAMPP to know where to put the uncompressed ccHost package to properly work with your local setup.~~


Line 313:		Line 309:

	Even if you using Apache on Windows you may need to have IIS installed if you plan to use mail contact functions.		Even if you using Apache on Windows you may need to have IIS installed if you plan to use mail contact functions.

			===== XAMPP =====
			Windows installations without Apache, mySQL and PHP already installed may want to considering using [http://www.apachefriends.org/en/xampp.html XAMPP] for Windows, which provides an easy install of Apache web server, MySQL database server, and PHP and perl programming languages. This is an easy way to get up and running, with the underlying technology necessary to use ccHost.

			Follow the instructions for installation of XAMPP to know where to put the uncompressed ccHost package to properly work with your local setup.


	==== Mac OS X ====		==== Mac OS X ====

Fourstones at 00:00, 31 August 2006

2006-08-31T00:00:22Z

@@ Line 168: / Line 168: @@
 ==== General ====
 #Log in as administrator to your current install (make sure to check 'Remember Me')
 #Browse to: <nowiki>http://where_you_installed/?update=1</nowiki>
 ==== Upgrading from 2.x to 3.0 ====
 This specific upgrade requires a few extra steps
-#Log in as administrator to your current install (make sure to check 'Remember Me')
-#If you made changes to ''ccfiles'' directory (like home.xml) then make a backup copy of your ccfiles directory
+#Make a BACKUP of your mySQL database (can be done via phpMyAdmin or from the command line using mysqldump)
-#Copy the new installation over your current installation.
+#Make a BACKUP of your cchost directory onto your local machine (skip the /people and /contests directories). If you skip this step and you made changes (to say ccfiles/home.xml) then '''ALL YOUR CHANGES WILL BE LOST FOREVER'''
-#Delete the ccadmin directory
+#Login to ccHost as your admin account and make sure to check 'Remember me'
 #Delete the file '''ccextras/cc-language.php'''
-#Empty the directory '''cclib/phptal/phptal_cache'''
+#Delete ALL files under '''cclib/phptal/phptal_cache'''
 #Browse to: <nowiki>http://where_you_installed/?update=1</nowiki>
 = Administration =
@@ Line 322: / Line 286: @@
 * '''Please add your installation here.'''
 = Redistribution =
 === HOWTO Tag a Release ===

Fourstones at 23:47, 30 August 2006

2006-08-30T23:47:00Z

Show changes

Fourstones at 23:12, 30 August 2006

2006-08-30T23:12:45Z

@@ Line 5: / Line 5: @@
 [[Category:ccMixter]]
 = Download =
@@ Line 37: / Line 38: @@
 #Unzip the ccHost ZIP archive on your local system and copy the files to your server retaining the the directory structure.
 #Browse to '''<nowiki>http://where_you_installed/ccadmin</nowiki>''' and follow all the instructions from then on.
 === Advanced ===
@@ Line 163: / Line 163: @@
 </Limit>
 </pre>
 = Compatibility =
@@ Line 238: / Line 256: @@
 * [https://sourceforge.net/tracker/?group_id=80503&atid=559969 Request Features]
 * [[HOWTO Patch|Submit Patches]]
 ==== XAMPP ====
@@ Line 246: / Line 262: @@
 Follow the instructions for installation of XAMPP to know where to put the uncompressed ccHost package to properly work with your local setup.
 * The text for the front page can be changed by editing ccfiles/home.xml.  The other menu functions and so on are generally modified using the admin functions of the site.

Fourstones at 23:02, 30 August 2006

2006-08-30T23:02:29Z

← Older revision		Revision as of 23:02, 30 August 2006
Line 33:		Line 33:
	=== Simple ===		=== Simple ===

	The easiest way to get going is to ~~get~~ a hosting server (like ~~dreamhosters~~.com ~~etc~~.~~) to provide you with web space~~. ~~Most hosting services~~ provide ~~you with a web~~ interface for ~~creating~~ a database, ~~doing file uploads~~ and ~~setting permissions for files and directories~~.		The easiest way to get going is to start with a web hosting server. Common web hosting services like [http://www.dreamhost.com/ Dreamhost] and [http://www.websitesource.com WebsiteSource] provide an administration interface for setting up a mysql database. Hosting services also provide some FTP or SFTP mechanism to upload the ccHost installation files as well. 99% of all services provide support for PHP as well. If you have questions about support in this area, check the server requirements below and with your hosting service.

	#Unzip the ccHost ZIP archive on your local system and copy the files to your server retaining the the directory structure.		#Unzip the ccHost ZIP archive on your local system and copy the files to your server retaining the the directory structure.
	#Browse to http://where_you_installed/ccadmin and follow all the instructions from then on.		#Browse to '''<nowiki>http://where_you_installed/ccadmin</nowiki>''' and follow all the instructions from then on.


Line 98:		Line 98:
	For example (on Linux):		For example (on Linux):

	##tar xzf getid3.tar.gz		<pre>
	##cp -a getid3/getid3 /var/www/localhost/htdocs/cchost/		tar xzf getid3.tar.gz
			cp -a getid3/getid3 /var/www/localhost/htdocs/cchost/
			</pre>

	The ccHost installer will 'find' your getID3 installation if it's roughly in the same area of the server, however it is ''not'' required that your getID3 be visible on the web and in fact, it's probably more secure if it isn't.		The ccHost installer will 'find' your getID3 installation if it's roughly in the same area of the server, however it is ''not'' required that your getID3 be visible on the web and in fact, it's probably more secure if it isn't.
Line 105:		Line 107:
	==== ccHost Terminal Installtion ====		==== ccHost Terminal Installtion ====

	#Unzip the ccHost ZIP or tar. bz2 archive on your local system and copy the files (retaining the directory structure) to your web-server directory. ~~Change~~ the group and permissions of the files so they may be written by the web server (e.g., in the following lines, the web-server account is "apache").		*Unzip the ccHost ZIP or tar. bz2 archive on your local system and copy the files (retaining the directory structure) to your web-server directory.
	#*For example:		* On Linux change the group and permissions of the files so they may be written by the web server (e.g., in the following lines, the web-server account is "apache").
	~~#*#~~cp -a cchost-1.0.3 /var/www/localhost/htdocs/cchost		For example:
	~~#*#~~chgrp -R apache /var/www/localhost/htdocs/cchost		<pre>
	~~#*#~~chmod g+w /var/www/localhost/htdocs/cchost/		cp -a cchost-1.0.3 /var/www/localhost/htdocs/cchost
	~~#*#~~chmod -R g+w /var/www/localhost/htdocs/cchost/cclib/phptal/phptal_cache/		chgrp -R apache /var/www/localhost/htdocs/cchost
	#Create a new database for ccHost (e.g., named "cchost") and create an administrative user to access it (e.g., "cchostadmin"). For example:		chmod g+w /var/www/localhost/htdocs/cchost/
	##mysql -p -u root		chmod -R g+w /var/www/localhost/htdocs/cchost/cclib/phptal/phptal_cache/
	##mysql> CREATE DATABASE cchost;		</pre>
	##mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE ON cchost.* TO 'cchostadmin'@'localhost' IDENTIFIED BY 'YOUR_PASSWORD_HERE';		*Create a new database for ccHost (e.g., named "cchost") and create an administrative user to access it (e.g., "cchostadmin"). For example:
	##*Make sure to change 'YOUR_PASSWORD_HERE' (and maybe 'cchostadmin') to something unique to your site.		<pre>
	##*Many systems provide phpMyAdmin to take care of these tasks.		mysql -p -u root
	##Create directory /var/log/cchost or other location to store log files. Must be writable by the web-server account (e.g., "apache"). For example:		mysql> CREATE DATABASE cchost;
	~~###~~mkdir /var/log/cchost		mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE ON cchost.* TO 'cchostadmin'@'localhost' IDENTIFIED BY 'YOUR_PASSWORD_HERE';
	~~###~~chown apache:apache /var/log/cchost		</pre>
			Make sure to change 'YOUR_PASSWORD_HERE' (and maybe 'cchostadmin') to something unique to your site.
			(Many systems provide '''phpMyAdmin''' to take care of these tasks.
			*Create directory /var/log/cchost or other location to store log files. Must be writable by the web-server account (e.g., "apache"). For example:
			<pre>
			mkdir /var/log/cchost
			chown apache:apache /var/log/cchost
			</pre>

	==== Finish with Install ====		==== Finish with Install ====
Line 178:		Line 187:
	Windows users with their installation disks may install optionally the Windows IIS Web Server. This option has been tested. However, there might still be issues with it, and if so, please file a bug.		Windows users with their installation disks may install optionally the Windows IIS Web Server. This option has been tested. However, there might still be issues with it, and if so, please file a bug.

	=== Mac OS X ====		==== Mac OS X ====

	''NOTE: This setup is similar to Linux.''		''NOTE: This setup is similar to Linux.''
Line 229:		Line 238:
	* [https://sourceforge.net/tracker/?group_id=80503&atid=559969 Request Features]		* [https://sourceforge.net/tracker/?group_id=80503&atid=559969 Request Features]
	* [[HOWTO Patch\|Submit Patches]]		* [[HOWTO Patch\|Submit Patches]]

	~~=== Web Hosting Services ===~~
	Common web hosting services like [http://www.dreamhost.com/ Dreamhost] and [http://www.websitesource.com WebsiteSource] provide an administration interface from which to setup a mysql database. Hosting services also provide some FTP or SFTP mechanism to upload the cchost installation files as well. 99% of all services provide support for PHP as well. If you have questions about support in this area, check the requirements below and with your hosting service.


	=== Windows ===		=== Windows ===

Fourstones at 22:47, 30 August 2006

2006-08-30T22:47:34Z

@@ Line 45: / Line 45: @@
 ==== General Requirements ====
 * A web server.
 * PHP 4/5 (PHP 5 requires ccHost 3.0 or above.)
 * MySQL 4/5 (MySQL 5 requires ccHost 3.0 or above.)
@@ Line 112: / Line 111: @@
 #*#chmod g+w /var/www/localhost/htdocs/cchost/
 #*#chmod -R g+w /var/www/localhost/htdocs/cchost/cclib/phptal/phptal_cache/
 #Create a new database for ccHost (e.g., named "cchost") and create an administrative user to access it (e.g., "cchostadmin").  For example:
 ##mysql -p -u root
@@ Line 126: / Line 124: @@
 Browse to <nowiki>http://where_you_installed_cchost/ccadmin</nowiki>
-##*Everything else you need to know will be on the screen from that point on, including suggested php.ini and .htaccess settings, access permissions requirements, etc.
 ==== More .htaccess file settings ====
@@ Line 155: / Line 154: @@
 </Limit>
 </pre>
@@ Line 170: / Line 204: @@
-=== People ==
+=== People ===
 * [[User:Victor Stone|Victor Stone]]
 * [[User:Jon Phillips|Jon Phillips]]
-=== Research ==
+=== Research ===
 * Possible solution for forms and other enhancements - http://www.gamingheadlines.co.uk/wod/formstyle/
@@ Line 206: / Line 240: @@
 Follow the instructions for installation of XAMPP to know where to put the uncompressed ccHost package to properly work with your local setup.
 ===Upgrade existing ccHost installations===

Fourstones at 22:21, 30 August 2006

2006-08-30T22:21:22Z

New page

[[Category:ccHost]]
[[Category:Developer]]
[[Category:Software]]
[[Category:Technology]]
[[Category:ccMixter]]

= Download =

=== Current Stable Release ===

Latest stable builds of ccHost are available in several common archiving formats (.zip, .gzip, etc.)

[http://sourceforge.net/project/showfiles.php?group_id=80503&package_id=156675 ccHost download page]

To install: Unpack the contents of the archive on your local machine and see the README.

=== Experimental Thrice-Daily Builds ===

Currently, ccHost packages are being made three-times a day and are available here:

[http://mirrors.creativecommons.org/cchost/packages/ ccHost 3x daily builds]

Our experience has been very good however these are minimally tested builds so ''download, install and use these packages at your own risk.''

Only 30 days worth of builds are saved currently.

= Install =

As stated above, all the information you need for installation is in the distribution package you downloaded. Treat these notes as addendums, hints and other possibly useful information.

=== Simple ===

The easiest way to get going is to get a hosting server (like dreamhosters.com etc.) to provide you with web space. Most hosting services provide you with a web interface for creating a database, doing file uploads and setting permissions for files and directories.

#Unzip the ccHost ZIP archive on your local system and copy the files to your server retaining the the directory structure.
#Browse to http://where_you_installed/ccadmin and follow all the instructions from then on.

=== Advanced ===

If you have basic knowledge of using FTP and you are comfortable at a terminal command line you can use these steps to before, during and after installation. Many of these can be filed under "you'll be glad you did" by the time you get to the browser-based installation steps later on.

==== General Requirements ====
* A web server.
** ccHost on Apache (2.0.49 up to at least apache-2.0.55-r1) on Linux, Windows XP and OSX has been tested and verified. It has been rumored that ccHost will also run on IIS.
* PHP 4/5 (PHP 5 requires ccHost 3.0 or above.)
* MySQL 4/5 (MySQL 5 requires ccHost 3.0 or above.)
* Tested on: Firefox 1.0+ Mac/PC/Linux, IE 6+ PC, Safari Mac
* Cookies enabled in one's browser.
* Most skins (that people would want to use) require Javascript enabled

==== Enabling 'Pretty URLs' ====

All ccHost commands and URLs based on query strings:

<nowiki>http://your_install_root/index.php?ccm=/media/people/victor</nowiki>

That same URL can be made 'pretty' on Apache installations so that it looks more like:

<nowiki>http://your_install_root/media/people/victor</nowiki>

Here is the block of code in your .htaccess file setting the rewrite rules to get pretty urls:

<pre>
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ /index.php?ccm=/$1 [L,QSA]
</pre>

If you installed to a directory below the site's root make sure to specify that in the RewriteBase directive.

For perfomance reasons (and if you are given access) you should put those directives into an Apache virtual host block in the .conf file for your server:

<pre>
<VirtualHost *:80>
ServerName ccmixter.localhost
ServerPath /ccmixter
#DocumentRoot /var/www/localhost/htdocs/cchost
DocumentRoot /home/rejon/Documents/freelance/creativecommons/src/ccmixter

<Directory "/home/rejon/Documents/freelance/creativecommons/src/ccmixter">
RewriteEngine On
RewriteBase /
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^(.*)$ /index.php?ccm=/$1 [L,QSA]
</Directory>
</VirtualHost>
</pre>

==== getID3 ====

ccHost depends on the getID3 library for verifying uploads. Install getID3 (at least 1.7.3) here: http://www.getid3.org/#download before you install ccHost. (It's a simple download-unpack operation.)

For example (on Linux):

##tar xzf getid3.tar.gz
##cp -a getid3/getid3 /var/www/localhost/htdocs/cchost/

The ccHost installer will 'find' your getID3 installation if it's roughly in the same area of the server, however it is ''not'' required that your getID3 be visible on the web and in fact, it's probably more secure if it isn't.

==== ccHost Terminal Installtion ====

#Unzip the ccHost ZIP or tar. bz2 archive on your local system and copy the files (retaining the directory structure) to your web-server directory. Change the group and permissions of the files so they may be written by the web server (e.g., in the following lines, the web-server account is "apache").
#*For example:
#*#cp -a cchost-1.0.3 /var/www/localhost/htdocs/cchost
#*#chgrp -R apache /var/www/localhost/htdocs/cchost
#*#chmod g+w /var/www/localhost/htdocs/cchost/
#*#chmod -R g+w /var/www/localhost/htdocs/cchost/cclib/phptal/phptal_cache/

#Create a new database for ccHost (e.g., named "cchost") and create an administrative user to access it (e.g., "cchostadmin"). For example:
##mysql -p -u root
##mysql> CREATE DATABASE cchost;
##mysql> GRANT SELECT,INSERT,UPDATE,DELETE,CREATE ON cchost.* TO 'cchostadmin'@'localhost' IDENTIFIED BY 'YOUR_PASSWORD_HERE';
##*Make sure to change 'YOUR_PASSWORD_HERE' (and maybe 'cchostadmin') to something unique to your site.
##*Many systems provide phpMyAdmin to take care of these tasks.
##Create directory /var/log/cchost or other location to store log files. Must be writable by the web-server account (e.g., "apache"). For example:
###mkdir /var/log/cchost
###chown apache:apache /var/log/cchost

==== Finish with Install ====

Browse to <nowiki>http://where_you_installed_cchost/ccadmin</nowiki>
##*Everything else you need to know will be on the screen from that point on, including suggested php.ini and .htaccess settings, access permissions requirements, etc.

==== More .htaccess file settings ====

Put the following into a file named '.htaccess' in your root directory of a ccHost setup if you can't set your php.ini settings for your hosting setup. These settings should work, but should be tested first. They correct many memory problems people have with ccHost.

<pre>
# php configs http://www.php.net/manual/en/ini.core.php#ini.memory-limit
# http://www.php.net/manual/en/ini.php#ini.list

php_value max_input_time 200
php_value max_execution_time 200
php_value memory_limit 20M
php_value upload_max_filesize 20M
# next line fixes noncompliant & used in php
php_value arg_separator.output &
php_flag session.use_trans_sid off
# turns off annoying autoquotes
php_flag magic_quotes_gpc off

Options +MultiViews

# Stop morons that are hammer your site
# Open Clip Art Library had someone DDoS'ing our site
<Limit GET>
order deny,allow
deny from 59.116.0.0/16
</Limit>
</pre>

= Development =

=== Source and Code Documentation ===

* [http://svn.sourceforge.net/viewcvs.cgi/cctools/cchost/trunk/ Browsable Anonymous SVN]
* [http://mirrors.creativecommons.org/cchost/docs/ Online Documentation] including developer's guide.

* [http://sourceforge.net/svn/?group_id=80503 HOWTO use this project's Subversion (SVN)] - use module 'cchost'
* [http://wiki.creativecommons.org/Source_Repository_Information Help with cctools SVN setup]

=== People ==

* [[User:Victor Stone|Victor Stone]]
* [[User:Jon Phillips|Jon Phillips]]

=== Research ==

* Possible solution for forms and other enhancements - http://www.gamingheadlines.co.uk/wod/formstyle/

=== Communication ===

* Chat: #cc on irc.freenode.net
* Wiki: This page (http://wiki.creativecommons.org/wiki/CcHost)
* Mailing List: https://lists.sourceforge.net/mailman/listinfo/cctools-cchost
** [http://sourceforge.net/mailarchive/forum.php?forum=cctools-cchost Archive]

=== Bugs, Patches and Feature Requests ===

''Make sure to use the 'ccHost' category when filing bugs. Also, please use a real email so that we can followup on any bugs posted. Be descriptive when posting and commenting on bugs (every bit counts).''

* [https://sourceforge.net/tracker/?atid=559966&group_id=80503&func=browse Report Bugs]
* [https://sourceforge.net/tracker/?group_id=80503&atid=559969 Request Features]
* [[HOWTO Patch|Submit Patches]]

=== Web Hosting Services ===
Common web hosting services like [http://www.dreamhost.com/ Dreamhost] and [http://www.websitesource.com WebsiteSource] provide an administration interface from which to setup a mysql database. Hosting services also provide some FTP or SFTP mechanism to upload the cchost installation files as well. 99% of all services provide support for PHP as well. If you have questions about support in this area, check the requirements below and with your hosting service.

=== Windows ===

==== XAMPP ====
It is recommended to download [http://www.apachefriends.org/en/xampp.html XAMPP] for Windows, which provides an easy install of Apache web server, MySQL database server, and PHP and perl programming languages. This is the easiest way to get up and running, as this system replicates the standard Open Source (and Linux) setup of a time-tested server, [http://www.apache.org/ Apache], along with the required MySQL database and PHP programming language, all necessary to use ccHost.

Follow the instructions for installation of XAMPP to know where to put the uncompressed ccHost package to properly work with your local setup.

==== Windows IIS Server ====

Windows users with their installation disks may install optionally the Windows IIS Web Server. This option has been tested. However, there might still be issues with it, and if so, please file a bug.

=== Mac OS X ===

''NOTE: This setup is similar to Linux.''

==== Tested Setups ====

* OS X 10.4.6
* default OS X MySQL build, 4.0.26
* GetID3 1.7.7
* default Apache/PHP

=== Linux ===

Primary development is done on up-to-date Linux development systems using apache, mysql, and php. One should be able to easily install mysql, php, and apache (if they are not already available) through their distributions packaging system.

===Upgrade existing ccHost installations===
#Log in as administrator
#Copy this installation over your current installation.
#Browse to: <nowiki>http://where_you_installed/?update=1</nowiki>

Note to 1.x ccHost installations: phpBB2 is no longer used for reviews. There is a script for importing existing phpBB2 format reviews into the new native reviewing system. Contact fourstones@users.sourceforge.net for details.

* The text for the front page can be changed by editing ccfiles/home.xml. The other menu functions and so on are generally modified using the admin functions of the site.

[[Category:CcHost]]
[[Category:Developer]]
[[Category:opensource]]
[[Category:Technology]]

= Zeitgeist =

=== Goal ===
The goal of this project is to spread media content that is licensed under
Creative Commons throughout the web in much the same way that weblogs spread
CC licensed text.

=== Short Description ===

"Web-based System Supporting Remixing and Collaboration on Media"

=== Slightly Longer Description ===
'''ccHost''' is an open source ([http://creativecommons.org/licenses/GPL/2.0/ GPL] licensed) project that provides web-based infrastructure to support collaboration, sharing, and storage of multi-media using the Creative Commons licenses and metadata. It is the codebase used by [http://ccmixter.org ccMixter] and [[#Usage Examples|other sites]].

Besides its focus on sharing content, ccHost differniates itself from other multi-media hosting programs by emphasizing the '''reuse''' (a.k.a. remixing) of content between artists, not only between artists on any given installation of ccHost, but between all installations across the web and any web site that implements the Creative Commons [http://ccmixter.org/media/viewfile/pool_api_doc.xml Sample Pool API], including non-ccHost sites such as the [http://freesound.iua.upf.edu/ freesound project].

==== [[CcHost Release Notes|Release Notes]] ====

==== [[CcHost Press Releases|Press Releases]] ====

==== Sound Bites ===

''Please add your own sound bite...''

==== [[ccHost Screenshots|Screenshots]] ====

* "ccHost enables you to '''run your own flickr or youtube while having an infrastructure for legally sharing audio, video, text, and other media.''" [[User:Jon Phillips|Jon Phillips]] 22:50, 25 August 2006 (UTC)

=== Usage Examples ===

*[http://ccmixter.org ccMixter] - Primary usage of ccHost is the Creative Commons remix site, ccMixter.
*[http://www.opensourcecinema.com/cchost Open Source Cinema]
*[http://www.matrix-rayne.com Matrix Rayne Online]
*[http://remix.machinehasnoagenda.com/ remix.linux]
*[http://www.ccmixter.co.za/ ccmixter South Africa]
*[http://fourstones.net fourstones.net] Victor's personal website
*[http://www.openclipart.org/cchost/ Open Clip Art Library ccHost in testing]
*[http://www.esolpc.com/teacherhost/ TeacherHost] - for Instructors to share instructional materials.
*http://adrenalinicsound.com/music/
* http://creativecommons.org.tw/formoz
* '''Please add your installation here.'''

= Redistribution =
==== HOWTO Tag a Release ====

Really, each major release needs to be tagged, but this 2.0.1 is the first SVN release, and we did it post CVS -> SVN migration. In the future, this is the proper way to tag and branch.

<pre>
svn copy https://svn.sourceforge.net/svnroot/cctools/cchost/trunk \
https://svn.sourceforge.net/svnroot/cctools/cchost/tags/2_0_1 \
-m "Tagging 2.0.1 bugfix release"
</pre>

[http://svnbook.red-bean.com/nightly/en/svn.branchmerge.using.html Here is more about SVN merging/branching].

=== Packaging ===

==== Sign Package ====

You should do this for all packages (RPM, tar.gz, zip, tar.bz2, etc)
<pre>
gpg --detach-sign --armor cchost-VERSION.tar.gz
</pre>

==== Verify Package ====
<pre>
gpg --verify cchost-VERSION.tar.gz.asc
</pre>