Contents
Preface 5
About This Guide ........................................................................................................................... 5
Typographical Conventions ........................................................................................................... 5
Feedback ....................................................................................................................................... 6
H-Sphere System Database 7
Getting User Information from the Parallels H-Sphere System Database .................................... 8
Database Connections ................................................................................................................ 12
Regular Shared Connections ............................................................................................ 12
Connections With Opened Transaction ............................................................................ 12
Unix Hosting Resources and Tools 14
Creating Unix-Hosted Resources ................................................................................................ 15
Example: ............................................................................................................................ 20
Global Resources And Resource Dependencies ........................................................................ 25
globals.xml ......................................................................................................................... 25
resource_dependences.xml .............................................................................................. 29
List of Resource Dependencies ........................................................................................ 29
Account Preferences ................................................................................................................... 32
TimeUtils Class ............................................................................................................................ 32
FreeMarker Access Control List (FMACL) Objects ..................................................................... 34
Purpose ............................................................................................................................. 34
Implementation .................................................................................................................. 34
External Credits ........................................................................................................................... 36
Running Parallels H-Sphere in Debug Mode .............................................................................. 37
Script Runner ............................................................................................................................... 38
Windows Hosting Resources 39
Creating Resources for Winbox ................................................................................................... 40
Introduction ........................................................................................................................ 40
Requirements .................................................................................................................... 40
Naming Conventions ......................................................................................................... 40
General Scheme of Resource Functioning ....................................................................... 41
Methods ............................................................................................................................. 42
Keys ................................................................................................................................... 43
Error Handling ................................................................................................................... 44
Resource Hierarchy ........................................................................................................... 45
Logging .............................................................................................................................. 45
Resource Types ................................................................................................................ 46
Schemas ............................................................................................................................ 46
Attributes ........................................................................................................................... 47
Crash Reporting on Winbox ........................................................................................................ 52
Crash Record File Structure .............................................................................................. 52
Detecting Crashes in Parallels H-Sphere and non Parallels H-Sphere Modules ............. 53
IIS 6.0 Native Mode ..................................................................................................................... 53
ISAPI Filters ....................................................................................................................... 54
IIS Log Plugin .................................................................................................................... 54