TweetFollow Us on Twitter

Using Sassafras' KeyServer to Manage Licenses

Volume Number: 25
Issue Number: 09
Column Tag: System administration

Using Sassafras' KeyServer to Manage Licenses

by Criss Myers

Preface to the issues involved with licensing

One of the many challenges that face an Apple Mac Network System Manager is the control and management of Application software. One of the issues involved in this is licensing. Anyone who installs a piece of software has a legal duty to comply with the license agreement shipped with the software. On a network, this challenge becomes much harder when we take into account that we may have many more client machines than available software licenses. There is naturally no reason to purchase a single license for every Mac on the network when each application is not used concurrently on all the clients [Ed. Note: This depends on the End User License Agreement itself.]. With this in mind there is a legal need to comply with the installed license agreements. Some software developers have their own means of controlling their license agreements. Apple offers a "network aware volume license," Quark has their own license server and many others use an iLok or USB dongle control feature. However, the majority of software available does not offer a network license; it is shipped with a single use license. Even those that do come with a network license come with no means of enforcing this, or of preventing unauthorized launching of the software when all licenses are used.

Further licensing issues occur when a client imaging system is used. One of the easiest ways to manage a large number of networked Macs is to image them centrally. This means that each Mac has the same software installed onto it. Which also means that the same license code is installed on to every client during imaging. Some software licenses are network aware, but in general, the same license code will allow you to launch the software on every client at once. This, of course, would breach the license agreement.

The Solution: Sassafras KeyServer

One approach to this problem is to use KeyServer by Sassafras Software. Sassafras has been around for nearly 20 years (since 1990). With KeyServer, you can control and monitor the usage of each license on your network. The KeyServer manages your list of available licenses and grants access based on your license preferences; each client requires a KeyServer license.

The server software can be installed on a OS X-based server (can be OS X, or OS X Sever), a Windows server, a Novell server or a Linux server. The client software can be run on a Mac, Linux or Windows client, which means that the same solution can help you to control both your Mac and Windows licenses from a single setup. A single KeyServer license will work on both platforms, as the license is per client machine registered with the server, irrelevant of the platform from which it runs.

In addition to controlling the software licenses, Keyserver has the ability to monitor software usage, because it can be set up to log all activity and display it as a graph over a given period of time. This can help you to comply with auditor's requirements as well as facilitating the planning of future software purchases.

Some of the benefits of using a KeyServer

A license entry can be created for any piece of software.

A license entry can be keyed, preventing the software from being launched, when there is no access to the server.

A queuing feature places those that request an unavailable license in a queue, informing them when a license becomes available.

Releasing idle licenses for those who are queued

A report of software usage can help to plan future software purchase and save money on unnecessary purchases.

Can be used for tracking computer usage and logons as well as license usage.

Compare usage stats for various Applications such as Safari vs Firefox giving you an idea of clients preferences.

Setup and configuration of the Keyserver K2

Installing the K2 Server and Shadows

The KeyServer is easy to install and setup. A full version of the software can be downloaded and installed from Sassafras for a limit period of time, for a limited number of clients for evaluation. Once you have downloaded the "K2" software to the server you need to install the K2Server.app on the server. When you purchase a license from Sassafras you will receive a single license file, (".lic") extension, for the number of clients that you purchased. Place this in the KeyServer folder located at "/Library/KeyServer/KeyServer Data Folder". If you purchase an increase to your number of clients you simply replace this file.

Figure 1 shows the server's library folder containing the ks-StartStop application,, the ks, KeyServer Data Folder containing the .lic license file and the KSddConsist Application, which checks the consistency of the KeyServer files.


Fig 1. Library Folder.

Once installed, the server can be started and stopped via the "ks-StartStop" or via the command line executing the "ks" executable. The server requires very little processor power, memory or disk space. The K2Server will launch at startup after its first run.

Figure 2 shows the ks-StartStop window confirming that the KeyServer is running.


