Setup Script

Lync for Mac supports using Kerberos for single sign-on authentication and Autodiscover for automatic configuration, however, some network infrastructures may not support these services.

Administrators can deploy the following user setup files to pre-populate user logon information and server addresses prior to users launching the Lync for Mac application.

Features

LyncSetup 1.2 does the following:

  • Populates the user name from his Mac OS X account
  • Populates the user email address from Active Directory
  • Populates external Lync server address
  • Populates internal Lync server address
  • Disables the first run license agreement
  • Disables prompt for Conference
  • Disables prompt for Presence
  • Disables prompt for Telephone

How it works

Every time a Mac OS X user logs into his computer a launchd agent will run the script.

The script first checks for an existing ~/Library/Preferences/com.microsoft.Lync.plist file. If it finds the file it assumes the user’s Lync settings have already been configured and exits without doing anything more. If the file doesn’t exist then the script gathers the user’s login ID and email address and writes it to the .plist file along with extra settings to disable dialogs.

Every time Lync is launched it will first check the main Library folder for settings such as server addresses. If it finds a settings file then it will override anything in the user’s Library folder and populate his client with this information.

Preparing the LyncSetup files

Download the setup files. The enclosing folder includes these three files and their locations within the top level Library folder:

  • LyncSetup-1.2.sh script
  • net.talkingmoose.LyncSetup.plist launchd agent
  • MicrosoftLyncRegistrationDB.plist preference file

Edit the LyncSetup-1.2.sh script with a text editor such as TextEdit or Bare Bones Software’s BBEdit or free TextWrangler application. The administrator must make one modification. For Mac OS X 10.7 and higher environments he’ll need to replace “TALKINGMOOSE” with his company’s NetBIOS domain name in this section:

# Enter your company NetBIOS domain name here. Necessary for Mac OS X 10.7 and later.

NETBIOSDOMAIN="TALKINGMOOSE"

Edit the MicrosoftLyncRegistrationDB.plist file using the same text editor. The administrator must modify the addresses for both the external and internal servers:

<!-- Modify the string values below with your company's Lync server addresses. -->

<key>hkey_local_machine\software\policies\microsoft\communicator\serveraddressexternal</key>
<string>im.talkingmoose.net</string>
<key>hkey_local_machine\software\policies\microsoft\communicator\serveraddressinternal</key>
<string>im.talkingmoose.pvt</string>

The “talkingmoose.net” domain and “talkingmoose” folder used throughout the files are placeholders. If the administrator wishes to replace them with his company’s name the script will still work. He must be sure to change the names and path in the setup script as well as the launchd agent.

Deployment

Administrators can use their preferred deployment software to push these three files to the following locations on each user machine:

/Library/talkingmoose/Scripts/LyncSetup-1.2-sh
/Library/LaunchAgents/net.talkingmoose.LyncSetup.plist
/Library/Preferences/MicrosoftLyncRegistrationDB.plist

They should ensure the LyncSetup-1.2.sh script is executable and that the net.talkingmoose.LyncSetup.plist agent is owned by “root:wheel” and not executable:

sudo chmod +x /Library/talkingmoose/Scripts/LyncSetup-1.2.sh
sudo chown root:wheel /Library/LaunchAgents/net.talkingmoose.LyncSetup.plist
sudo chmod -x /Library/LaunchAgents/net.talkingmoose.LyncSetup.plist

User experience

A user launching Lync for Mac for the first time will simply need to enter his password and click the Sign In button.

Lync login window

If he clicks the Advanced button at the bottom of the login window he will see his server address information:

Lync server information

Troubleshooting

The LyncSetup-1.2-sh script logs successes and failures for each step of the script. They are logged in each user’s ~/Library/Logs/LyncSetup.log file.

Lync Setup log

Share this:
  • Twitter
  • Facebook
  • del.icio.us
  • Digg
  • StumbleUpon
  • Google Bookmarks
  • PDF
  • Print