Changes between Version 2 and Version 3 of ClientSetupLogicWin

Timestamp:

May 24, 2007, 9:09:39 PM (19 years ago)

Author:

romw

Comment:

Check Point 2

ClientSetupLogicWin

@@ -37 +37 @@
 
 The following custom actions were designed specifically for BOINC:
+
+=== CARestoreSetupState ===
+
+Restore the previous setup parameters from the registry.
+
+Registry location: HKLM\Software\Space Sciences Laboratory, U.C. Berkeley\BOINC Setup
+
+|| Execution After:     || ISSetupFilesExtract ||
+|| Execution Condition: || ||
+
+Pseudocode:
+{{{
+GetRegistryValue( "INSTALLDIR", strInstallDirectory );
+GetRegistryValue( "SETUPTYPE", strSetupType );
+GetRegistryValue( "LAUNCHPROGRAM", strLaunchProgram );
+GetRegistryValue( "ENABLELAUNCHATLOGON", strEnableLaunchAtLogon );
+GetRegistryValue( "ENABLESCREENSAVER", strEnableScreensaver );
+GetRegistryValue( "SERVICE_DOMAIN", strServiceDomain );
+GetRegistryValue( "SERVICE_USERNAME", strServiceUsername );
+
+SET INSTALLDIR TO strInstallDirectory
+SET SETUPTYPE TO strSetupType
+SET LAUNCHPROGRAM TO strLaunchProgram
+SET ENABLELAUNCHATLOGON TO strEnableLaunchAtLogon
+SET ENABLESCREENSAVER TO strEnableScreensaver
+SET SERVICE_DOMAIN TO strServiceDomain
+SET SERVICE_USERNAME TO strServiceUsername
+
+RETURN SUCCESS
+}}}
+
+=== CASaveSetupState ===
+
+Save the current setup parameters to the registry.
+
+Registry location: HKLM\Software\Space Sciences Laboratory, U.C. Berkeley\BOINC Setup
+
+|| Execution After:     || ExecuteAction ||
+|| Execution Condition: || ||
+
+Pseudocode:
+{{{
+GET INSTALLDIR STORE strInstallDirectory
+GET SETUPTYPE STORE strSetupType
+GET LAUNCHPROGRAM STORE strLaunchProgram
+GET ENABLELAUNCHATLOGON STORE strEnableLaunchAtLogon
+GET ENABLESCREENSAVER STORE strEnableScreensaver
+GET SERVICE_DOMAIN STORE strServiceDomain
+GET SERVICE_USERNAME STORE strServiceUsername
+
+SetRegistryValue( "INSTALLDIR", strInstallDirectory );
+SetRegistryValue( "SETUPTYPE", strSetupType );
+SetRegistryValue( "LAUNCHPROGRAM", strLaunchProgram );
+SetRegistryValue( "ENABLELAUNCHATLOGON", strEnableLaunchAtLogon );
+SetRegistryValue( "ENABLESCREENSAVER", strEnableScreensaver );
+SetRegistryValue( "SERVICE_DOMAIN", strServiceDomain );
+SetRegistryValue( "SERVICE_USERNAME", strServiceUsername );
+SetRegistryValue( "SETUPSTATESTORED", strSetupStateStored );
+
+RETURN SUCCESS
+}}}
 
 === CAValidateSetupType ===
@@ -61 +122 @@
 RETURN SUCCESS
 }}}