Fig 2. ks-StartStop

The KeyServer supports what are called "shadows", which are replicas of the main server, so that if the main server is offline, the shadows can be used to authorize license requests and log usage.

To create a shadow, you need to create a shadow license file via the K2 Admin tool, KeyConfigure. Then, on a second server, replace the .lic file with the Shadow.lic file. The first time you start the Shadow KeyServer you will need to start it via the command line, as you will need to enter the password you created when creating the Shadow license file.


Figure 3. The KeyConfigure menu for creating a Shadow license.

You will need to add the KeyServer to your firewall on both the main and shadow servers, the K2 port is UPD ports 19283 and 19315 and TCP port 19283.

Installing the K2Client / K2Mobile and K2Admin tools

The client software is installed via the K2Client.mkpg or the K2Mobile.mkpg. The difference between these two is that the mobile version allows you to sign out licenses on mobile clients for use offline. The client installer installs KeyAccess, KeyVerify and a PreferencePane. When you install the client, it asks for the address of the server, either via FQDNS or IP address.


Figure 4. The K2 Client installer, the KeyServer Address is required before the installation starts.

The PreferencePane allows you to logon to the Keyserver, and lists the available shadows. Once connected, the client will reconnect at each logon. Every time you login to the computer it will connect to the KeyServer and log the activity along with the logging of each license that is granted, denied or queued.


Figure 5. The PreferencePane shows you the status of the connection between the client and the server as well as known Shadow servers as well as the version number, i.e. 6.1.4.4 The first time you logon you get the above message.

The K2 Server is administered from a client computer. Installing the K2Admin.mpkg will install the KeyConfigure application in the Applications folder. When you launch the KeyConfigure Application it asks for the Server address and authentication. The default password is "Sassafras".

Figure 6 and 7 show the logon and password change windows.


Figure 6. The KeyConfigure login window.


Figure 7. KeyConfigure's request to change the default password.

Configuration of the KeyServer

KeyConfigure is the Administration program for the entire configuration and monitoring of the KeyServer. The "Window" menu gives you access to the various different windowpanes for monitoring and setting up the KeyServer.

Figure 8 shows the Window menu in KeyConfigure, this is where you open the various windowpanes.


Fig 8. KeyConfigure's Window menu.

The first task after you have created a Shadow license is to setup the license entries for the programs you wish to manage. Open the "Licenses" windowpane. This lists all the license entries you create.

Figure 9 shows the license entries that have been setup.


Fig 9. License window pane

To create a license entry, just drag the application icon onto this license window. A new window then opens where you can select the appropriate options. Choose from a "Keyed Program" or an "Unkeyed Program". The difference between Key and Unkeyed is that the applications.app folder is modified by the KeyServer so that the program cannot be launched without a valid connection to the Keyserver. This prevents the program from being copied to another computer via CD or external drive. Some applications are self-contained within their .app bundle folder, which makes it easy to copy them to another machine. By keying the application, it can never be opened anywhere else. Some programs do like being keyed and once you key an application, you cannot unkey it without reinstalling, so make sure you test the applications you key. Click "Ok": the entry is created and the advance window is opened.

Figure 10 and Figure 11 show the configuration windows for setting up a license.


Fig 10. The new license entry creation window. Select between Keyed or Unkeyed and whether to allow the application to launch when the KeyServer is offline.


Fig 11. This window opens automatically after you create the license entry but can be accessed later by double clicking the entry in the license window.

Some of the main features that can be set are:

Limits: Choose the type of license you possess, and the number of concurrent licenses. Under Custom limits you can limit a license to certain groups, or create priority schedules for certain times. You can connect the KeyServer to a directory, such as active Directory, or LDAP to access existing groups.

Idle: Here you can set what happens when the user stops using the program for a certain length of time. Each program can have its own settings or you can set global settings, which allows you to set the queuing preferences. This can be very useful if you have a limited number of licenses but you expect that users may use the program for a short while and then leave it open. This would normally prevent other uses from using the program, but there is an option to queue new requests for the program and either warn users who are idle, or quit the program from them. Once a license is released due to idle settings the queued user will be notified that a license is now available for them.

