← Back to branch summary

~ubuntu-branches/ubuntu/lucid/ampache/lucid

« back to all changes in this revision

Viewing changes to debian/README.Debian

  • Committer: Bazaar Package Importer
  • Author(s): Charlie Smotherman
  • Date: 2007-08-01 11:52:03 UTC
  • Revision ID: james.westby@ubuntu.com-20070801115203-h3t2jisp4hrmzfvf
Tags: 3.3.3.5-dfsg-1
http://bugs.debian.org/407337
Initial release (Closes: #407337)  

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/README.Debian
1
1
ampache for Debian
2
2
------------------
3
 
 
4
 
Ampache requires mysql-server to operate.  Mysql-server was not installed as part of the ampache install due to the fact that some users may already have a mysql-server setup and running and upgrading to a newer version of MySQL server may render their databases useless (which is really really bad) .  For those who do not have a mysql-server installed it is very easy to do.  I would recommend using phpmyadmin to setup your mysql-server.  To install mysql-server and phpmyadmin all you have to to is:
5
 
 
6
 
apt-get install mysql-server-5.0 phpmyadmin
7
 
 
8
 
Once they are installed create a user account on your mysql server that has root priviliges (you will need this account to configure ampache).  For this I use phpmyadmin. Point you browser to 
9
 
 
10
 
http://localhost/phpmyadmin or
11
 
http://your.ip.address.com/phpmyadmin.
12
 
 
13
 
Log in with username root and password blank.  Once you loging scoll down to the section that says "privileges" and click on it.  Now scroll down to the section that says "add new user" click on it and fill in the user information, then scroll down and click on "check all" under Global privileges scroll down to the bottom of the page an click go. You user account has been created.  Now point your browser to
14
 
 
15
 
http://localhost/ampache or 
16
 
http://your.ip.address.com/ampache
17
 
 
18
 
The web interface should come up.  Follow the instructions on the screen to configure ampache.  
19
 
 
20
 
For those that already have a mysql-server with a user account that has root privileges all you need to do is point your brower to 
21
 
 
22
 
http://localhost/ampache or
23
 
http://your.ip.address.com/ampache
24
 
 
25
 
and follow the configuration instructions.
26
 
 
27
 
For installation question or questions on how to enable additonal features in ampache please visit the forums and the wiki
28
 
 
29
 
http://www.ampache.org/forums/
30
 
https://ampache.bountysource.com/wiki
 
3
IMPORTANT:
 
4
 
 
5
Ampache **REQUIRES** MySQL server to operate.  MySQL server is not installed 
 
6
with Ampache due to the fact that if users are using an older version of 
 
7
MySQL server upgrading to mysql-server-5.0 may render their databases corrupt
 
8
and possible useless.  So please upgrade your mysql server with **CAUTION**.
 
9
For those who do not have mysql-server-5.0 installed it is very easy to install.
 
10
In the command line type:
 
11
 
 
12
        Debian:  apt-get install mysql-server-5.0 (as root)
 
13
        Ubuntu:  sudo apt-get install mysql-server-5.0
 
14
 
 
15
WARNING
 
16
 
 
17
Please insure that older versions of Apache-1.x or later are removed, before
 
18
installing ampache or you will experience installation problems.
 
19
 
 
20
GETTING STARTED WITH AMPACHE
 
21
 
 
22
SUMMARY
 
23
        1.  MySQL Server install
 
24
        2.  Phpmyadmin or command line setup a MySQL server account with root
 
25
            privileges
 
26
        3.  Step 1 Web Interface
 
27
        4.  Step 2 Web Interface
 
28
        5.  Step 3 Web Interface
 
29
        6.  Sign in and start building music catalogs
 
30
 
 
31
1.  To install mysql-server-5.0 follow instruction above.  If you already have
 
32
mysql-server installed go to step 2.
 
33
 
 
34
2.  To setup Ampache you must have a user account on the mysql-server with root 
 
35
privileges.  You may do this by either the command line or phpmyadmin.  I prefer
 
36
phpmyadmin and that is what will be explained here.  To install phpmyadmin type
 
37
in the command line:
 
38
 
 
39
        Debian: apt-get install phpmyadmin (as root)
 
40
        Ubuntu: sudo apt-get install phpmyadmin
 
41
 
 
42
To setup your mysql root account, sign into phpmyadmin by pointing your browser
 
43
to http://localhost/phpmyadmin or http://your.ip.address/phpmyadmin.
 
44
 
 
45
username = root
 
46
password =
 
47
 
 
48
***Leave the password blank this is the default sign in for phpmyadmin.****
 
49
 
 
50
This takes you to the main page scroll down to where it says "Privileges" and
 
51
click on it.  Now scroll down and click on "Add a new User" and click on it.
 
52
Now fill in
 
53
 
 
54
User name = what ever you want
 
55
Host      = Any host
 
56
Password  = what ever you want
 
57
Re-type   = retype your password again
 
58
 
 
59
Now Scroll down a little and click on "Check All" for Global privileges.  Now
 
60
scroll down to the bottom of the page and click the "Go" button.  Now sign out.
 
61
 
 
62
SECURITY WARNING:
 
63
 
 
64
After you have Ampache setup and running it would be a very good idea if you
 
65
changed the root password.  It is widely known the the default sign in for
 
66
phpmyadmin is
 
67
 
 
68
username = root
 
69
password = <blank>
 
70
 
 
71
So please change this password, as it is a potential security hole.
 
72
 
 
73
3.  Now point your browser to http://localhost/ampache or
 
74
http://what.ever.your.ip.address.com/ampache.This will bring you to Ampache's
 
75
Web Installation Interface (step 1)
 
76
 
 
77
Desired Database Name = ampache
 
78
MySQL Hostname  = localhost
 
79
MySQL Administrative Username = root or the user name you setup with phpmyadmin
 
80
MySQL Administrative Password = leave blank if you use root, or use the password
 
81
                                you created with phpmyadmin
 
82
Create Database User For New Database = set check mark
 
83
Ampache Database Username = ampache
 
84
Ampache Database User Password = set this to a password you like
 
85
 
 
86
Click on Insert Database.
 
87
 
 
88
4.  This will take you to Ampache's Web Installation Interface (step 2)
 
89
 
 
90
Web Path       = /ampache
 
91
Desired Database Name = ampache (default)
 
92
MySQL Hostname = localhost (default)
 
93
MySQL Username = this is the username you setup with phpmyadmin
 
94
                                 **root will not work**
 
95
MySQL Password = this is the password you setup with phpmyadmin
 
96
                                 **blank will not work**
 
97
 
 
98
Click on Write Config.
 
99
 
 
100
Ampache will prompt you to download a file called "ampache.cfg.php".  Download 
 
101
it to your favorite location.  Now take "ampache.cfg.php and copy/move it to
 
102
/etc/ampache.
 
103
 
 
104
Now click on check for config, and everything should turn green.  Click on next
 
105
 
 
106
5.  This will take you to Ampache's Web Installation Interface (step 3)
 
107
 
 
108
Enter a password, you will be using this to initially sign into ampache.
 
109
You can change the admin username and password after the install is complete
 
110
through the preferences tab
 
111
 
 
112
Click next this will take you to Ampache's log in screen.
 
113
 
 
114
Enter Admin and the password you entered in the above step.
 
115
 
 
116
6.  You are now ready to start adding music and building you music catalogs.
 
117
 
 
118
If you have never setup Ampache Catalogs please take a look at this wiki page
 
119
 
 
120
http://ampache.bountysource.com/wiki/Catalog_Builds
31
121
 
32
122
 
33
123
 -- Charlie Smotherman <cjsmo@cableone.net>  Wed,  1 Aug 2007 11:52:03 -0500