Amahi Wiki - User contributions [en]

Amahi Energy Saver

2011-06-13T19:57:31Z

Amahivirtual: Added section to view AES Logs in the LogAnalyzer to "7. Logs"

[[Image:Amahi-Energy-Saver_Logo.png|150px]] 

==General==

This is in solid beta stage. Installation requires a little Linux knowledge.

If you like it, like it on facebook: http://www.facebook.com/pages/Amahi-Energy-Saver/218015224890441?sk=wall

==Introduction==
Running servers when they are not needed can waste a considerable amount of energy. This application tells your Amahi server to suspend or power off when its services are not needed.

Amahi Energy Saver regularly scans for connected clients, which are defined in the "monitored host list". If none of these clients is turned on, the system suspends after a configurable period.

So, for instance, you may want to add your client PC and your PS3 to the monitored host list. The Amahi Box will then stay up and running as long as client PC and/or PS3 are up and running. However, you might not want to add your home router to the list, as the router is always turned on.

With the calendar function one can define scheduled wake ups and periods during which the server shall stay awake no matter what.

Amahi Energy Saver also checks shares. As long as shares are accessed, the server does not suspend. If set up to do so, Squeezeboxserver is monitored to prevent suspend while Squeezeboxes are turned on.

When the system is to be used again, simply wake it up with WOL (ref. http://en.wikipedia.org/wiki/Wake-on-LAN). There are many tools to generate WOL packets, and it is even possible to wake your server over the internet (good link: http://www.wakeonlan.me/).

==Download==

Download the latest tested and released version here: http://code.google.com/p/amahienergysaver/downloads/list

Latest untested sources are available at Git:
https://github.com/jayrockk/Amahi-Energy-Saver

==Initial setup==

1. Copy the tar.gz file from the download page to some folder and unpack it with

{{Code|Code=
tar -zxf filename
}}

2. Open a terminal, change to that folder and get superuser rights by running <code>su</code>

3. As root, run
{{Code|Code=
cd installfiles
}}
{{Code|Code=
./aes-install.sh
}}

4. When the installation is finished, reboot the computer. The config app is accessible at

{{Code|Code=
http://hda:6500
}}

==Integration with Amahi calendar==
1. In the config app, select ical in the Calendar field.

2. Hit the "Apply button in the config app

3. Connect your client to the new calendar. NOTE: Please read this article if you are unsure how to do this: [[Calendars]]

4. Use your favourite calendar client to populate the calendar with events.

Done! Your HDA will now wake up and stay powered on according to the events defined in the aes calendar.

==Selecting ShutdownType==

The different options for ShutdownType are explained here: 

Deactivated
Amahi Energy Saver is running in the background, however it will never shutdown or suspend the HDA.

Poweroff
This is a full shutdown and should work on most systems. Some mainboards do not allow scheduled wakeup when using this method. 

ACPI_S1
Legacy ACPI S1 state. Support depends on mainboard and Fedora support 

ACPI_S3
Legacy ACPI S3 state. Support depends on mainboard and Fedora support 

ACPI_S4
Legacy ACPI S4 state. Support depends on mainboard and Fedora support 

mem
Suspend to memory, is intended to replace ACPI S1 but is not widely supported yet 

disk
Suspend to disk, is intended to replace ACPI S4 but is not widely supported yet 

standby
Suspend to memory, is intended to replace ACPI S3 but is not widely supported yet 

When selecting the shutdown type the following procedure is suggested: 

* Start with Poweroff to do basic checking and configuration. Since this is the safest version, it should also be your resort in case of problems. 

* Once things are working, select either of the ACPI_S1..3 depending on what level of suspend you want 

* If you are brave or the ACPI options don't work, try mem, disk or standby. 

==Logs and LogAnalyzer==
Logs are located in /usr/share/aes and named aes.log*

In order to view the Amahi Energy Safer logs in in the LogAnalyzer (ref. http://www.amahi.org/apps/loganalyzer) navigate on your LogAnalyzer homepage to "Admin Center" then "Sources" and finally klick "Add new Source". Configure the new source for the Energy Safer logs as shown in the screenshot below:

[[File:LogAnalyzer_Config_for_Amahi_Energy_Safer.png]]

==Windows client for Wake on LAN==
On the download page there is a Windows client for automatic or manual wakeup of the HDA.

*Installation

Just run the msi file found on the download page. The client will be included in the startup folder.

*Configuration

1. Form the start menu, run AmahiEnergySaver -> AES Client

2. Right click on the icon that will appear in symbol bar, and select "Show config"

3. To get started, make sure that you set "Host MAC" and "Host name" to your HDA configuration. Hit "Select Server" to bring up the "Select HDA" window, and then "Search". If possible the correct server is alreday selected, in that case just hit "Ok" to confirm. Continue with 4. 
If the server appears on the list but is not automatically selected, click on it and hit return. 
Should your server not show up at all, press "Cancel" to exit the "Select HDA" dialog and configure MAC and host name manually. 
Finally, if requried, change the "Port" setting. The default "9" should work in most cases. 

4. Hit the "OK" butten, then right click on the symbol again, select "Exit" and and restart the program as described in 1.

5. Done! You should now be able to start your HDA by right clicking on the icon in the symbol bar and select "Wake now"

==Mac OS X clients for Wake on LAN==

There exist a few solutions (WOL clients) to wake up your HDA from a Mac OS X computer. In order to wake up your HDA while booting your Mac you may use NASwake (ref. http://trick77.com/2010/12/22/wake-nas-at-boot-time-wake-on-lan-wol/). It comes ready to use as an installable package, you just need to enter the MAC-adress of the HDA. 
WakeOnLan is a freeware application provided by Readpixel which offers a very comfortable way to wake up your HDA directly from your Mac OS X desktop (ref. http://www.readpixel.com/wakeonlan/index.html).

==OBSELETE: Command Line Interface==

*Note: Root privileges are required to execute the CLI command. Navigate to /usr/share/aes to use the CLI correctly.

{{Code|Code=
./aes.rb --shownetworkhosts
}}
Lists the hosts found in the network, ie, all devices connected to the network. Gives the user the choice to add hosts to the monitored host list.

{{Code|Code=
./aes.rb --showmonitoredhosts
}}
Show a list of all hosts which are monitored by AES (i.e. the monitored host list), and also allows to delete hosts from the list. If these hosts are up and running (and respond to ping), the server does not suspend.

{{Code|Code=
./aes.rb --addhost macadress
}}
Manually add a host to the monitored host list. Observe the MAC address format, which has to be XX:XX:XX:XX:XX:XX. Example is <code>./aes.rb --addhost 12:34:56:78:90:ab</code>

{{Code|Code=
./aes.rb --calendar [off, internal, ical, debug]
}}
<code>./aes.rb --calendar</code> shows the current setting.
<code>./aes.rb --calendar off</code> turns the calendar off,
<code>./aes.rb --calendar internal</code> makes aes use its internal calendar function and
<code>./aes.rb --calendar ical</code> activates the Amahi calendar integration. To show diag information use <code>./aes.rb --calendar debug</code>

{{Code|Code=
./aes.rb --showcalendar
}}
Lists the current entries of the internal calendar. Calendar entries define times when the server does not suspend. Also, the server will be woken up at the beginning of a calendar entry.

{{Code|Code=
./aes.rb --addcalendar startdate starttime stopdate stoptime
}}
Use this command to add an entry to the internal calendar. Format of startdate/stopdate: YYYY-MM-DD Format of starttime/stoptime: hhm:mm. Eg.
 <code>./aes.rb --addcalendar 2010-12-20 15:00 2010-12-20 16:00</code> 
will keep the server awake on Dec 20th, 2010 from 15 to 16 hrs (3 to 4 pm). The server will also wake up at 15 hrs if it is suspended.

{{Code|Code=
./aes.rb --shutdowntype
}}
Show and modifiy the type of shutdown. NOTE: Not all shutdown types may be supported on your system, or may work correctly. Therefore, test that your machine is suspending and coming up correctly before deciding for a setting. Poweroff is safest type.

{{Code|Code=
./aes.rb --sbs [on, off, debug]
}}
<code>./aes.rb --sbs</code> shows the current setting. <code>./aes.rb --sbs on</code> and <code>./aes.rb --sbs off</code> switch monitoring of Squeezeboxserver on or off, respectively. The command <code>./aes.rb --sbs debug</code> displays diagnostic information

{{Code|Code=
./aes.rb --interval
}}
aes checks regularly if the system can be suspended or shut down. This parameter specifies the time in seconds between two such checks. Normally should be left untouched.

{{Code|Code=
./aes.rb --showenergybalance
}}
View the energy savings in kWh due to the use of Amahi Energy Saver.

{{Code|Code=
./aes.rb --setpowerconsumption pc_on pc_standby
}}
Set the average power consumption when working ("pc_on") and powered off ("pc_standby"). Values given in Watts. pc_on must be greater than pc_standby.

{{Code|Code=
./aes.rb --help
}}
Displays command line help

File:LogAnalyzer Config for Amahi Energy Safer.png

2011-06-13T19:47:45Z

Amahivirtual: Screenshot shows configuration of LogAnalyzer for viewing Amahi Energy Safer Logs.

Screenshot shows configuration of LogAnalyzer for viewing Amahi Energy Safer Logs.

Amahi Energy Saver

2011-06-10T13:24:27Z

Amahivirtual: Rearranged chapters, put "obsolete" to the end of the page

[[Image:Amahi-Energy-Saver_Logo.png|150px]] 

==General==

This is in solid beta stage. Installation requires a little Linux knowledge.

If you like it, like it on facebook: http://www.facebook.com/pages/Amahi-Energy-Saver/218015224890441?sk=wall

==Introduction==
Running servers when they are not needed can waste a considerable amount of energy. This application tells your Amahi server to suspend or power off when its services are not needed.

Amahi Energy Saver regularly scans for connected clients, which are defined in the "monitored host list". If none of these clients is turned on, the system suspends after a configurable period.

So, for instance, you may want to add your client PC and your PS3 to the monitored host list. The Amahi Box will then stay up and running as long as client PC and/or PS3 are up and running. However, you might not want to add your home router to the list, as the router is always turned on.

With the calendar function one can define scheduled wake ups and periods during which the server shall stay awake no matter what.

Amahi Energy Saver also checks shares. As long as shares are accessed, the server does not suspend. If set up to do so, Squeezeboxserver is monitored to prevent suspend while Squeezeboxes are turned on.

When the system is to be used again, simply wake it up with WOL (ref. http://en.wikipedia.org/wiki/Wake-on-LAN). There are many tools to generate WOL packets, and it is even possible to wake your server over the internet (good link: http://www.wakeonlan.me/).

==Download==

Download the latest tested and released version here: http://code.google.com/p/amahienergysaver/downloads/list

Latest untested sources are available at Git:
https://github.com/jayrockk/Amahi-Energy-Saver

==Initial setup==

1. Copy the tar.gz file from the download page to some folder and unpack it with

{{Code|Code=
tar -zxf filename
}}

2. Open a terminal, change to that folder and get superuser rights by running <code>su</code>

3. As root, run
{{Code|Code=
cd installfiles
}}
{{Code|Code=
./aes-install.sh
}}

4. When the installation is finished, reboot the computer. The config app is accessible at

{{Code|Code=
http://hda:6500
}}

==Integration with Amahi calendar==
1. In the config app, select ical in the Calendar field.

2. Hit the "Apply button in the config app

3. Connect your client to the new calendar. NOTE: Please read this article if you are unsure how to do this: [[Calendars]]

4. Use your favourite calendar client to populate the calendar with events.

Done! Your HDA will now wake up and stay powered on according to the events defined in the aes calendar.

==Selecting ShutdownType==

The different options for ShutdownType are explained here: 

Deactivated
Amahi Energy Saver is running in the background, however it will never shutdown or suspend the HDA.

Poweroff
This is a full shutdown and should work on most systems. Some mainboards do not allow scheduled wakeup when using this method. 

ACPI_S1
Legacy ACPI S1 state. Support depends on mainboard and Fedora support 

ACPI_S3
Legacy ACPI S3 state. Support depends on mainboard and Fedora support 

ACPI_S4
Legacy ACPI S4 state. Support depends on mainboard and Fedora support 

mem
Suspend to memory, is intended to replace ACPI S1 but is not widely supported yet 

disk
Suspend to disk, is intended to replace ACPI S4 but is not widely supported yet 

standby
Suspend to memory, is intended to replace ACPI S3 but is not widely supported yet 

When selecting the shutdown type the following procedure is suggested: 

* Start with Poweroff to do basic checking and configuration. Since this is the safest version, it should also be your resort in case of problems. 

* Once things are working, select either of the ACPI_S1..3 depending on what level of suspend you want 

* If you are brave or the ACPI options don't work, try mem, disk or standby. 

==Logs==
Logs are located in /usr/share/aes and named aes.log*

==Windows client for Wake on LAN==
On the download page there is a Windows client for automatic or manual wakeup of the HDA.

*Installation

Just run the msi file found on the download page. The client will be included in the startup folder.

*Configuration

1. Form the start menu, run AmahiEnergySaver -> AES Client

2. Right click on the icon that will appear in symbol bar, and select "Show config"

3. To get started, make sure that you set "Host MAC" and "Host name" to your HDA configuration. Hit "Select Server" to bring up the "Select HDA" window, and then "Search". If possible the correct server is alreday selected, in that case just hit "Ok" to confirm. Continue with 4. 
If the server appears on the list but is not automatically selected, click on it and hit return. 
Should your server not show up at all, press "Cancel" to exit the "Select HDA" dialog and configure MAC and host name manually. 
Finally, if requried, change the "Port" setting. The default "9" should work in most cases. 

4. Hit the "OK" butten, then right click on the symbol again, select "Exit" and and restart the program as described in 1.

5. Done! You should now be able to start your HDA by right clicking on the icon in the symbol bar and select "Wake now"

==Mac OS X clients for Wake on LAN==

There exist a few solutions (WOL clients) to wake up your HDA from a Mac OS X computer. In order to wake up your HDA while booting your Mac you may use NASwake (ref. http://trick77.com/2010/12/22/wake-nas-at-boot-time-wake-on-lan-wol/). It comes ready to use as an installable package, you just need to enter the MAC-adress of the HDA. 
WakeOnLan is a freeware application provided by Readpixel which offers a very comfortable way to wake up your HDA directly from your Mac OS X desktop (ref. http://www.readpixel.com/wakeonlan/index.html).

==OBSELETE: Command Line Interface==

*Note: Root privileges are required to execute the CLI command. Navigate to /usr/share/aes to use the CLI correctly.

{{Code|Code=
./aes.rb --shownetworkhosts
}}
Lists the hosts found in the network, ie, all devices connected to the network. Gives the user the choice to add hosts to the monitored host list.

{{Code|Code=
./aes.rb --showmonitoredhosts
}}
Show a list of all hosts which are monitored by AES (i.e. the monitored host list), and also allows to delete hosts from the list. If these hosts are up and running (and respond to ping), the server does not suspend.

{{Code|Code=
./aes.rb --addhost macadress
}}
Manually add a host to the monitored host list. Observe the MAC address format, which has to be XX:XX:XX:XX:XX:XX. Example is <code>./aes.rb --addhost 12:34:56:78:90:ab</code>

{{Code|Code=
./aes.rb --calendar [off, internal, ical, debug]
}}
<code>./aes.rb --calendar</code> shows the current setting.
<code>./aes.rb --calendar off</code> turns the calendar off,
<code>./aes.rb --calendar internal</code> makes aes use its internal calendar function and
<code>./aes.rb --calendar ical</code> activates the Amahi calendar integration. To show diag information use <code>./aes.rb --calendar debug</code>

{{Code|Code=
./aes.rb --showcalendar
}}
Lists the current entries of the internal calendar. Calendar entries define times when the server does not suspend. Also, the server will be woken up at the beginning of a calendar entry.

{{Code|Code=
./aes.rb --addcalendar startdate starttime stopdate stoptime
}}
Use this command to add an entry to the internal calendar. Format of startdate/stopdate: YYYY-MM-DD Format of starttime/stoptime: hhm:mm. Eg.
 <code>./aes.rb --addcalendar 2010-12-20 15:00 2010-12-20 16:00</code> 
will keep the server awake on Dec 20th, 2010 from 15 to 16 hrs (3 to 4 pm). The server will also wake up at 15 hrs if it is suspended.

{{Code|Code=
./aes.rb --shutdowntype
}}
Show and modifiy the type of shutdown. NOTE: Not all shutdown types may be supported on your system, or may work correctly. Therefore, test that your machine is suspending and coming up correctly before deciding for a setting. Poweroff is safest type.

{{Code|Code=
./aes.rb --sbs [on, off, debug]
}}
<code>./aes.rb --sbs</code> shows the current setting. <code>./aes.rb --sbs on</code> and <code>./aes.rb --sbs off</code> switch monitoring of Squeezeboxserver on or off, respectively. The command <code>./aes.rb --sbs debug</code> displays diagnostic information

{{Code|Code=
./aes.rb --interval
}}
aes checks regularly if the system can be suspended or shut down. This parameter specifies the time in seconds between two such checks. Normally should be left untouched.

{{Code|Code=
./aes.rb --showenergybalance
}}
View the energy savings in kWh due to the use of Amahi Energy Saver.

{{Code|Code=
./aes.rb --setpowerconsumption pc_on pc_standby
}}
Set the average power consumption when working ("pc_on") and powered off ("pc_standby"). Values given in Watts. pc_on must be greater than pc_standby.

{{Code|Code=
./aes.rb --help
}}
Displays command line help

Amahi Energy Saver

2011-06-09T14:18:29Z

Amahivirtual:

[[Image:Amahi-Energy-Saver_Logo.png|150px]] 

==General==

This is in solid beta stage. Installation requires a little Linux knowledge.

If you like it, like it on facebook: http://www.facebook.com/pages/Amahi-Energy-Saver/218015224890441?sk=wall

==Introduction==
Running servers when they are not needed can waste a considerable amount of energy. This application tells your Amahi server to suspend or power off when its services are not needed.

Amahi Energy Saver regularly scans for connected clients, which are defined in the "monitored host list". If none of these clients is turned on, the system suspends after a configurable period.

So, for instance, you may want to add your client PC and your PS3 to the monitored host list. The Amahi Box will then stay up and running as long as client PC and/or PS3 are up and running. However, you might not want to add your home router to the list, as the router is always turned on.

With the calendar function one can define scheduled wake ups and periods during which the server shall stay awake no matter what.

Amahi Energy Saver also checks shares. As long as shares are accessed, the server does not suspend. If set up to do so, Squeezeboxserver is monitored to prevent suspend while Squeezeboxes are turned on.

When the system is to be used again, simply wake it up with WOL (ref. http://en.wikipedia.org/wiki/Wake-on-LAN). There are many tools to generate WOL packets, and it is even possible to wake your server over the internet (good link: http://www.wakeonlan.me/).

==Download==

Download the latest tested and released version here: http://code.google.com/p/amahienergysaver/downloads/list

Latest untested sources are available at Git:
https://github.com/jayrockk/Amahi-Energy-Saver

==Initial setup==

1. Copy the tar.gz file from the download page to some folder and unpack it with

{{Code|Code=
tar -zxf filename
}}

2. Open a terminal, change to that folder and get superuser rights by running <code>su</code>

3. As root, run
{{Code|Code=
cd installfiles
}}
{{Code|Code=
./aes-install.sh
}}

4. When the installation is finished, reboot the computer. The config app is accessible at

{{Code|Code=
http://hda:6500
}}

==Integration with Amahi calendar==
1. In the config app, select ical in the Calendar field.

2. Hit the "Apply button in the config app

3. Connect your client to the new calendar. NOTE: Please read this article if you are unsure how to do this: [[Calendars]]

4. Use your favourite calendar client to populate the calendar with events.

Done! Your HDA will now wake up and stay powered on according to the events defined in the aes calendar.

==Selecting ShutdownType==

The different options for ShutdownType are explained here: 

Deactivated
Amahi Energy Saver is running in the background, however it will never shutdown or suspend the HDA.

Poweroff
This is a full shutdown and should work on most systems. Some mainboards do not allow scheduled wakeup when using this method. 

ACPI_S1
Legacy ACPI S1 state. Support depends on mainboard and Fedora support 

ACPI_S3
Legacy ACPI S3 state. Support depends on mainboard and Fedora support 

ACPI_S4
Legacy ACPI S4 state. Support depends on mainboard and Fedora support 

mem
Suspend to memory, is intended to replace ACPI S1 but is not widely supported yet 

disk
Suspend to disk, is intended to replace ACPI S4 but is not widely supported yet 

standby
Suspend to memory, is intended to replace ACPI S3 but is not widely supported yet 

When selecting the shutdown type the following procedure is suggested: 

* Start with Poweroff to do basic checking and configuration. Since this is the safest version, it should also be your resort in case of problems. 

* Once things are working, select either of the ACPI_S1..3 depending on what level of suspend you want 

* If you are brave or the ACPI options don't work, try mem, disk or standby. 

==Logs==
Logs are located in /usr/share/aes and named aes.log*

==OBSELETE: Command Line Interface==
*Note: Root privileges are required to execute the CLI command. Navigate to /usr/share/aes to use the CLI correctly.

{{Code|Code=
./aes.rb --shownetworkhosts
}}
Lists the hosts found in the network, ie, all devices connected to the network. Gives the user the choice to add hosts to the monitored host list.

{{Code|Code=
./aes.rb --showmonitoredhosts
}}
Show a list of all hosts which are monitored by AES (i.e. the monitored host list), and also allows to delete hosts from the list. If these hosts are up and running (and respond to ping), the server does not suspend.

{{Code|Code=
./aes.rb --addhost macadress
}}
Manually add a host to the monitored host list. Observe the MAC address format, which has to be XX:XX:XX:XX:XX:XX. Example is <code>./aes.rb --addhost 12:34:56:78:90:ab</code>

{{Code|Code=
./aes.rb --calendar [off, internal, ical, debug]
}}
<code>./aes.rb --calendar</code> shows the current setting.
<code>./aes.rb --calendar off</code> turns the calendar off,
<code>./aes.rb --calendar internal</code> makes aes use its internal calendar function and
<code>./aes.rb --calendar ical</code> activates the Amahi calendar integration. To show diag information use <code>./aes.rb --calendar debug</code>

{{Code|Code=
./aes.rb --showcalendar
}}
Lists the current entries of the internal calendar. Calendar entries define times when the server does not suspend. Also, the server will be woken up at the beginning of a calendar entry.

{{Code|Code=
./aes.rb --addcalendar startdate starttime stopdate stoptime
}}
Use this command to add an entry to the internal calendar. Format of startdate/stopdate: YYYY-MM-DD Format of starttime/stoptime: hhm:mm. Eg.
 <code>./aes.rb --addcalendar 2010-12-20 15:00 2010-12-20 16:00</code> 
will keep the server awake on Dec 20th, 2010 from 15 to 16 hrs (3 to 4 pm). The server will also wake up at 15 hrs if it is suspended.

{{Code|Code=
./aes.rb --shutdowntype
}}
Show and modifiy the type of shutdown. NOTE: Not all shutdown types may be supported on your system, or may work correctly. Therefore, test that your machine is suspending and coming up correctly before deciding for a setting. Poweroff is safest type.

{{Code|Code=
./aes.rb --sbs [on, off, debug]
}}
<code>./aes.rb --sbs</code> shows the current setting. <code>./aes.rb --sbs on</code> and <code>./aes.rb --sbs off</code> switch monitoring of Squeezeboxserver on or off, respectively. The command <code>./aes.rb --sbs debug</code> displays diagnostic information

{{Code|Code=
./aes.rb --interval
}}
aes checks regularly if the system can be suspended or shut down. This parameter specifies the time in seconds between two such checks. Normally should be left untouched.

{{Code|Code=
./aes.rb --showenergybalance
}}
View the energy savings in kWh due to the use of Amahi Energy Saver.

{{Code|Code=
./aes.rb --setpowerconsumption pc_on pc_standby
}}
Set the average power consumption when working ("pc_on") and powered off ("pc_standby"). Values given in Watts. pc_on must be greater than pc_standby.

{{Code|Code=
./aes.rb --help
}}
Displays command line help

==Windows client for Wake on LAN==
On the download page there is a Windows client for automatic or manual wakeup of the HDA.

*Installation

Just run the msi file found on the download page. The client will be included in the startup folder.

*Configuration

1. Form the start menu, run AmahiEnergySaver -> AES Client

2. Right click on the icon that will appear in symbol bar, and select "Show config"

3. To get started, make sure that you set "Host MAC" and "Host name" to your HDA configuration. Hit "Select Server" to bring up the "Select HDA" window, and then "Search". If possible the correct server is alreday selected, in that case just hit "Ok" to confirm. Continue with 4. 
If the server appears on the list but is not automatically selected, click on it and hit return. 
Should your server not show up at all, press "Cancel" to exit the "Select HDA" dialog and configure MAC and host name manually. 
Finally, if requried, change the "Port" setting. The default "9" should work in most cases. 

4. Hit the "OK" butten, then right click on the symbol again, select "Exit" and and restart the program as described in 1.

5. Done! You should now be able to start your HDA by right clicking on the icon in the symbol bar and select "Wake now"

==Mac OS X clients for Wake on LAN==

There exist a few solutions (WOL clients) to wake up your HDA from a Mac OS X computer. In order to wake up your HDA while booting your Mac you may use NASwake (ref. http://trick77.com/2010/12/22/wake-nas-at-boot-time-wake-on-lan-wol/). It comes ready to use as an installable package, you just need to enter the MAC-adress of the HDA. 
WakeOnLan is a freeware application provided by Readpixel which offers a very comfortable way to wake up your HDA directly from your Mac OS X desktop (ref. http://www.readpixel.com/wakeonlan/index.html).

Amahi Energy Saver

2011-06-09T14:16:55Z

Amahivirtual: Added chapter for Mac OS X clients for Wake on LAN

[[Image:Amahi-Energy-Saver_Logo.png|150px]] 

==General==

This is in solid beta stage. Installation requires a little Linux knowledge.

If you like it, like it on facebook: http://www.facebook.com/pages/Amahi-Energy-Saver/218015224890441?sk=wall

==Introduction==
Running servers when they are not needed can waste a considerable amount of energy. This application tells your Amahi server to suspend or power off when its services are not needed.

Amahi Energy Saver regularly scans for connected clients, which are defined in the "monitored host list". If none of these clients is turned on, the system suspends after a configurable period.

So, for instance, you may want to add your client PC and your PS3 to the monitored host list. The Amahi Box will then stay up and running as long as client PC and/or PS3 are up and running. However, you might not want to add your home router to the list, as the router is always turned on.

With the calendar function one can define scheduled wake ups and periods during which the server shall stay awake no matter what.

Amahi Energy Saver also checks shares. As long as shares are accessed, the server does not suspend. If set up to do so, Squeezeboxserver is monitored to prevent suspend while Squeezeboxes are turned on.

When the system is to be used again, simply wake it up with WOL (ref. http://en.wikipedia.org/wiki/Wake-on-LAN). There are many tools to generate WOL packets, and it is even possible to wake your server over the internet (good link: http://www.wakeonlan.me/).

==Download==

Download the latest tested and released version here: http://code.google.com/p/amahienergysaver/downloads/list

Latest untested sources are available at Git:
https://github.com/jayrockk/Amahi-Energy-Saver

==Initial setup==

1. Copy the tar.gz file from the download page to some folder and unpack it with

{{Code|Code=
tar -zxf filename
}}

2. Open a terminal, change to that folder and get superuser rights by running <code>su</code>

3. As root, run
{{Code|Code=
cd installfiles
}}
{{Code|Code=
./aes-install.sh
}}

4. When the installation is finished, reboot the computer. The config app is accessible at

{{Code|Code=
http://hda:6500
}}

==Integration with Amahi calendar==
1. In the config app, select ical in the Calendar field.

2. Hit the "Apply button in the config app

3. Connect your client to the new calendar. NOTE: Please read this article if you are unsure how to do this: [[Calendars]]

4. Use your favourite calendar client to populate the calendar with events.

Done! Your HDA will now wake up and stay powered on according to the events defined in the aes calendar.

==Selecting ShutdownType==

The different options for ShutdownType are explained here: 

Deactivated
Amahi Energy Saver is running in the background, however it will never shutdown or suspend the HDA.

Poweroff
This is a full shutdown and should work on most systems. Some mainboards do not allow scheduled wakeup when using this method. 

ACPI_S1
Legacy ACPI S1 state. Support depends on mainboard and Fedora support 

ACPI_S3
Legacy ACPI S3 state. Support depends on mainboard and Fedora support 

ACPI_S4
Legacy ACPI S4 state. Support depends on mainboard and Fedora support 

mem
Suspend to memory, is intended to replace ACPI S1 but is not widely supported yet 

disk
Suspend to disk, is intended to replace ACPI S4 but is not widely supported yet 

standby
Suspend to memory, is intended to replace ACPI S3 but is not widely supported yet 

When selecting the shutdown type the following procedure is suggested: 

* Start with Poweroff to do basic checking and configuration. Since this is the safest version, it should also be your resort in case of problems. 

* Once things are working, select either of the ACPI_S1..3 depending on what level of suspend you want 

* If you are brave or the ACPI options don't work, try mem, disk or standby. 

==Logs==
Logs are located in /usr/share/aes and named aes.log*

==OBSELETE: Command Line Interface==
*Note: Root privileges are required to execute the CLI command. Navigate to /usr/share/aes to use the CLI correctly.

{{Code|Code=
./aes.rb --shownetworkhosts
}}
Lists the hosts found in the network, ie, all devices connected to the network. Gives the user the choice to add hosts to the monitored host list.

{{Code|Code=
./aes.rb --showmonitoredhosts
}}
Show a list of all hosts which are monitored by AES (i.e. the monitored host list), and also allows to delete hosts from the list. If these hosts are up and running (and respond to ping), the server does not suspend.

{{Code|Code=
./aes.rb --addhost macadress
}}
Manually add a host to the monitored host list. Observe the MAC address format, which has to be XX:XX:XX:XX:XX:XX. Example is <code>./aes.rb --addhost 12:34:56:78:90:ab</code>

{{Code|Code=
./aes.rb --calendar [off, internal, ical, debug]
}}
<code>./aes.rb --calendar</code> shows the current setting.
<code>./aes.rb --calendar off</code> turns the calendar off,
<code>./aes.rb --calendar internal</code> makes aes use its internal calendar function and
<code>./aes.rb --calendar ical</code> activates the Amahi calendar integration. To show diag information use <code>./aes.rb --calendar debug</code>

{{Code|Code=
./aes.rb --showcalendar
}}
Lists the current entries of the internal calendar. Calendar entries define times when the server does not suspend. Also, the server will be woken up at the beginning of a calendar entry.

{{Code|Code=
./aes.rb --addcalendar startdate starttime stopdate stoptime
}}
Use this command to add an entry to the internal calendar. Format of startdate/stopdate: YYYY-MM-DD Format of starttime/stoptime: hhm:mm. Eg.
 <code>./aes.rb --addcalendar 2010-12-20 15:00 2010-12-20 16:00</code> 
will keep the server awake on Dec 20th, 2010 from 15 to 16 hrs (3 to 4 pm). The server will also wake up at 15 hrs if it is suspended.

{{Code|Code=
./aes.rb --shutdowntype
}}
Show and modifiy the type of shutdown. NOTE: Not all shutdown types may be supported on your system, or may work correctly. Therefore, test that your machine is suspending and coming up correctly before deciding for a setting. Poweroff is safest type.

{{Code|Code=
./aes.rb --sbs [on, off, debug]
}}
<code>./aes.rb --sbs</code> shows the current setting. <code>./aes.rb --sbs on</code> and <code>./aes.rb --sbs off</code> switch monitoring of Squeezeboxserver on or off, respectively. The command <code>./aes.rb --sbs debug</code> displays diagnostic information

{{Code|Code=
./aes.rb --interval
}}
aes checks regularly if the system can be suspended or shut down. This parameter specifies the time in seconds between two such checks. Normally should be left untouched.

{{Code|Code=
./aes.rb --showenergybalance
}}
View the energy savings in kWh due to the use of Amahi Energy Saver.

{{Code|Code=
./aes.rb --setpowerconsumption pc_on pc_standby
}}
Set the average power consumption when working ("pc_on") and powered off ("pc_standby"). Values given in Watts. pc_on must be greater than pc_standby.

{{Code|Code=
./aes.rb --help
}}
Displays command line help

==Windows client for Wake on LAN==
On the download page there is a Windows client for automatic or manual wakeup of the HDA.

*Installation

Just run the msi file found on the download page. The client will be included in the startup folder.

*Configuration

1. Form the start menu, run AmahiEnergySaver -> AES Client

2. Right click on the icon that will appear in symbol bar, and select "Show config"

3. To get started, make sure that you set "Host MAC" and "Host name" to your HDA configuration. Hit "Select Server" to bring up the "Select HDA" window, and then "Search". If possible the correct server is alreday selected, in that case just hit "Ok" to confirm. Continue with 4. 
If the server appears on the list but is not automatically selected, click on it and hit return. 
Should your server not show up at all, press "Cancel" to exit the "Select HDA" dialog and configure MAC and host name manually. 
Finally, if requried, change the "Port" setting. The default "9" should work in most cases. 

4. Hit the "OK" butten, then right click on the symbol again, select "Exit" and and restart the program as described in 1.

5. Done! You should now be able to start your HDA by right clicking on the icon in the symbol bar and select "Wake now"

==Mac OS X clients for Wake on LAN==

There exist a few solutions (WOL clients) to wake up your HDA from a Mac OS X computer. In order to wake up your HDA while booting your Mac you may use NASwake (ref. http://trick77.com/2010/12/22/wake-nas-at-boot-time-wake-on-lan-wol/). It comes ready to use as an installable package, you just need to enter the MAC-adress of the HDA. 
WakeOnLan is a freeware application provided by Readpixel which offers a very comfortable way to wake up your HDA directly from your Mac OS X desktop (ref. http://www.readpixel.com/wakeonlan/index.html)