Custom Message: Here you can create a message that gets displayed on screen when the application is launched. You can create a 'custom deny' or a queued message informing the user of the reason why they cannot launch the program. You can also create a one-time or on going general launch message, for example, "This program may crash if you remove the camera before quitting the application".

Once you have create the licenses you then need to add the computers, Every computer running keyAccess that logs on to the KeyServer gets audited by the KeyServer and added to the "Computers" window's discovery list.

Figure 12 shows the "Computers" windowpane.


Fig 12. Computers window.

Each new computer has a pink discovery icon next to it, to acknowledge the computer, right click on the name and select acknowledge. You can customize the categories to display such as MAC address and IP address. Under the divisions menu you can create separate divisions or computer groups. This can help you when you create reports so that you can view usage or activity based on computer groups.

Now you have the KeyServer installed and setup the final thing to do is monitor usage and create reports.

Figure 13 shows the currently logged in computers and users. This windowpane shows the maximum clients available for the purchased license as well as the name of the KeyServer.


Fig 13 The Users of the KeyServer

Double click on a user and you can view the licenses they have signed out as well as the times that they logged in. You can also send a bulletin message to the user.

Creating various reports and graphs

When you have used the KeyServer for a few months and built up a database of usage, you can build reports. These will allow you to gather useful information that can help you to plan for the future. There are many reports you can create, to include data such as: computer usages, license usages, weekly and daily reports, logins, list of denials etc. The data can be displayed as histograms. To create a report you select the appropriate report from the "Reports" menu. You then get a popup box to edit the criteria. You can select other reports to run and then choose the time period in which to run the reports. The resulting report can then be saved as either an html file or an xml file.


Fig 14. The KeyConfigure's reports popup window.

Conclusion

One of the many issues Mac system administrators have to address is software licensing and tracking. A KeyServer solution offers a great way of solving this issue as well as offering other services. The software is easy to setup, requires limited resources and can have multiple backup servers. It can manage any program as well as monitoring logins and logouts. You can add the KeyServer to a directory service and then use existing groups to assign licenses. If you divide your computers into divisions you can track software and computer use by division, if you wish to assign a division to a particular building then you can compare usage between different physical locations. Then once setup you can use the reporting feature to analyse different usage patterns to enable you to plan for the future. There are many other features that have not been discussed here, that a KeyServer can offer. Not only can the KeyServer monitor usage of license it can also control who has access and when, which means much greater flexibility in license management. For more information and to obtain a trial copy, go to www.sassafras.com.


Criss Myers is a Business Support Analyst (Mac Services), for Learning and Information Services, at the University of Central Lancashire, Preston, United Kingdom. He has been a Systems Server Administrator from the very first version of OS X Server. He Works with Macs as well as Linux, Unix and Windows and specializes in image deployment and maintenance as well as client management.

 
AAPL
$101.95
Apple Inc.
+1.06
MSFT
$44.91
Microsoft Corpora
-0.10
GOOG
$574.51
Google Inc.
-3.35

MacTech Search:
Community Search:

Software Updates via MacUpdate

