[% PROCESS helpheader.html %]

 

SrvrPowerCtrl plugin OSX help

SrvrPowerCtrlSrvrPowerCtrl's job is to help you control power states (sleeping / waking / etc.) on your Squeezebox Server hardware. To do that, SrvrPowerCtrl needs to be able use some “helper” applications on your server. These applications differ according to which operating system you are using on the Squeezebox Server hardware. But whatever your server setup, you'll need to do a certain amount of manual tweaking of those helper applications and SrvrPowerCtrl's settings in order to get things working as they ought. Hopefully, these instructions will help you get everything set “just right.”



[% warning %]

To finish installing the plugin for OSX, do the following:

Make sure that you are logged into OSX as the same user account that you were using when you installed [% sbsservername %]. This is important. Additionally, if your account lacks administrative privileges, you'll need to enable them temporarily to finish the SrvrPowerCtrl setup. Open ‘System Preferences→Accounts→My Account’ and make sure that ‘Allow user to administer this computer’ is checked. If it's not, temporarily enable administrative privileges by clicking on the lock and entering an administrative user name and password and then checking the box. When SrvrPowerCtrl setup is complete, unless your account is the primary administrative account on the computer, you can reverse this process and un-check this option.

Open a terminal window: Click on the Spotlight magnifying glass in the menu bar, type “terminal” and hit enter.

Do the following: copy and paste this command into the terminal window to make the setup script executable:

# sudo chmod 755 "[% pluginpath %]/scripts/MacOSX/srvrpowerctrl-setup.sh"

The sudo command should prompt you for your password. Next, execute the setup script:

# sudo "[% pluginpath %]/scripts/MacOSX/srvrpowerctrl-setup.sh"

Finally, we need to verify that your user account now has permission to shutdown the system without raising any password prompts. We'll do this by running a test script which performs a FAKE shutdown...you system won't actually halt, but we will be able to test to see that permissions have been correctly set. In the terminal window, try executing the following command:

# /usr/local/sbin/spc-test.sh

The sudo command may prompt you for YOUR password, which is appropriate in this case. If the script responds with SUCCESS!, then the plugin ought to be able to shutdown/restart/etc your system from the [% sbsservername %] service. If, however, the script responds with ERROR!, then something is amiss. If this is the case, try running the setup script again. Remember, the test script won't actually shutdown your system.

If your Mac's role is split between working as a [% sbsservername %] server and working as your desktop computer, you can make life a little easier for yourself by making these configuration changes:

First off, disable automatic login. Use System Preferences→Accounts→Login Options to do this.

Next, execute the following code in a terminal window:

# sudo "[% pluginpath %]/scripts/MacOSX/autoblock-enable.sh"

The above script sets up “hooks” so that whenever you log into your Mac, SrvrPowerCtrl gets automatically “blocked”, i.e. temporarily disabled. This makes sure that SrvrPowerCtrl doesn't put your system to sleep right when you're in the middle of doing some important work. Once you log off, the block gets automatically cleared and SrvrPowerCtrl can go back to doing it's job.

To remove the login/logout “hooks”, execute:

# sudo "[% pluginpath %]/scripts/MacOSX/autoblock-disable.sh"


Finally, if you'd prefer to make all your OSX system settings changes manually (rather than using the above setup scripts) please consult the readme.txt file for steps you'll need to carry out.

 


[% "PLUGIN_SRVRPOWERCTRL_BACKTO_HELP_PAGE" | string %] [% "PLUGIN_SRVRPOWERCTRL_TROUBLESHOOTING_HELP_PAGE" | string %] [% "PLUGIN_SRVRPOWERCTRL_HOME_PAGE" | string %]
[% PROCESS helpfooter.html %]