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.

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Fantastical 2.5.13 - Create calendar eve...
Fantastical is the Mac calendar you'll actually enjoy using. Creating an event with Fantastical is quick, easy, and fun: Open Fantastical with a single click or keystroke Type in your event... Read more
A Better Finder Rename 11.05 - File, pho...
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
SpamSieve 2.9.38 - Robust spam filter fo...
SpamSieve is a robust spam filter for major email clients that uses powerful Bayesian spam filtering. SpamSieve understands what your spam looks like in order to block it all, but also learns what... Read more
TeamViewer 15.0.8397 - Establish remote...
TeamViewer gives you remote control of any computer or Mac over the Internet within seconds or can be used for online meetings. Find out why more than 200 million users trust TeamViewer! Free for non... Read more
SteerMouse 5.4.3 - Powerful third-party...
SteerMouse is an advanced driver for USB and Bluetooth mice. SteerMouse can assign various functions to buttons that Apple's software does not allow, including double-clicks, modifier clicks,... Read more
Toast Titanium 18.2.1 - The ultimate med...
Roxio Toast Titanium, the leading DVD burner for Mac, makes burning even better, adding Roxio Secure Burn to protect your files on disc and USB in Mac- or Windows-compatible formats. Get more style... Read more
HoudahSpot 5.0.11 - Advanced file-search...
HoudahSpot is a versatile desktop search tool. Use HoudahSpot to locate hard-to-find files and keep frequently used files within reach. HoudahSpot will immediately feel familiar. It works just the... Read more
ClipGrab 3.8.6 - Download videos from Yo...
ClipGrab is a free downloader and converter for YouTube, Vimeo, Facebook and many other online video sites. It converts downloaded videos to MPEG4, MP3 or other formats in just one easy step Version... Read more
ExpanDrive 7.4.0 - Access cloud storage...
ExpanDrive builds cloud storage in every application, acts just like a USB drive plugged into your Mac. With ExpanDrive, you can securely access any remote file server directly from the Finder or... Read more
Adobe Dreamweaver CC 2020 20.0 - Build w...
Dreamweaver CC 2020 is available as part of Adobe Creative Cloud for as little as $20.99/month (or $9.99/month if you're a previous Dreamweaver customer). Adobe Dreamweaver CC 2020 allows you to... Read more

Latest Forum Discussions

See All

New heroes and balance updates set to ar...
It feels like Hearthstone: Battlegrounds only launched yesterday, and already the auto batter addition to Blizzard's megahit card game is set to receive new heroes and balance updates. [Read more] | Read more »
Pre-register for Hello Kitty AR: Kawaii...
Hello Kitty — the cute cat that launched a multi-billion-pound franchise — has been brought to life… sort of. Sanrio has teamed up with the Bublar Group to create a new mobile game that uses AR tech to turn the real world into Hello Kitty’s... | Read more »
Gorgeous and tranquil puzzler Spring Fal...
One-man indie studio SPARSE//GameDev has now launched its tranquil puzzler, Spring Falls. It's described as "a peaceful puzzle game about water, erosion, and watching things grow". [Read more] | Read more »
Black Desert Mobile gets an official rel...
Pearl Abyss has just announced that its highly-anticipated MMO, Black Desert Mobile, will launch globally for iOS and Android on December 11th. [Read more] | Read more »
Another Eden receives new a episode, cha...
Another Eden, WFS' popular RPG, has received another update that brings new story content to the game alongside a few new heroes to discover. [Read more] | Read more »
Overdox guide - Tips and tricks for begi...
Overdox is a clever battle royale that changes things up by adding MOBA mechanics and melee combat to the mix. This new hybrid game can be quite a bit to take in at first, so we’ve put together a list of tips to help you get a leg up on the... | Read more »
Roterra Extreme - Great Escape is a pers...
Roterra Extreme – Great Escape has been described by developers Dig-It Games as a mini-sequel to their acclaimed title Roterra: Flip the Fairytale. It continues that game's tradition of messing with which way is up, tasking you with solving... | Read more »
Hearthstone: Battlegrounds open beta lau...
Remember earlier this year when auto battlers were the latest hotness? We had Auto Chess, DOTA Underlords, Chess Rush, and more all gunning for our attention. They all had their own reasons to play, but, at least from where I'm standing, most... | Read more »
The House of Da Vinci 2 gets a new gamep...
The House of Da Vinci launched all the way back in 2017. Now, developer Blue Brain Games is gearing up to deliver a second dose of The Room-inspired puzzling. Some fresh details have now emerged, alongside the game's first official trailer. [Read... | Read more »
Shoot 'em up action awaits in Battl...
BattleBrew Productions has just introduced another entry into its award winning, barrelpunk inspired, BattleSky Brigade series. Whilst its previous title BattleSky Brigade TapTap provided fans with idle town building gameplay, this time the... | Read more »

Price Scanner via MacPrices.net

Apple continues to offer 2017 13″ Dual-Core n...
Apple has Certified Refurbished 2017 13″ 2.3GHz Dual-Core non-Touch Bar MacBook Pros still available starting at $1019. An standard Apple one-year warranty is included with each model, outer cases... Read more
Save up to $120 on the new 16″ MacBook Pro at...
Apple’s resellers are starting to receive stock of new 16″ MacBook Pros, and the first set of sales & deals are now available: (1) Amazon 16″ MacBook Pros start on sale for $100-$116 off Apple’s... Read more
Apple Watch Series 3 models on sale at Amazon...
Amazon has Apple Watch Series 3 GPS models on sale for $30 off MSRP, starting at only $169. There prices are the lowest we’ve ever seen for these models from any Apple reseller. Choose Amazon as the... Read more
The ‘Mac Potpourri’ Mailbag: Edition #1- Info...
COMMENTARY: 11.20.19- Welcome to the inaugural edition of the “Mac Potpourri” Mailbag where we take a look at correspondence received from readers of this column from all over the world who write in... Read more
13″ 2.4GHz MacBook Pros available for up to $...
Apple has a full line of Certified Refurbished 2019 13″ 2.4GHz 4-Core Touch Bar MacBook Pros available starting at $1529 and up to $300 off MSRP. Apple’s one-year warranty is included, shipping is... Read more
New at T-Mobile: Switch to T-Mobile, and get...
T-Mobile is offering a free 64GB iPhone 8 for new customers who switch to T-Mobile and open a new line of service. Eligible trade-in required, and discount applied over a 24 month period. The fine... Read more
Xfinity Mobile’s Black Friday Apple savings:...
Take $250 off the purchase of any iPhone at Xfinity Mobile with a new line activation, and transfer of phone number to Xfinity Mobile, through December 8, 2019. This includes Apple’s new iPhone 11... Read more
2019 13″ 1.4GHz MacBook Pros available starti...
Apple has a full line of Certified Refurbished 2019 13″ 1.4GHz 4-Core Touch Bar MacBook Pros available starting at $1099 and up to $230 off MSRP. Apple’s one-year warranty is included, shipping is... Read more
Save up to $350 on a 21″ or 27″ iMac with the...
Apple has Certified Refurbished 2019 21″ & 27″ iMacs available starting at $929 and up to $350 off the cost of new models. Apple’s one-year warranty is standard, shipping is free, and each iMac... Read more
Early Holiday 2019 Sale: B&H again offers...
B&H Photo has 10.2″ iPads on sale again for $30 off Apple’s MSRP, starting at $299, as part of their early Holiday 2019 sale. Overnight shipping is free to many addresses in the US: – 10.2″ 32GB... Read more

Jobs Board

Best Buy *Apple* Computing Master - Best Bu...
**745516BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Store Associates **Store NUmber or Department:** 001101-Manhattan-Store **Job Read more
Best Buy *Apple* Computing Master - Best Bu...
**746655BR** **Job Title:** Best Buy Apple Computing Master **Job Category:** Sales **Store NUmber or Department:** 002518-Atlantic Center-Store **Job Description:** Read more
*Apple* Mobility Pro - Best Buy (United Stat...
**747089BR** **Job Title:** Apple Mobility Pro **Job Category:** Store Associates **Store NUmber or Department:** 000377-Prescott AZ-Store **Job Description:** At Read more
*Apple* Health Benefit Specialist - Call Cen...
Description ** Apple Health Benefit Specialist - Call Center (MAS 3/MACSC)** **Olympia, WA Multiple Positions** *The ideal candidate for this position will have Read more
Hair Stylist - *Apple* Blossom Mall - JCPen...
Hair Stylist - Apple Blossom Mall Location:Winchester, VA, United States- Apple Blossom Mall 1850 Apple Blossom Dr Job ID:1065040Salon Professionals Job Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.