This chapter includes these topics: • Overview, page 75
• Installing with an MSI or InstallShield installer, page 75
• Installing with a non-MSI or non-InstallShield installer, page 76
Overview
DAC SDK includes a merge module that an MSI or InstallShield installer can use. If you use another installer, manual instructions for the files and services that need to be installed are provided.
You need to install these services:
• EventServer.exe: This service contains the AppConnectorEventServer object that is responsible for registering and unregistering client interest in events and for dispatching events to specific or registered client events sinks. This service is started whenever your client application (to which your application connector is deployed) is instantiated.
• Documentum.AppConnector.CredentialManager.exe: This service holds user credentials
(username, repository information, and so forth) after a user has logged on to the client application connector. This service is started after a user logs on to Windows and remains active until the current Windows session terminates.
• Documentum.AppConnector.LocaleManager.exe: This service maintains information about the client operating system locale. This service is started after the user logs on to Windows and remains active until the current Windows session terminates.
Installing with an MSI or InstallShield installer
To deploy your application connector to client machines, your installer must:
1. Add the DAC SDK Common Merge Module.All required DLLs will be installed into C:\Program files\Documentum\AppConnector. 2. Create theAPP_PATH\Documentum folder:
Deploying Your Application Connector
3. Install these files:
• MyCompany.AppConnector.CustomAppIntg.dll intoAPP_PATHpath.
• CustomApp.exe.config into theAPP_PATHpath and theAPP_PATH\Documentum folder. • CustomApp.exe.manifest (if you create one) into theAPP_PATHpath.
• Copy all DLLs from C:\Program Files\EMC Documentum Application Connectors SDK <version>\Documentum into theAPP_PATH\Documentum folder.
where:
• MyCompanyis the name of your company. • Customis the name of your application connector.
4. Register theMyCompany.AppConnector.CustomAppIntg.dll and the Documentum.Interop. AdvHosting.dll using the regasm tool:
set AssemblyRegistrar=%WINDIR%\Microsoft.NET\Framework\v2.0.50727\regasm.exe
"%AssemblyRegistrar%" /verbose %APP_PATH%\Documentum\Documentum.Interop.AdvHosting.dll "%AssemblyRegistrar%" /verbose %APP_PATH%\ MyCompany.AppConnector.
CustomAppIntg.dll where:
• MyCompanyis the name of your company. • Customis the name of your application connector. 5. Add this registry entry key for your application connector:
HKEY_LOCAL_MACHINE\SOFTWARE\MyCompany\AppConnector\Installed\ MyAppConnector
with these values:
App.config:REG_SZ: MyAppConnector.exe.config
InstallPath:REG_EXPAND_SZ:MyAppConnectorInstallPath where:
• MyCompanyis the name of your company.
• MyAppConnectoris the name of your application connector.
• MyAppConnectorInstallPathis the path to where your application connector is installed. Use the HKEY_LOCAL_MACHINE predefined key to make your application connector available to all users on the machine or HKEY_CURRENT_USER to make your application connector available to only the user that installs your application connector.
Note: See the EMC Documentum Application Connectors SDK.msi wrapper for more information about how to create the folder structure, deploy files, and add registry entries.
Installing with a non-MSI or non-InstallShield
installer
To deploy your application connector to client machines, your installer must:
1. Install these files into the C:\Program Files\Documentum\AppConnector folder:Deploying Your Application Connector Documentum.AppConnector.Configuration.dll Documentum.AppConnector.CredentialManager.exe Documentum.AppConnector.CredentialManager.exe.config Documentum.AppConnector.CredentialManager.exe.log4net.config Documentum.AppConnector.Credentials.dll Documentum.AppConnector.DataProtection.dll Documentum.AppConnector.DataProtection.Interfaces.dll Documentum.AppConnector.Locale.dll Documentum.AppConnector.LocaleManager.exe Documentum.AppConnector.LocaleManager.exe.log4net.config Documentum.AppConnector.Logging.dll Documentum.AppConnector.Preferences.dll Documentum.AppConnector.Provider.dll Documentum.AppConnector.Provider.Interfaces.dll Documentum.Interop.EventServer.dll EventServer.exe ICSharpCode.SharpZipLib.dll ICSharpCode.SharpZipLib-license.txt log4net.dll log4net-license.txt Microsoft.mshtml.dll msvcp90.dll msvcr90.dll
SDK Common Custom Actions.dll sdk common custom actions.InstallState Microsoft.VC90.ATL.manifest
Microsoft.VC90.CRT.manifest
2. Create theAPP_PATH\Documentum folder:
whereAPP_PATHis the path to your application’s executable file. 3. Install these files:
• MyCompany.AppConnector.customAppIntg.dll intoAPP_PATHpath.
• CustomApp.exe.config into theAPP_PATHpath and theAPP_PATH\Documentum folder. • CustomApp.exe.manifest (if you create one) into theAPP_PATHpath.
• Copy all DLLs from C:\Program Files\EMC Documentum Application Connectors SDK <version>\Documentum into theAPP_PATH\Documentum folder.
where:
• MyCompanyis the name of your company. • Customis the name of your application connector.
4. Register theMyCompany.AppConnector.CustomAppIntg.dll and the Documentum.Interop. AdvHosting.dll using the regasm tool:
set AssemblyRegistrar=%WINDIR%\Microsoft.NET\Framework\v2.0.50727\regasm.exe
"%AssemblyRegistrar%" /verbose %APP_PATH%\Documentum\Documentum.Interop.AdvHosting.dll "%AssemblyRegistrar%" /verbose %APP_PATH%\ MyCompany.AppConnector.
Deploying Your Application Connector
where:
• MyCompanyis the name of your company. • Customis the name of your application connector. 5. Register EventServer.exe:
echo Registering the Event Server with COM... %APPCONNECTOR_PATH%\EventServer.exe /RegServer
6. Set the registry values for CredentialManager and LocaleManager, so they start up whenever the user logs into Windows:
[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Run] Documentum\AppConnector\Documentum.AppConnector.LocaleManager.exe Documentum\AppConnector\Documentum.AppConnector.CredentialManager.exe 7. Add this registry entry key for your application connector:
HKEY_LOCAL_MACHINE\SOFTWARE\MyCompany\AppConnector\Installed\ MyAppConnector
with these values:
App.config:REG_SZ: MyAppConnector.exe.config
InstallPath:REG_EXPAND_SZ:MyAppConnectorInstallPath where:
• MyCompanyis the name of your company.
• MyAppConnectoris the name of your application connector.
• MyAppConnectorInstallPathis the path to where your application connector is installed. Use the HKEY_LOCAL_MACHINE predefined key to make your application connector available to all users on the machine or HKEY_CURRENT_USER to make your application connector available to only the user that installs your application connector.