Line 1: |
Line 1: |
− | == Scuttle for SME Server == | + | {{Warning box|The Scuttle project has abandoned. This how-to no longer applies. Please find an alternative and report back. If you still want to try this how-to, you are on your own including many security risks.}} |
| + | == Scuttle == |
| + | {{Level|medium}} |
| + | |
| + | {{Warning box|The information on this page was for SME Server 7 only!}} |
| | | |
| === Maintainer === | | === Maintainer === |
− | [http://www.dungog.net Dungog] (Software)
| + | http://www.dungog.net |
| | | |
| === Description === | | === Description === |
| + | http://scuttle.org |
| + | |
| Scuttle is a web-based social bookmarks manager that enables you to: | | Scuttle is a web-based social bookmarks manager that enables you to: |
| *Store all your favourite links in one place, accessible from anywhere. | | *Store all your favourite links in one place, accessible from anywhere. |
| *Share your bookmarks with everyone, with friends or just keep them private. | | *Share your bookmarks with everyone, with friends or just keep them private. |
| *Tag your bookmarks with as many labels, instead of wrestling with folders. | | *Tag your bookmarks with as many labels, instead of wrestling with folders. |
− |
| |
− | Orginates from [http://www.dungog.net/sme/webapp.php#scuttle Dungog HowTo] and some input from the forums.
| |
| | | |
| === Installation === | | === Installation === |
− | This contrib can be found in the [http://www.dungog.net Dungog] repository. | + | This contrib can be found in the [http://mirror.contribs.org/smeserver/releases/7/smecontribs/i386/repodata/index.html smecontribs] repository. |
| | | |
− | 1. Log in (with username root) to the SMEserver console.
| + | Download and install scuttle and smeserver-scuttle |
| + | yum install --enablerepo=smecontribs smeserver-scuttle |
| | | |
− | 2. If you have already enabled Dungog repo, skip down.
| + | No need to reboot. |
| | | |
− | 3. {{Repository|Dungog}}
| + | Create database structure |
− | | |
− | 4. Check correct input with
| |
− | db yum_repositories show dungog
| |
− | It should contain the lines in step 3. If you get nothing in return, go back to 3.
| |
− | | |
− | 5. Download and install scuttle and smeserver-scuttle
| |
− | yum install --enablerepo=dungog smeserver-scuttle
| |
− | I don't install this from smedev because it may contain an older version.
| |
− | You will get a y/n-question, answer y if it looks fine.
| |
− | | |
− | Note: signal-event post-upgrade & signal-event reboot is not necessary for Scuttle install
| |
− | | |
− | 6. Create database structure
| |
| /usr/bin/mysql scuttle < /opt/scuttle/tables.sql | | /usr/bin/mysql scuttle < /opt/scuttle/tables.sql |
| | | |
− | 7. Copy and rename the config file
| + | Copy and rename the config file |
| cp /opt/scuttle/config.inc.php.example /opt/scuttle/config.inc.php | | cp /opt/scuttle/config.inc.php.example /opt/scuttle/config.inc.php |
| | | |
− | 8. Find scuttle mysql password (DbPassword=) with
| + | Find scuttle mysql password (DbPassword=) with |
| config show scuttle | | config show scuttle |
| Copy the string, it should be similar to this: 2zvEiYibIewQOsQ07KAtObnh5FcOhUhaq+dtSAdXBjuOBsbSoPt5Bty8PEPfjhfHmL0wejMAmUMO | | Copy the string, it should be similar to this: 2zvEiYibIewQOsQ07KAtObnh5FcOhUhaq+dtSAdXBjuOBsbSoPt5Bty8PEPfjhfHmL0wejMAmUMO |
| | | |
− | 9. Open config file with text editor Pico (^-sign means ctrl-button)
| + | and add the password and edit these line in the config file |
− | pico -w /opt/scuttle/config.inc.php | + | nano -w /opt/scuttle/config.inc.php |
− | Edit the following lines with these values (special for dbpass):
| + | |
− | $dbtype = 'mysql'; | + | $dbtype = 'mysql'; <---------- |
− | $dbhost = 'localhost'; | + | $dbhost = 'localhost'; <---------- |
| $dbport = '3306'; | | $dbport = '3306'; |
− | $dbuser = 'scuttle'; | + | $dbuser = 'scuttle'; <---------- |
− | $dbpass = 'paste copied password here'; | + | $dbpass = 'your-new-password'; <---------- |
| $dbname = 'scuttle'; | | $dbname = 'scuttle'; |
− | Exit Pico, save to file, choose config.inc.php
| |
| | | |
− | 10. Open http://yourserver/scuttle/ and register a user.
| + | Open http://yourserver/scuttle/ and register a user. |
| | | |
− | Step 13-14 are optional, not necessary for Scuttle to function.
| + | === Uninstallation === |
| + | To remove the package from your server issue the following command on the SME Server shell: |
| + | rpm -e scuttle smeserver-scuttle |
| | | |
− | 11. [http://scuttle.org/wiki/firefox_extension Firefox plugin]
| + | To remove mysql database and user, both are scuttle, see [[MySQL#Remove a database]] and [[MySQL#Remove a user]]. There is no need to reboot. |
| | | |
− | 12. Restrict usage with PublicAccess db, (global-pw are default):
| + | === Options === |
− | config setprop scuttle PublicAccess global-pw
| |
− | Fore more options: [http://www.dungog.net/sme/webapp.php#scuttle Dungog HowTo]
| |
− | Scroll to: "to limit access to the web app."
| |
| | | |
− | ==== Check installed version ====
| + | * [http://scuttle.org/wiki/firefox_extension Firefox 2 plugin] |
− | yum info installed *scuttle*
| + | * [http://www.kai-mai.com/node/11 Firefox 3 plugin] |
− | That will show both packages.
| |
| | | |
− | ==== Uninstall ====
| + | * Restrict usage with PublicAccess db, (global-pw are default): |
− | yum remove scuttle | + | config setprop scuttle PublicAccess global-pw |
− | This will also remove smeserver-scuttle.
| |
| | | |
− | === Additional information === | + | === Bugs === |
− | | + | Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-scuttle component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-scuttle|title=this link}}. |
− | [http://scuttle.org/ Scuttle website] and [http://www.scuttle.org/wiki/ Wiki] (wiki page loads slowly).
| |
− | | |
− | [http://forums.contribs.org/index.php?topic=35530.0 Announcement: SME Server 7.x Contribs]
| |
− | | |
− | If you connect to the SMEserver console by Putty ssh-client (or similar) you can copy and paste the commands (very convenient).
| |
− | | |
− | Please note that this was written in april 2007, if the software change then this howto may be outdated.
| |
| | | |
− | Please do edit if you find errors or have improvements, but make sure that it works!
| + | === Patches === |
| + | ====htpps==== |
| + | http://sourceforge.net/tracker/?group_id=134378&atid=729862 |
| | | |
− | Good luck [http://wiki.contribs.org/User:Per /Per]
| + | a simple one is to allow https usage (https fix) |
| + | nano -w /opt/scuttle/header.inc.php |
| + | |
| + | - $root = 'http://'. $_SERVER['HTTP_HOST'] . $root; |
| + | + |
| + | + $protocol = ($_SERVER["HTTPS"] == 'on') ? 'https://' : 'http://'; |
| + | + $root = $protocol . $_SERVER['HTTP_HOST'] . $root; |
| | | |
− | === Bugs === | + | ====404 error==== |
− | Please raise bugs under the SME-Contribs section in {{BugzillaFileBug|product=|component=|title=bugzilla}}and select the smeserver-scuttle component or use {{BugzillaFileBug|product=SME%20Contribs|component=smeserver-scuttle|title=this link}}.
| + | In some cases the following occurs, this change is not usually needed |
| | | |
− | === Tested software versions ===
| + | Use 'search all bookmarks' to return at least 3 pages of results. |
− | Host: SMEserver v7.1 with update 3 (7.1.3)
| |
| | | |
− | Installed: smeserver-scuttle.noarch 0:0.9-2
| + | Then click the 'Next' button. http://servername/scuttle/search.php/all//?page=2 |
| | | |
− | Dependency Installed: scuttle.noarch 0:0.7.2-1
| + | if you click it again on page 2 and get a 404 error apply the following change |
| | | |
− | ----
| + | Fix this by editing /opt/scuttle/templates/bookmarks.tpl.php |
| + | At line 151, ABOVE this line: (edited to remove html code) |
| | | |
| + | echo class="paging $bfirst .span /span. $bprev .span / |
| + | span. $bnext .span/ span>'. $blast .span> / span. |
| + | sprintf(T_('Page %d of %d'), $page, $totalpages) .'/p'; |
| + | |
| + | Add this: |
| + | |
| + | // page url bug on smeserver-scuttle contrib quick fix by MB 2010-12-01 |
| + | // remove double slashes |
| + | $bfirst = str_replace ('//', '/', $bfirst); |
| + | $bprev = str_replace ('//', '/', $bprev); |
| + | $bnext = str_replace ('//', '/', $bnext); |
| + | $blast = str_replace ('//', '/', $blast); |
| + | // restore protocol slashes |
| + | $bfirst = str_replace (':/', '://', $bfirst); |
| + | $bprev = str_replace (':/', '://', $bprev); |
| + | $bnext = str_replace (':/', '://', $bnext); |
| + | $blast = str_replace (':/', '://', $blast); |
| + | // end of fix |
| + | |
| [[Category: Contrib]] | | [[Category: Contrib]] |
| [[Category: Dungog]] | | [[Category: Dungog]] |
| + | [[Category: Social Media Apps]] |
| + | [[Category: Webapps]] |