Distributing iMacros

SUBMITTED BY: rilp44

DATE: Dec. 5, 2015, 2:03 a.m.

FORMAT: Text only

SIZE: 13.0 kB

Raw Download

HITS: 2119

Report
  1. == The iMacros Player [[Image:IMacros-icon.png|iMacros Browser]] [[Image:Ie-icon.png|IE Plug-in]] [[Image:Ff-icon.png|Firefox]]==
  3. If you plan to distribute your solution we highly recommend the iMacros Enterprise Edition which includes free unlimited player licenses for use inside your company.
  5. Features of the iMacros Enterprise Player:
  6. * '''''All'' features of [[Web Scripting|Enterprise Edition]],''' except the ability to record new macros
  7. * The option to install and run in the background (no visible user interface).
  8. * Unlimited number of installations within your company or organization.
  10. The Enterprise Player license allows you to distribute macros, scripts and programs based on iMacros along with a copy of iMacros itself to your users *within* your company. Technically speaking this means that if iMacros is unlocked with the player license key your users have all the features of the ENTERPRISE EDITION available except the ability to record new macros.
  12. For distributing macros outside your company you can purchase the [[Component|iMacros Component for .NET]] separately. The iMacros Component for .NET license allows unlimited, royalty-free distribution to anyone (outside your company, web downloads, cloud-based service, etc.). For more information and pricing for the iMacros Component for .NET, please visit the [http://imacros.net/component-for-net product], [http://wiki.imacros.net/Component Wiki], and [http://imacros.net/store#iMacroscomponent purchasing] pages.
  14. ''Please see [http://imacros.net/store/compare-versions#player iMacros Player licensing examples] for more information.''
  15. <!--There are two different approaches to distribute iMacros with your application.-->
  17. == Distributing the iMacros setup ==
  19. You can distribute the normal setup executable from http://imacros.net/download.
  21. When installing your application on the end-user's computer, you can easily call the iMacros setup from your own custom installer and install the iMacros Trial version. You (or the end-user) can then either manually enter the license into iMacros or you can use one of the approaches described below.
  23. === Configuring the Player License ===
  25. '''Please note:''' If you are distributing your application to external customers, you need to have also purchased the [http://imacros.net/store/compare-versions#distribute royalty-free distribution license] that is provided by the iMacros WebBrowser Component for .NET, as explained [http://imacros.net/store/compare-versions#distribute here].
  27. ==== iMacros 10.1 and later ====
  29. You need to distribute your Enterprise Player license file with your application and make an update to the registry. You can obtain your license file from the Customer Portal as explained in [[FAQ#Q:_Where_do_I_find_my_Activation_Key.2C_License_File.2C_or_Serial_Number.3F|this FAQ]].
  31. You can give the license file any name and store it in any appropriate folder on the machine. The iMacros LicenseKey registry setting needs to contain the full path to the license file.
  33. [HKEY_CURRENT_USER\Software\Ipswitch\iMacros]
  34. "LicenseKey"="C:\\MyCusomApp\\iMacrosEnterprisePlayerLicense.txt"
  36. ==== iMacros 10.02 and older ====
  38. If you are using your own custom installer, you can write your old-style Player license key to the iMacros LicenseKey registry setting:
  40. [HKEY_CURRENT_USER\Software\Ipswitch\iMacros]
  41. "LicenseKey"="XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"
  43. For 10.00 and older the iMacros registry path is:
  45. HKEY_CURRENT_USER\Software\iOpus\iMacros
  47. As an alternative to writing the key in the registry, you can program your custom application to provide the key in the call to [[iimOpen#Options|iimOpen]]:
  49. iimOpen("-key XXXXX-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX")
  51. ==== Additional Notes ====
  53. # The registry settings mentioned above are on a per-user basis (they are stored in HKEY_CURRENT_USER). So if multiple users intend to run your iMacros application on the same machine, you need to make sure the LicenseKey setting is configured for each user account, as mentioned in [[FAQ#Q:_Why_does_iMacros_still_run_in_trial_mode_even_though_I.27ve_already_entered_my_key.3F|this FAQ]].
  54. # If you never obtained your old-style Player license key, you can generate one using your (old-style) primary Enterprise key on [http://iopus.com/get-player/ this page].
  56. === Setup Command Line Switches ===
  58. The installer program accepts the following optional command line parameters.
  60. /SILENT
  61. /VERYSILENT
  63. These instruct Setup to be silent or very silent. When Setup is silent the Wizard and the background window are not displayed but the installation progress window is. When a setup is very silent this installation progress window is not displayed. Everything else is normal, so for example error messages during installation are displayed.
  65. If a restart is necessary and the /NORESTART command isn't used (see below) and Setup is silent it will display a "Reboot now?" message box. If it's very silent it will reboot without asking.
  67. /SUPPRESSMSGBOXES
  69. Instructs Setup to suppress message boxes. Only has an effect when combined with /SILENT or /VERYSILENT.
  71. The default response in situations where there's a choice is:
  73. * Yes in a 'Keep newer file?' situation.
  74. * No in a 'File exists, confirm overwrite.' situation.
  75. * Abort in Abort/Retry situations.
  76. * Cancel in Retry/Cancel situations.
  77. * Yes (=continue) in a DiskSpaceWarning/DirExists/DirDoesntExist/NoUninstallWarning/ExitSetupMessage/ConfirmUninstall situation.
  78. * Yes (=restart) in a FinishedRestartMessage/UninstalledAndNeedsRestart situation.
  80. /SUPPRESSRUN
  82. Prevents the browsers from launching after setup completes.
  84. /NOCANCEL
  86. Prevents the user from cancelling during a silent installation by disabling the Cancel button and ignoring clicks on the close button. Only works with /SILENT.
  88. /NORESTART
  90. Instructs Setup not to reboot even if it's necessary. Note that installing iMacros does not require a reboot unless iMacros was already installed and running on the machine during the setup.
  92. /GROUP="folder name"
  94. Overrides the default folder name displayed on the Select Start Menu Folder wizard page.
  96. === Fully Silent Install ===
  98. For a completely silent installation, you would use the following combination of switches:
  100. iMacrosSetup.exe /VERYSILENT /SUPPRESSMSGBOXES /SUPPRESSRUN
  102. === Uninstaller Command Line Switches ===
  104. The uninstaller program (unins000.exe) also accepts the following optional command line parameters.
  106. /SILENT
  108. When specified the uninstaller will not ask the user any questions or display a message stating that uninstall is complete. Shared files that are no longer in use are deleted automatically without prompting. Any critical error messages will still be shown on the screen.
  110. /SUPPRESSRUN
  112. Prevents the iMacros Uninstall Survey from launching after the uninstall completes.
  114. === Restricted User Accounts ===
  116. iMacros runs well on restricted user accounts, locked down systems and systems that use Active Directory services.
  118. If you install the software for users with restricted rights, please note:
  120. # The software must be installed by a user with administrative rights
  121. # iMacros folders (Macros, Datasources, Downloads and Logs) are personal, so each user will have his own %USERPROFILE%\Documents\iMacros folder. However only the user who installed iMacros will have the Demo macros in his User Profile folder.
  123. === Modify settings directly ===
  125. All settings used by iMacros are stored in the [[Differences_between_versions_6_and_7|registry]]. We do not recommend editing these settings manually unless you know what you are doing. If in doubt please contact the iMacros Support Team.
  126. <!--
  127. == Distribute iMacros with your setup ==
  129. This paragraph assumes that you do '''not''' want to use the iMacros installer, but want to create your own setup. iMacros is a compact application that consists only of the following files, which you need to copy to your client's computer:
  132. #Required, iMacros Browser
  133. #*imacros.exe
  134. #*iMacros.WinUI.ActionList.dll
  135. #*iMacros.WinUI.Docking.dll
  136. #*iMacros.TabbedBrowser.dll
  137. #Required by both iMacros Browser and iMacros Plugin for IE
  138. #*iMacros.Core.dll (substitutes earlier iMacros.Engine.dll and iMacros.DialogManager.dll)
  139. #*iMacros.IO.Csv.dll
  140. #*iMacros.WinUI.Common.dll
  141. #*Microsoft.mshtml.dll, register with RegAsm.exe /codebase
  142. #*Interop.SHDocVw.dll, Microsoft assembly
  143. #*imsys.dll, iMacros Dialog Manager helper assembly
  144. #*iimds.dll, iMacros Direct Screen
  145. #*iimir.dll, Image Recognition
  146. #*iimIRm.dll, Image Recognition
  147. #*iimIR1.dll, Image Recognition
  148. #*iimIR2.dll, Image Recognition
  149. #*iimIR3.dll, Image Recognition
  150. #*imatl.dll, register with [[regsvr32]].exe
  151. #Required by iMacros Plugin for IE
  152. #*iMacros.Plugin.dll, no tabs support (for use with IE 7 and below), register with RegAsm.exe /codebase
  153. #*iMacrosSidebar.dll, tabs support (for use with IE 8 and above), register with [[regsvr32]].exe
  154. #*iMacros.Sidebar.Content.dll, tabs support (for use with IE 8 and above), register with RegAsm.exe /codebase
  155. #*iimToolbar.dll
  156. #Required, iMacros Scripting Interface
  157. #*Interop.iimConnectorLib.dll
  158. #*iimConnector.dll, register with regsvr32.exe
  159. #*iimInterface.dll, register with regsvr32.exe
  160. #*imtcp.dll, the scripting interface which controls iMacros for Firefox and Chrome.
  161. #Optional, native [[x64|64-bit version]] of the Scripting Interface
  162. #*iimInterface64.dll, register with regsvr32.exe (the regsvr32.exe file in the System32 folder on ''64-bit'' Windows is a 64-bit version, despite the "32" in the name!)
  163. #*iimtcp64.dll
  164. #Optional,
  165. #Required, use it to register iMacros.Plugin.dll, iMacros.Sidebar.Content.dll, and Microsoft.mshtml.dll
  166. #*RegAsm.exe
  167. #Optional, iMacros icon
  168. #*iMacros-icon.gif
  169. #Optional, iMacros Editor
  170. #*iMacrosEditor.exe
  171. #*ICSharpCode.TextEditor.dll
  172. #Microsoft Visual C++ 2008 SP1 Runtime Files x86
  173. #*msvcr90.dll
  174. #*msvcp90.dll
  175. #*vcomp90.dll
  176. #*Microsoft.VC90.CRT.manifest
  177. #*Microsoft.VC90.OpenMP.manifest
  178. #and their x64 versions:
  179. #*Microsoft.VC90.CRT.manifest
  180. #*msvcp90.dll
  181. #*msvcr90.dll
  182. #Microsoft .NET 3.5 SP1
  184. Besides copying the files above, the Player license key has to be entered manually in the registry at HKEY_CURRENT_USER\Software\iOpus\iMacros (both 32 and 64 bit OS), as LicenseKey.
  186. Tip: To trouble-shoot installation related issues we find [[Dependency Walker]] useful.
  188. === Creating a Custom Install ===
  190. The iMacros Setup executable was made using the Inno Setup custom installer, although no special features were used so you could use other installation software to create your own Setup Executable.
  192. Inno Setup is available free of charge from here: [http://www.jrsoftware.org/isinfo.php]
  194. You should also '''download the iMacros Player Inno installation script'''. The complete and documented source code is available as download inside our '''[http://www.iopus.com/imacros/customers/ customer resources area].'''
  196. [[Image:IMacros-InstallScript.png|400px|thumb|down|Folder Setup]]
  198. Once you unzip the example script you will see the directory structure as shown.
  200. [[Image:IMacrosInnoScript.png|left|thumb|150px|Setup Script File]]
  201. You can open the Inno Setup Script file "iMacros.iss" within the IS Tool.
  203. Here you can enter your Player license key and any settings you require.
  205. You should also ensure that the latest iMacros binary files are located in the Bin folder, as described in the Readme.txt file. The iMacros ''macro'' files (= simple text files) can be placed anywhere, including a network drive or under source control.
  207. You can then compile and run the script to create your installation file, which will be placed in the Setup folder.
  208. -->
  210. == Changes in an existing installation ==
  212. === Edit Settings ===
  214. All iMacros settings are stored in the [[Registry_Editor|registry]] (see also [http://forum.iopus.com/viewtopic.php?f=2&t=11639&p=36292#p36292 this forum post] for some use cases for manipulating the registry directly). But since you can change most settings through the user interface editing the registry is not required or recommended for most users.
  217. Note: The [[iMacros for Firefox]] settings are '''not''' stored in the registry. Here we follow the Firefox standard and store the addon settings in the Firefox user profile, so the iMacros for Firefox setting are '''per user'''. You can view and edit them by typing "about:config" in the address line. You can even select a certain user profile via the [[iimInit]] "-fxProfile" switch.
  219. [[Image:Fx imacros settings.png|thumb|center|350px|Enter about:config to access the iMacros for Firefox settings]]
  221. === Edit Paths ===
  222. All iMacros paths can be changed directly in the user interface. To change them, go to the EDIT tab, click OPTIONS and open the PATH tab:
  224. [[Image:IMacrosPaths.png|center|thumb|500px|iMacros Paths]]
comments powered by Disqus