5,576
edits
Changes
From SME Server
Jump to navigationJump to search→Signalling events : Signal-event
[[SME_Server:Documentation:Developers_Manual:Chapter7#Standard_events_and_their_arguments]]
[[SME_Server:Documentation:Developers_Manual:Chapter7#Standard_events_and_their_arguments]]
{| class="CALSTABLE" border="1"
|+SME Server standard events
! Event
! Argument
! Description
|-
| bootstrap-console-save
| (none)
| Expands all templates in the system. It is a <span class="emphasis">''requirement''</span> that all templates are correct after a combination of post-upgrade/reboot. Called after the initial console wizard, after system upgrades, and as part of a reconfiguration reboot.
|-
| console-save
| (none)
| Expands templates and reconfigures services which can be changed from the text-mode console and which do not require a reboot. Services which do require a reboot for configuration will be handled by bootstrap-console-save. The console-save event is <span class="emphasis">''not''</span> a general "reconfigure everything" event.
|-
| email-update
| (none)
| Reconfigures services listed on the e-mail panel.
|-
| group-create, group-delete, group-modify
| Group - key into accounts database
| Called when a group is created/deleted/modified.
|-
| halt
| (none)
| Called when the system is being shutdown prior to power off.
|-
| host-create, host-delete, host-modify
| Host - key into hosts database
| Called when a host is created, deleted or modified.
|-
| ibay-create, ibay-delete, ibay-modify
| Ibay - key into accounts database
| Called when an information bay is created/deleted/modified.
|-
| ip-change
| New external IP address
| Called when the external IP address changes, e.g. through a new PPPoE connection or DHCP lease.
|-
| local
| (none)
| Called after each reboot. Customisations which would normally require modification of the <tt class="FILENAME">/etc/rc.local</tt> file should instead be installed as individual scripts in the <tt class="FILENAME">/etc/e-smith/events/local/</tt> event directory.
|-
| network-create, network-delete
| Network - key into networks database
| Called when a local network is created or deleted.
|-
| password-modify
| User - key into accounts database
| Called when a user password is modified, including when the account is unlocked.
|-
| post-upgrade (and post-install)
| (none)
| Called as final step of the CD upgrade (install). <span class="emphasis">''This event must be immediately followed by a reboot.''</span> The bootstrap-console-save event is then called after the reboot to complete the reconfiguration. The only changes which should occur in this event are ones which must be performed prior to the reboot (e.g. configuring the boot loader). The post-install event is only called once, from the CD installer.
|-
| pre-backup, post-backup
| Cause - type of backup being performed (e.g. "tape")
| The pre-backup event creates consistent system state for the backup. For example, it creates an ASCII dump of the MySQL databases. If the pre-backup event fails, the backup is <span class="emphasis">''not''</span> run. The post-backup is called if the backup is successful and removes the state files generated by pre-backup.
|-
| pseudonym-create, pseudonym-delete, pseudonym-modify
| Pseudonym - key into accounts database
| Called when a pseudonym is created/deleted/modified.
|-
| reboot
| (none)
| Called when the system is being shutdown prior to a reboot.
|-
| remoteaccess-update
| (none)
| Reconfigures services listed on the Remote Access panel and updates the firewall rules for all services.
|-
| user-create, user-delete, user-modify
| User - key into accounts database
| Called when a user is created/deleted/modified.
|-
| user-lock
| User - key into accounts database
| Called when a user account is locked.
|}
</div></div><div class="SECT2">
----
----
[[Category:Howto]]
[[Category:Howto]]
