Archive. Posts from 2004 to 2016, kept as they were written. My current blog is at dariuszparys.com.

Mit Windows Server 2008 (und bereits mit Windows Vista) erscheint eine API die es Installationsroutinen einfacher macht die Anzahl möglicher Reboots zu reduzieren. Mit der Restart Manager API können Prozesse ermittelt werden die bestimmte Resourcen verwenden. Möchte man zum Beispiel eine DLL austauschen kann man erfragen welche Anwendungen momentan diese DLL nutzen und diese gegebenfalls runterfahren und neu starten.

Nehmen wir an wir möchten eine Anwendung aktualisieren und müssen hierzu drei verschiedene Dienste runterfahren, IIS Admin, SQL Server und MSMQ. Diese Dienste haben unter Umständen Abhängigkeiten die so von System zu System variieren können. Mittels der Restart Manager API kann man diese Abhängigkeiten ermitteln und auch sehen ob diese sich mitkontrollieren lassen.

Zuerst muss man die Restart Manager API initializieren in dem man eine Session beginnt. Das Konzept der Session erlaubt es unterschiedliche Installationsroutinen mit denselben Resourcen zu arbeiten.

DWORD result = 0;
DWORD sessionHandle = -1;
WCHAR sessionKey[ CCH_RM_SESSION_KEY + 1 ];

result = ::RmStartSession( &sessionHandle, 0, sessionKey );
if( result != ERROR_SUCCESS )
{
    goto rmend;
}

Als nächstes werden die Resourcen welche man prüfen möchte übergeben. Hier übergibt man der Struktur Windows Dienste, Filenamen und Prozessnamen. In diesem Beispiel nur die drei Dienstnamen.

DWORD fileCount = 0;
DWORD serviceCount = 3;
DWORD processCount = 0;

LPCWSTR services[] = { L"IISADMIN", L"MSSQLSERVER", L"MSMQ" };
LPCWSTR files[] = NULL;

UINT processInfo = 200;
UINT processInfoNeeded;
RM_PROCESS_INFO* affectedApplications = NULL;
DWORD rebootReason = 0;

affectedApplications = new RM_PROCESS_INFO[ processInfo ];

result = ::RmRegisterResources( sessionHandle,
             fileCount,
             files,
             processCount,
             NULL,
             serviceCount,
             services );
if( result != ERROR_SUCCESS )
{
    goto rmend;
}

Natürlich müsste man noch prüfen ob der übergebene Speicher der Struktur ausreicht und entsprechend beim Fehlercode nach mehr Speicherbedarf mehr Speicher allokieren, der Einfachheit halber hier komplett weggelassen.

Nachdem die Resourcen registriert sind, kann man sich nun eine Liste der Abhängigkeiten geben lassen.

result = ::RmGetList( sessionHandle,
             &processInfoNeeded,
             &processInfo,
             affectedApplications,
             &rebootReason );
if( result != ERROR_SUCCESS )
{
    goto rmend;
}

affectedApplications liefert uns nun die betroffenen Anwendungen. Hier der Ausdruck auf der Console nach diesem Aufruf.

shot1

Zwei weitere Anwendungen vom Typ Windows Dienst (Service) werden durch die Rückgabestruktur gemeldet. Net.Msmq Listener und Message Queuing Triggers. Alle 5 Dienste sind gerade am laufen und lassen sich auch neu starten wie das Restartable: Yes anzeigt.

Nun käme der Zeitpunkt der eigentlichen Installationsroutine. Zum einen müssten die Dienste nun gestoppt werden,

result = ::RmShutdown( sessionHandle, 0, NULL );
if( result != ERROR_SUCCESS )
{
    goto rmend;
}

danach kann man auf alle geblockten Resourcen zugreifen und diese austauschen. Jetzt folgt die Installationsroutine. Ist man damit fertig startet man die Dienste auf einen Schlag.

result = ::RmRestart( sessionHandle, 0, NULL );

Um einen problematischeren Fall zu betrachten, hier ein Beispiel mit der OleAut32.dll.

LPCWSTR services[] = NULL;
LPCWSTR files[] = { L"C:\\windows\\system32\\oleaut32.dll" };

UINT processInfo = 200;
UINT processInfoNeeded;
RM_PROCESS_INFO* affectedApplications = NULL;
DWORD rebootReason = 0;

affectedApplications = new RM_PROCESS_INFO[ processInfo ];

::RmRegisterResources( sessionHandle,
             fileCount,
             files,
             processCount,
             NULL,
             serviceCount,
             services );

::RmGetList( sessionHandle,
             &processInfoNeeded,
             &processInfo,
             affectedApplications,
             &rebootReason );

Hier sieht die Ergebnismenge schon deutlich anders aus.

shot2

Die rotmarkierten Zeilen sind Anwendungen die diese DLL aktiv angezogen haben und auch nicht über den Restartmanager gestartet werden können. Hier muss die Installationsroutine im Reboot die entsprechende Aktion bewerkstelligen um zum Beispiel die oleaut32.dll auszutauschen. Anmerkung: OleAut32.dll bitte nicht anrühren, ist nur ein Beispiel einer blockierten DLL.

Durch das Konzept der Session können nun Installationen auch weitere Installationsroutinen starten und den Sessionkey mitübergeben. Resourcen die einen Systemreboot benötigen werden angezeigt. Man kann nun in seiner Installationsroutine erstmal die notwendigen anderen Resourcen installatieren, löschen, austauschen die keinen Maschinenreboot benötigen und hebt sich die kritischen zum Schluß auf. Mit Hilfe der API lassen sich so Installationsroutinen intelligenter verbinden und Systemreboots auf ein minimum reduzieren.