TweetFollow Us on Twitter

Wiki Services in Leopard Server Overview

Volume Number: 24 (2008)
Issue Number: 07
Column Tag: Wiki

Wiki Services in Leopard Server Overview

A "fast" introduction to wiki and blog services in OS X Server for the SysAdmin

by Ben Greisler

Wiki Wiki!

"Quick! Quick!" That is the rough translation of "wiki wiki" from the Hawaiian language, and we can thank Ward Cunningham for its inclusion in our daily lives.

By providing a quick way for groups to collaborate, and individuals to speak out, wiki and blog technologies have grown in popularity very quickly, no pun intended. People have found their voice and companies have found an effective way to provide communications amongst their employees. Apple has fed this need by providing wiki and blog services in Mac OS X 10.5 Server. We will take a look at these services, discuss some features and considerations for deployment.

Wiki Planning and Setup

There are several prerequisites when setting up wiki and blog services on Leopard Server:

The first gotcha is that the machine hosting the service needs to have a local OD Master running on it. Note, though, that the machine can also be connected to another directory service, too.

You need to have a website set up to present your wiki info. Protect this site the same way you would any other site, such as VPN-only access, or by using SSL.

Plan your storage. As you may find your users storing a lot of data as attachments to their blogs and wikis, make sure you have an appropriate amount of storage set aside.

Each website can be enabled for wiki and blog services. In Server Admin, go to Web and then pick the site you wish to enable. From there you can chose which wiki and blog services you want to enable and if you want to restrict to certain individuals and groups. In Workgroup Manager, pick which Groups are to have wiki and blog services and enable them in the Basic tab.


Fig. 1: Setting up wiki and blog services in Server Admin


Fig. 2: Enabling wiki services for a group in Workgroup Manager

File Locations

Wiki content is stored in /Library/Collaboration (default) with the following specific locations:

Group's services:

/Library/Collaboration/Groups/groupname/

Wiki page components:

/Library/Collaboration/Groups/groupname/wiki/pagename.page/

Main text, html content:

/Library/Collaboration/Groups/groupname/wiki/pagename.page/page.html

Metadata:

/Library/Collaboration/Groups/groupname/wiki/pagename.page/page.plist

Version history database:

/Library/Collaboration/Groups/groupname/wiki/pagename.page/revisions.db

Graphics:

/Library/Collaboration/Groups/groupname/pagename.page/images/

Attachments:

/Library/Collaboration/Groups/groupname/pagename.page/attachments/

Wiki folder structure:

# ls -l
total 8
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   16:56   ArchivedGroups
drwxr-x—   3   _teamsserver   _teamsserver   102   Apr   5   16:59   Groups
drwxr-x—   2    _teamsserver   _teamsserver   68   Apr   5   16:56   Users
-rw-r–—   1   _teamsserver   _teamsserver   249   Apr   5   16:56   dataVersion.plist
# cd Groups/
# ls -l
total 0
drwxr-x—   10_teamsserver   _teamsserver   340   Apr   5   16:59   wikigroup
# cd wikigroup/
# ls -l
total 24
drwxr-x—   3   _teamsserver   _teamsserver   102   Apr   5   16:59   discussion
-rw-r–—   1   _teamsserver   _teamsserver   5120   Apr   5   16:59   index.db
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   16:59   mailinglist
-rw-r–—   1   _teamsserver   _teamsserver   432   Apr   5   16:59   metadata.plist
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   16:59   public
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   16:59   resources
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   16:59   weblog
drwxr-x—   3   _teamsserver   _teamsserver   102   Apr   5   16:59   wiki
# cd wiki/
# ls -l
total 0
drwxr-x—   7   _teamsserver   _teamsserver   238   Apr   5   16:59   welcome.page
# cd welcome.page/
# ls -l
total 32
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   16:59   attachments
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   16:59   images
-rw-r–—   1   _teamsserver   _teamsserver   427   Apr   5   16:59   page.html
-rw-r–—   1   _teamsserver   _teamsserver   730   Apr   5   16:59   page.plist
-rw-r–—   1   _teamsserver   _teamsserver   5120   Apr   5   16:59   revisions.db

Blog content is stored in /Library/Collaboration (default) with the following specific locations:

User's blog:

/Library/Collaboration/Users/(username)/