+
+=== CAValidateServiceAccount ===
+
+Validates the service parameters passed to the execution phase.
+
+|| Execution After:     || CAValidateSetupType ||
+|| Execution Condition: || VersionNT AND (SETUPTYPE = "Service OR SETUPTYPE = "ServiceGUI") ||
+
+Pseudocode:
+{{{
+IF ServicePassword IS NULL
+    IF (ServiceDomainUsername IS NOT 'LOCALSYSTEM') AND (ServiceDomainUsername IS NOT 'NetworkService')
+        RETURN ERROR
+    END IF
+END IF
+
+IF ServiceDomainUsername IS NULL
+    IF (ServiceDomain IS NULL) OR (ServiceUsername IS NULL)
+        RETURN ERROR
+    END IF
+ELSE
+    SET ServiceDomain TO "Domain portion of ServiceDomainUsername"
+    SET ServiceUsername TO "Username portion of ServiceDomainUsername"
+END IF
+
+RETURN SUCCESS
+}}}
+
+=== CAShutdownBOINC ===
+
+Gracefully shutdown BOINC if it is running, if that fails terminate it.
+
+|| Execution After:     || CAValidateServiceAccount ||
+|| Execution Condition: || VersionNT AND NOT INSTALLED ||
+
+Pseudocode:
+{{{
+IF BOINCIsRunning() = TRUE
+    ShutdownBOINC()
+END IF
+TerminateBOINC()
+
+RETURN SUCCESS
+}}}
+
+=== CAShutdownBOINCManager ===
+
+Gracefully shutdown BOINC Manager if it is running, if that fails terminate it.
+
+|| Execution After:     || CAShutdownBOINC ||
+|| Execution Condition: || VersionNT AND NOT INSTALLED ||
+
+Pseudocode:
+{{{
+IF BOINCManagerIsRunning() = TRUE
+    ShutdownBOINCManager()
+END IF
+TerminateBOINCManager()
+
+RETURN SUCCESS
+}}}
+
+=== CAShutdownBOINCManager95 ===
+
+Gracefully shutdown BOINC Manager if it is running, if that fails terminate it.
+
+|| Execution After:     || CAShutdownBOINCManager ||
+|| Execution Condition: || Version95 AND NOT INSTALLED ||
+
+Pseudocode:
+{{{
+IF BOINCManagerIsRunning() = TRUE
+    ShutdownBOINCManager()
+END IF
+TerminateBOINCManager()
+
+RETURN SUCCESS
+}}}
+
+=== CAShutdownBOINCScreensaver ===
+
+Gracefully shutdown BOINC Screensaver if it is running, if that fails terminate it.
+
+|| Execution After:     || CAShutdownBOINCManager95 ||
+|| Execution Condition: || VersionNT AND NOT INSTALLED ||
+
+Pseudocode:
+{{{
+IF BOINCScreensaverIsRunning() = TRUE
+    ShutdownBOINCScreensaver()
+END IF
+TerminateBOINCScreensaver()
+
+RETURN SUCCESS
+}}}
+
+=== CAMigratex86x64 ===
+
+Migrate BOINC Data from the 32-bit application storage location to the 64-bit application storage location.
+
+|| Execution After:     || CAShutdownBOINCScreensaver ||
+|| Execution Condition: || ||
+
+Pseudocode:
+{{{
+MoveFileEx(
+    "C:\Program Files (x86)\BOINC",
+    InstallDir,
+    MOVEFILE_COPY_ALLOWED|MOVEFILE_WRITE_THROUGH
+)
+
+RETURN SUCCESS
+}}}
+
+=== CAMigrateCPDNBBC ===
+
+Migrate the CPDNBBC data from the specialized CPDNBBC directory to the standard BOINC installation directory.
+
+|| Execution After:     || CAMigratex86x64 ||
+|| Execution Condition: || ||
+
+Pseudocode:
+{{{
+MoveFileEx(
+    "C:\Program Files\Climate Change Experiment",
+    InstallDir,
+    MOVEFILE_COPY_ALLOWED|MOVEFILE_WRITE_THROUGH
+)
+
+RETURN SUCCESS
+}}}
+
+=== CACleanupOldBinaries ===
+
+After uninstalling any older versions of BOINC, make sure all BOINC related binaries have been deleted from the system.
+
+|| Execution After:     || CAMigrateCPDNBBC ||
+|| Execution Condition: || ||
+
+Pseudocode:
+{{{
+DeleteFile(InstallDir + "\boinc.exe");
+DeleteFile(InstallDir + "\boincmgr.exe");
+DeleteFile(InstallDir + "\boinccmd.exe");
+DeleteFile(InstallDir + "\boinc.dll");
+DeleteFile(InstallDir + "\libcurl.dll");
+DeleteFile(InstallDir + "\libeay32.dll");
+DeleteFile(InstallDir + "\ssleay32.dll");
+DeleteFile(InstallDir + "\zlib1.dll");
+DeleteFile(InstallDir + "\dbghelp.dll");
+DeleteFile(InstallDir + "\dbghelp95.dll");
+DeleteFile(InstallDir + "\srcsrv.dll");
+DeleteFile(InstallDir + "\symsrv.dll");
+
+RETURN SUCCESS
+}}}
+
+=== CAGrantServiceExecutionRight ===
+
+Make sure the service user account is allowed to execute services.
+
+|| Execution After:     || InstallInitialize ||
+|| Execution Condition: || VersionNT And (SETUPTYPE = "Service" Or SETUPTYPE = "ServiceGUI") And SERVICE_GRANTEXECUTIONRIGHT = "1" ||
+
+Pseudocode:
+{{{
+pSID = GetAccountSid(ServiceDomainUsername)
+SetPrivilegeOnAccount(
+    pSID,
+    "SeServiceLogonRight",
+    TRUE
+)
+
+RETURN SUCCESS
+}}}
+
+=== CAGetAdministratorsGroupName ===
+
+Convert the well known group SID into the human readable localized version of the name.
+
+|| Execution After:     || CAGrantServiceExecutionRight ||
+|| Execution Condition: || VersionNT ||
+
+Pseudocode:
+{{{
+GroupName = LookupAliasFromRid(NULL, DOMAIN_ALIAS_RID_ADMINS)
+SET GROUPALIAS_ADMINISTRATORS TO GroupName
+
+
+RETURN SUCCESS
+}}}
+
+=== CAGetAdministratorsUsersName ===
+
+Convert the well known group SID into the human readable localized version of the name.
+
+|| Execution After:     || CAGrantServiceExecutionRight ||
+|| Execution Condition: || VersionNT ||
+
+Pseudocode:
+{{{
+GroupName = LookupAliasFromRid(NULL, DOMAIN_ALIAS_RID_USERS)
+SET GROUPALIAS_USERS TO GroupName
+
+
+RETURN SUCCESS
+}}}
+