Cocktail 7.6 - General maintenance and o...
Cocktail is a general purpose utility for OS X that lets you clean, repair and optimize your Mac. It is a powerful digital toolset that helps hundreds of thousands of Mac users around the world get... Read more
LaunchBar 6.1 - Powerful file/URL/email...
LaunchBar is an award-winning productivity utility that offers an amazingly intuitive and efficient way to search and access any kind of information stored on your computer or on the Web. It provides... Read more
Maya 2015 - Professional 3D modeling and...
Maya is an award-winning software and powerful, integrated 3D modeling, animation, visual effects, and rendering solution. Because Maya is based on an open architecture, all your work can be scripted... Read more
BBEdit 10.5.12 - Powerful text and HTML...
BBEdit is the leading professional HTML and text editor for the Mac. Specifically crafted in response to the needs of Web authors and software developers, this award-winning product provides a... Read more
Microsoft Office 2011 14.4.4 - Popular p...
Microsoft Office 2011 helps you create professional documents and presentations. And since Office for Mac 2011 is compatible with Office for Windows, you can work on documents with virtually anyone... Read more
TextWrangler 4.5.10 - Free general purpo...
TextWrangler is the powerful general purpose text editor, and Unix and server administrator's tool. Oh, and also, like the best things in life, it's free. TextWrangler is the "little brother" to... Read more
BitTorrent Sync 1.4.72 - Sync files secu...
BitTorrent Sync allows you to sync unlimited files between your own devices, or share a folder with friends and family to automatically sync anything. File transfers are encrypted. Your information... Read more
Cyberduck 4.5.2 - FTP and SFTP browser....
Cyberduck is a robust FTP/FTP-TLS/SFTP browser for the Mac whose lack of visual clutter and cleverly intuitive features make it easy to use. Support for external editors and system technologies such... Read more
Tinderbox 6.0.3 - 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
Adobe Photoshop CC 2014 15.1.0 - Profess...
Photoshop CC 2014 is available as part of Adobe Creative Cloud for as little as $19.99/month (or $9.99/month if you're a previous Photoshop customer). Photoshop CS6 is still available for purchase (... Read more

Latest Forum Discussions

See All

Appointment With F.E.A.R Review
Appointment With F.E.A.R Review By Jennifer Allen on August 27th, 2014 Our Rating: :: CAMP DELIGHTUniversal App - Designed for iPhone and iPad Ever wanted to be a superhero? Appointment With F.E.A.R is a fine way to live that dream... | Read more »
Ultra Drift Review
Ultra Drift Review By Rob Thomas on August 27th, 2014 Our Rating: :: ULTRA DULLUniversal App - Designed for iPhone and iPad Ultra Drift is fine in concept, but the execution runs head-first into the wall. And so will you. Over and... | Read more »
Star Walk 2 is Like Stargazing with Neil...
Star Walk 2 is Like Stargazing with Neil DeGrasse Tyson in Your Pocket Posted by Jessica Fisher on August 27th, 2014 [ permalink ] | Read more »
Watch the World Go By Really Fast with I...
Watch the World Go By Really Fast with Instagram’s New Hyperlapse Posted by Jessica Fisher on August 27th, 2014 [ permalink ] Universal App - Designed for iPhone and iPad | Read more »
The Walking Dead Pinball (Games)
The Walking Dead Pinball 1.0 Device: iOS Universal Category: Games Price: $1.99, Version: 1.0 (iTunes) Description: Zen Studios, Telltale Games, and Skybound Entertainment partner to create all-new table based on the 'Game of the... | Read more »
Ninja Smasher! (Games)
Ninja Smasher! 1.00 Device: iOS Universal Category: Games Price: $1.99, Version: 1.00 (iTunes) Description: Series total 300,000DL and Previous game "Ninja Striker!" got 1st in Japan!Q-Cumber Factory’s "Ninja" series’s recent game... | Read more »
WhatWatt Review
WhatWatt Review By Jennifer Allen on August 27th, 2014 Our Rating: :: UNTAPPED POTENTIALiPhone App - Designed for the iPhone, compatible with the iPad Want to know how much your devices are costing you to run? WhatWatt goes some... | Read more »
Appointment With F.E.A.R. (Games)
Appointment With F.E.A.R. 1.02 Device: iOS Universal Category: Games Price: $2.99, Version: 1.02 (iTunes) Description: Travel back to the 1980s as a superpowered defender of justice in this all-new edition of Steve Jackson's... | Read more »
8bit Doves (Games)
8bit Doves 1.0 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0 (iTunes) Description: “I dove it” – Pocket Gamer “They told me I could be whatever I want, so I became a flying hobo” – Cactus Wolf “Let’s you crash into... | Read more »
Madden NFL Mobile Review
Madden NFL Mobile Review By Blake Grundman on August 26th, 2014 Our Rating: :: FINALLY GETS IT RIGHTUniversal App - Designed for iPhone and iPad It looks like EA Sports has finally discovered how to tread the line between free-to-... | Read more »

Price Scanner via MacPrices.net

The iPad’s Real Competitive Challenger (Not S...
It’s been my contention for some time that the iPad is suffering from something of an identity crisis, and I suspect that may be a factor in slackening sales this year. Apple can’t seem to decide... Read more
13-inch 2.6GHz/256GB Retina MacBook Pro on sa...
B&H Photo has the 13″ 2.6GHz/256GB Retina MacBook Pro on sale for $1379 including free shipping plus NY sales tax only. Their price is $120 off MSRP. Read more
Life Inventory iOS Apps – Learn to Know Thyse...
James Hollender’s Life Inventory apps s are now on sale with 20% off thru Labor Day, 09/01/2014. This is a great opportunity to get started on that Moral Inventory you’ve been putting off doing for... Read more
Pocket Watch, LLC. Reveals Cloud Server For P...
Beaumont, Texas based Pocket Watch, LLC. has announced the availability of its new ActivePrint Cloud Server Powered by Raspberry Pi. With this small standalone box almost any USB printer or available... Read more
902it Simplifies Area Code Changes For Nova S...
The east coast Canadian provinces of Nova Scotia and Prince Edward Island are phasing in 10 digit telephone dialing, to be fully in place by November, in order to accommodate a second area code to... Read more
Boomerang iPad Stand Mounts Your iPad Anywher...
Boomerang, a Mountable Stand with Multiple Viewing Angles, is now available for iPad Air. Boomerang combines several functions that aim to expand your iPad’s potential in one, elegant product. The... Read more
Retina MacBook Pros available starting at $10...
The Apple Store has Apple Certified Refurbished 13″ and 15″ MacBook Pros available starting at $929. Apple’s one-year warranty is standard, and shipping is free: - 13″ 2.5GHz MacBook Pros (4GB RAM/... Read more
Apple 27-inch Thunderbolt Display (refurbishe...
The Apple Store has Apple Certified Refurbished 27″ Thunderbolt Displays available for $799 including free shipping. That’s $200 off the cost of new models. Read more
Apple offers free $25 iTunes gift card with p...
The Apple Store is offering a free $25 iTunes Gift Card with the purchase of a $99 Apple TV for a limited time. Shipping is free. Read more
Apple’s 2014 Back to School promotion: $100 g...
 Apple’s 2014 Back to School promotion includes a free $100 App Store Gift Card with the purchase of any new Mac (Mac mini excluded), or a $50 Gift Card with the purchase of an iPad or iPhone,... Read more

Jobs Board

Senior Event Manager, *Apple* Retail Market...
…This senior level position is responsible for leading and imagining the Apple Retail Team's global event strategy. Delivering an overarching brand story; in-store, Read more
*Apple* Solutions Consultant (ASC) - Apple (...
**Job Summary** The ASC is an Apple employee who serves as an Apple brand ambassador and influencer in a Reseller's store. The ASC's role is to grow Apple Read more
Project Manager / Business Analyst, WW *Appl...
…a senior project manager / business analyst to work within our Worldwide Apple Fulfillment Operations and the Business Process Re-engineering team. This role will work Read more
Position Opening at *Apple* - Apple (United...
…customers purchase our products, you're the one who helps them get more out of their new Apple technology. Your day in the Apple Store is filled with a range of Read more
Position Opening at *Apple* - Apple (United...
**Job Summary** Being a Business Manager at an Apple Store means you're the catalyst for businesses to discover and leverage the power, ease, and flexibility of Apple Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.