Blog folder structure:

# cd /Library/Collaboration/Users/
# ls -l
total 0
drwxr-x—   8   _teamsserver   _teamsserver   272   Apr   5   17:09   wikiuser1
# cd wikiuser1/
# ls -l
total 24
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   17:09   discussion
-rw-r–—   1   _teamsserver   _teamsserver   5120   Apr   5   17:09   index.db
-rw-r–—   1   _teamsserver   _teamsserver   479   Apr   5   17:10   metadata.plist
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   17:09   public
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   17:09   resources
drwxr-x—   2   _teamsserver   _teamsserver   68   Apr   5   17:09   weblog

Other files:

Note: These files may be overwritten during software updates and any modifications made in these directories might be nullified at that time.

Client side code:

/usr/share/collaboration/

Python code, help files, templates, etc:

/usr/share/wikid/

Wiki and Blog Security and Control

Being a web based technology, standard web security techniques can be used such as SSL. From the user control perspective you can control wiki access in the Web services list by placing the users and groups you want to allow. You can also use Service Access Control Lists (SACL's) from within Server Admin to determine which users and groups may or may not get access to blogs.

When enabling the group's access to web services in Workgroup Manger, you need to pick which website hosts the desired wiki, and then set the permissions for the group. There are pull-down menus for allowing who can edit the services and who can view then. The choices are:

Group members only: This will allow all users in the group access.

Some group members: Only group members with editing privileges can edit.

Authenticated users: Only users than can authenticate against the directory service.

Anyone: No authentication needed.


Fig. 3: Turn on SSL in Web services in Server Admin


Fig. 4: Setting up a Service Access Control List for blogs in Server Admin

Wiki Templates

Apple provides a set of themes and templates to provide a starting point for wikis and blogs. If you choose to modify a theme, make a copy of it and change the copy, not the original. Apple warns that the originals can be replaced or modified during a software update. It is also suggested to start with the wireframe template located at:

/Library/Application/Support/Apple/WikiServer/Themes/wireframe.wikitheme/


Fig. 5: Setting up the default template, attachment size and data store in Web services in Server Admin


Fig. 6: Default blog interface


Fig. 7: Default wiki interface

Storage Considerations

Blog and wiki entries can contain more than just text. You will find users placing pictures, video and audio into their posts. When you estimate your storage needs, also consider using some form of shared storage, such as Xsan2, if you will want some type of failover or redundant environment for hosting wiki and blog services.

Active Directory Integration Considerations

It is possible to use AD users with wiki and blogs, but due to the fact that the wiki server uses CRAM-MD5 authentication, and the AD plug-in for Open Directory doesn't, you need to allow clear text passwords for wikid. This would be the case if you have your wiki server bound to AD and running as an OD master. Keep in mind that to protect your users, you should be running SSL on the site hosting the wiki.

To enable clear text passwords for wikid, use "serveradmin" to run the following commands:

sudo serveradmin settings teams:enableClearTextAuth = yes
?sudo serveradmin stop teams
?sudo serveradmin start teams

Additional Gotcha's

While Apache2 is the default webserver in Leopard Server, it is possible to use Apache 1.3. If you choose to do this be aware that you shouldn't use SSL, as it will produce pages with http:// rather than https://. With SSL disabled you lose a front-line security defense.

To disable blog service while maintaining wikis, go to Workgroup Manager (with Inspector enabled) and pick Groups from the pulldown menu. Find the ServicesLocator attribute and click the disclosure triangle. Delete the entry that ends with ":blog" and save the changes.

Conclusion

From my experience out in the field, wiki and blog services, collaboration services in general, have really pushed the adoption of Leopard Server. In the past I have found people hesitant to update their server OS early in the new OS cycle, but the collaboration services in Leopard have made people take the chance and become early adopters.

There is more to be learned about wiki and blog services and it is maturing quickly. I have seen direct Apple responses in various lists and discussions and that indicates to me that Apple is taking wiki and blog services very seriously. We will see more development from Apple and third parties. I expect to see new templates become available from the aftermarket much like what we saw with Keynote.

I also expect we will learn more about wiki and blog services, such as the tidbit I heard that you may not need to run it on a local OD Master, but simply doing a trusted bind between your wiki and blog server to an OD Master may be enough. I haven't tested it at the time of the writing of the article, but I expect it will work.

Please provide your feedback to me so I may include it in future articles. You can send the feedback to: ben@kadimac.com


Ben Greisler is a Certified Apple Consultant and Trainer based in the Philadelphia metro area. He consults and teaches nationally and is a regular speaker at MacWorld. He has worked on major Apple deployments both nationally and internationally for schools, government, and enterprise-level organizations.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

LibreOffice 4.4.5.2 - Free, open-source...
LibreOffice is an office suite (word processor, spreadsheet, presentations, drawing tool) compatible with other major office suites. The Document Foundation is coordinating development and... Read more
Adobe Lightroom 6.1.1 - Import, develop,...
Adobe Lightroom is available as part of Adobe Creative Cloud for as little as $9.99/month bundled with Photoshop CC as part of the photography package. Lightroom 6 is also available for purchase as a... Read more
File Juicer 4.41 - Extract images, video...
File Juicer is a drag-and-drop can opener and data archaeologist. Its specialty is to find and extract images, video, audio, or text from files which are hard to open in other ways. It finds and... Read more
A Better Finder Rename 9.52 - File, phot...
A Better Finder Rename is the most complete renaming solution available on the market today. That's why, since 1996, tens of thousands of hobbyists, professionals and businesses depend on A Better... Read more
OmniFocus 2.2.3 - GTD task manager with...
OmniFocus helps you manage your tasks the way that you want, freeing you to focus your attention on the things that matter to you most. Capturing tasks and ideas is always a keyboard shortcut away in... Read more
TinkerTool 5.4 - Expanded preference set...
TinkerTool is an application that gives you access to additional preference settings Apple has built into Mac OS X. This allows to activate hidden features in the operating system and in some of the... Read more
Tinderbox 6.3.1 - Store and organize you...
Tinderbox is a personal content management assistant. It stores your notes, ideas, and plans. It can help you organize and understand them. And Tinderbox helps you share ideas through Web journals... Read more
Parallels Desktop 10.2.2 - Run Windows a...
Parallels Desktop is simply the world's bestselling, top-rated, and most trusted solution for running Windows applications on your Mac. With Parallels Desktop for Mac, you can seamlessly run both... Read more
Adobe Premiere Pro CC 2015 9.0.1 - Digit...
Premiere Pro CC 2015 is available as part of Adobe Creative Cloud for as little as $19.99/month (or $9.99/month if you're a previous Premiere Pro customer). Premiere Pro CS6 is still available for... Read more
Adobe After Effects CC 2015 13.5.1 - Cre...
After Effects CC 2015 is available as part of Adobe Creative Cloud for as little as $19.99/month (or $9.99/month if you're a previous After Effects customer). After Effects CS6 is still available... Read more

You Against Me (Games)
You Against Me 1.0 Device: iOS Universal Category: Games Price: $.99, Version: 1.0 (iTunes) Description: A simple game… You. Me. Claim, steal, lock, score, win! | Read more »
Yep, it's True - Angry Birds 2 is O...
The not exactly rumors were true and the birds are back. Angry Birds 2 has come to the App Store and the world will... well I suppose it'll still be the same, but now we have more bird-flinging options! [Read more] | Read more »
You Could Design Your Own Card for Chain...
If you've ever wanted to create your own item, weapon, trap, or even monster for Chainsaw Warrior: Lords of the Night, this is your chance. Auroch Digital is currently holding a contest so that fans can fight to the death (not really) to see which... | Read more »
Bitcoin Billionaire is Going Back in Tim...
If you thought you managed to buy everything there is to buy in Bitcoin Billionaire and make all the money, well you though wrong. Those of you who made it far enough might remember investing in time travel - and it looks like that investment is... | Read more »
Domino Drop (Games)
Domino Drop 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Domino Drop is a delightful new puzzle game with dominos and gravity!Learn how to play it in a minute, master it day by day.Your... | Read more »
OPERATION DRACULA (Games)
OPERATION DRACULA 1.0.1 Device: iOS Universal Category: Games Price: $5.99, Version: 1.0.1 (iTunes) Description: 25% off launch sale!!! 'Could prove to be one of the most accurate representations of the Japanese bullet hell shmup... | Read more »
Race The Sun (Games)
Race The Sun 1.01 Device: iOS iPhone Category: Games Price: $4.99, Version: 1.01 (iTunes) Description: You are a solar craft. The sun is your death timer. Hurtle towards the sunset at breakneck speed in a futile race against time.... | Read more »
Tap Delay (Music)
Tap Delay 1.0.0 Device: iOS Universal Category: Music Price: $4.99, Version: 1.0.0 (iTunes) Description: Back in the “old days”, producers and engineers created delay and echo effects using tape machines. Tap Delay combines the warm... | Read more »
This Week at 148Apps: July 20-24, 2015
July is Heating Up With 148Apps How do you know what apps are worth your time and money? Just look to the review team at 148Apps. We sort through the chaos and find the apps you're looking for. The ones we love become Editor’s Choice, standing out... | Read more »
Red Game Without A Great Name (Games)
Red Game Without A Great Name 1.0.3 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.3 (iTunes) Description: The mechanical bird is flying through an unfriendly, Steampunk world. Help it avoid obstacles and deadly... | Read more »

Price Scanner via MacPrices.net

Apple’s Education discount saves up to $300 o...
Purchase a new Mac or iPad at The Apple Store for Education and take up to $300 off MSRP. All teachers, students, and staff of any educational institution qualify for the discount. Shipping is free,... Read more
12-inch MacBooks in stock for $20 off, save o...
Adorama has 12″ Retina MacBooks in stock for $20 off MSRP including free shipping plus NY & NJ sales tax only. For a limited time, Adorama will include a free Apple USB-C to USB Adapter, free 4-... Read more
College Student Deals: Additional $100 off Ma...
Take an additional $100 off all MacBooks and iMacs at Best Buy Online with their College Students Deals Savings, valid through August 8, 2015. Anyone with a valid .EDU email address can take... Read more
2015 13-inch 2.7GHz Retina MacBook Pro on sal...
B&H Photo has the new 2015 13″ 2.7GHz/128GB Retina MacBook Pro on sale today for $1199 including free shipping plus NY sales tax only. Their price is $100 off MSRP. Read more
2.8GHz Mac mini available for $988, includes...
Adorama has the 2.8GHz Mac mini available for $988, $11 off MSRP, including a free copy of Apple’s 3-Year AppleCare Protection Plan. Shipping is free, and Adorama charges sales tax in NY & NJ... Read more
Updated Mac Price Trackers
We’ve updated our Mac Price Trackers with the latest information on prices, bundles, and availability on systems from Apple’s authorized internet/catalog resellers: - 15″ MacBook Pros - 13″ MacBook... Read more
High-Precision Battery Fuel Gauge IC Extends...
Renesas Electronics Corporation has announced its new lithium-ion (Li-ion) battery fuel gauge IC, the RAJ240500, designed to extend battery life for connected mobile devices such as tablets, notebook... Read more
27-inch 3.3GHz 5K iMac on sale for $1799, $20...
B&H Photo has the 27″ 3.3GHz 5K iMac on sale for $1799 including free shipping plus NY tax only. Their price is $200 off MSRP, and it’s the lowest price available for this model from any Apple... Read more
Twelve South Free Dual Screen Backgrounds Co...
Twelve South has posted a second collection of travel Desktop photos, noting: For the Twelve South team, a vacation is never just a vacation. It’s a time to try out new prototypes on the road, visit... Read more
Apple Refurbished iMacs available for up to $...
The Apple Store has Apple Certified Refurbished iMacs available for up to $380 off the cost of new models. Apple’s one-year warranty is standard, and shipping is free: - 27″ 3.5GHz 5K iMac – $1949 $... Read more

Jobs Board

*Apple* Retail - Multiple Positions (US) - A...
Job Description: Sales. Specialist - Retail Customer Service and Sales. Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions (US) - A...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Retail - Multiple Positions (US) - A...
Job Description: Sales. Specialist - Retail Customer Service and Sales. Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* Customer Experience (ACE) Leader - A...
…management to deliver on business objectives Training partner store staff on Apple products, services, and merchandising guidelines Coaching partner store staff on Read more
Project Manager - *Apple* Pay Security - Ap...
**Job Summary** The Apple Pay Security team is seeking a highly organized, results-driven Project Manager to drive the development of Apple Pay Security. If you are Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.