OmniLaunch - Revision history

John Powers at 21:39, 7 April 2020

2020-04-07T21:39:31Z

← Older revision		Revision as of 17:39, 7 April 2020
Line 10:		Line 10:
	To assign the ports, OmniLaunch picks two unused ports at random from a range of ports defined in the registry. If the range is not found, OmniLaunch creates it. The default range is 51456-52991 (0xc900-0xceff). The location of the range is:		To assign the ports, OmniLaunch picks two unused ports at random from a range of ports defined in the registry. If the range is not found, OmniLaunch creates it. The default range is 51456-52991 (0xc900-0xceff). The location of the range is:

	<~~code~~>		<blockquote>
	Computer\HKEY_CURRENT_USER\Software\Scriptel Corporation\OmniLaunch\portMin		Computer\HKEY_CURRENT_USER\Software\Scriptel Corporation\OmniLaunch\portMin

	Computer\HKEY_CURRENT_USER\Software\Scriptel Corporation\OmniLaunch\portMax		Computer\HKEY_CURRENT_USER\Software\Scriptel Corporation\OmniLaunch\portMax
	</~~code~~>		</blockquote>

	~~Examples:~~
	The default location of the Assembly is "C:\Program Files (x86)\Scriptel Corporation\OmniLaunch". Within the install folder is an example html file, omnilauchexample.html. Using the assembly is as easy as calling:		The default location of the Assembly is "C:\Program Files (x86)\Scriptel Corporation\OmniLaunch". Within the install folder is an example html file, omnilauchexample.html. Using the assembly is as easy as calling:

	<~~code~~>		<blockquote>
	var myOmniLaunch = new ActiveXObject("AxControls.OmniLaunch");		var myOmniLaunch = new ActiveXObject("'''AxControls.OmniLaunch'''");
	var returnedPort = myOmniLaunch.LaunchNewInstance(true);
	</~~code~~>		var returnedPort = myOmniLaunch.'''LaunchNewInstance'''(true);
			</blockquote>

	The parameter passed into LaunchNewInstance is either true or false to state whether an https port is desired. This port can then be passed to the application to connect to OmniScript. For example, if OmniLaunch returns 51456 using https, the URL to connect to OmniScript is:		The parameter passed into LaunchNewInstance is either true or false to state whether an https port is desired. This port can then be passed to the application to connect to OmniScript. For example, if OmniLaunch returns 51456 using https, the URL to connect to OmniScript is:

	<~~code~~>		<blockquote>
	https://localhost:51456/		https://localhost:51456/
	</~~code~~>		</blockquote>

			If the port is returned is 0, OmniLaunch failed to start OmniScript. Properties of '''AxControls.OmniLaunch'''
			* '''httpPort''', this is the port that was returned by the call to LaunchNewInstance. It is either http or https, depending on what was requested.
			* '''useHttps''', the boolean value that was passed into LaunchNewInstance.
			* '''discoveryPort''', is the discovery port of the instance. It is necessary for the operation of OmniScript, but has little value for a web application using OmniLaunch.
			* '''workingDirectory''', is the full path where OmniScript is expected to be found.

			'''workingDirectory'' is established by one of three methods, in order of precedence, highest first:
			# It is set using the workingDirectory property before the call to '''AxControls.LaunchNewInstance'''.
			# The registry is checked for an entry at HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\omniscript\Parameters\AppDirectory
			# A hardcoded default is used: C:\Program Files (x86)\Scriptel Corporation\ScripTouch OmniScript

John Powers at 19:40, 7 April 2020

2020-04-07T19:40:22Z

← Older revision		Revision as of 15:40, 7 April 2020
Line 1:		Line 1:
	== Overview ==		== Overview ==
	OmniLaunch exists to solve the problem of having a RDP server (or other multi-client Windows desktop system)run separate instantiations of [[OmniScript]]. OmniScript uses a configuration file to determine which of the server's global ports to use, but in a multiple client system each desktop requires its own set of ports so that only the client's signature pads are available to the desktop rather than all of the signature pads on all of the clients.		OmniLaunch exists to solve the problem of having a RDP server (or other multi-client Windows desktop system) run separate instantiations of [[OmniScript]]. OmniScript uses a configuration file to determine which of the server's global ports to use, but in a multiple client system each desktop requires its own set of ports so that only the client's signature pads are available to the desktop rather than all of the signature pads on all of the clients.

	OmniLaunch is an ActiveX ~~component~~ that runs in either Internet Explorer or Edge (Chromium-based, "Edgium") running in IE mode. If you are interested in OmniLaunch, contact our support team at support@my.scriptel.com or 844-972-7478.		OmniLaunch is an ActiveX assembly that runs in either Internet Explorer or Edge (Chromium-based, "Edgium") running in IE mode. If you are interested in OmniLaunch, contact our support team at support@my.scriptel.com or 844-972-7478.

	== Documentation ==		== Documentation ==

	OmniScript requires two or three ports ~~but OmniLaunch constrains it to two per instance~~. ~~The application must connect to OmniScript on a port, either an http or https~~ port. It is possible (and normal) for OmniScript to have a port assigned for each simultaneously, however OmniLaunch forces the developer to choose only one connection method for each instantiation. The other port is used for discovery. Discovery allows OmniScript instances to "see" each other and share their devices. ~~Since this~~ is exactly what is not desired in the multi-tenet Remote Desktop configuration, each instance gets its own discovery port.		OmniScript requires two or three ports. A discovery port allows OmniScript instances to "see" each other and share their devices within a LAN. This is exactly what is not desired in the multi-tenet Remote Desktop configuration, therefore each instance gets its own discovery port. OmniScript assigns an http port or an https port or both. But each instance of OmniLaunch assigns either the http or https port but not both. The web application connects to one of these ports. So each instance of OmniLaunch assigns exactly two ports, the discovery port can be ignored.

	OmniLaunch picks two unused ports at random from a range of ports. The default range is 51456-52991 (0xc900-0xceff). The range ~~can be set or modified in the registry.~~		To assign the ports, OmniLaunch picks two unused ports at random from a range of ports defined in the registry. If the range is not found, OmniLaunch creates it. The default range is 51456-52991 (0xc900-0xceff). The location of the range is:

	<code>		<code>
Line 16:		Line 16:
	</code>		</code>

	~~Create~~ the ~~<OBJECT> tag as shown in~~ the example. ~~The example shows a HEIGHT and WIDTH, but this is just for development purposes~~. ~~For production it~~ is ~~intended that these will be set to 0 so that the control will be invisible.~~		Examples:
			The default location of the Assembly is "C:\Program Files (x86)\Scriptel Corporation\OmniLaunch". Within the install folder is an example html file, omnilauchexample.html. Using the assembly is as easy as calling:

	~~See~~ the example at https://~~<span style="color~~:~~#FF0000">TBA~~</~~span~~>.		<code>
			var myOmniLaunch = new ActiveXObject("AxControls.OmniLaunch");
			var returnedPort = myOmniLaunch.LaunchNewInstance(true);
			</code>

			The parameter passed into LaunchNewInstance is either true or false to state whether an https port is desired. This port can then be passed to the application to connect to OmniScript. For example, if OmniLaunch returns 51456 using https, the URL to connect to OmniScript is:

			<code>
			https://localhost:51456/
			</code>

John Powers: /* Documentation */

2020-02-07T22:34:28Z

Documentation

← Older revision		Revision as of 18:34, 7 February 2020
Line 5:		Line 5:

	== Documentation ==		== Documentation ==
	~~coming soon~~
			OmniScript requires two or three ports but OmniLaunch constrains it to two per instance. The application must connect to OmniScript on a port, either an http or https port. It is possible (and normal) for OmniScript to have a port assigned for each simultaneously, however OmniLaunch forces the developer to choose only one connection method for each instantiation. The other port is used for discovery. Discovery allows OmniScript instances to "see" each other and share their devices. Since this is exactly what is not desired in the multi-tenet Remote Desktop configuration, each instance gets its own discovery port.

			OmniLaunch picks two unused ports at random from a range of ports. The default range is 51456-52991 (0xc900-0xceff). The range can be set or modified in the registry.

			<code>
			Computer\HKEY_CURRENT_USER\Software\Scriptel Corporation\OmniLaunch\portMin

			Computer\HKEY_CURRENT_USER\Software\Scriptel Corporation\OmniLaunch\portMax
			</code>

			Create the <OBJECT> tag as shown in the example. The example shows a HEIGHT and WIDTH, but this is just for development purposes. For production it is intended that these will be set to 0 so that the control will be invisible.

			See the example at https://<span style="color:#FF0000">TBA</span>.

John Powers: Created page with "== Overview == OmniLaunch exists to solve the problem of having a RDP server (or other multi-client Windows desktop system)run separate instantiations of OmniScript. OmniS..."

2020-02-06T22:01:39Z

Created page with "== Overview == OmniLaunch exists to solve the problem of having a RDP server (or other multi-client Windows desktop system)run separate instantiations of OmniScript. OmniS..."

New page

== Overview ==
OmniLaunch exists to solve the problem of having a RDP server (or other multi-client Windows desktop system)run separate instantiations of [[OmniScript]]. OmniScript uses a configuration file to determine which of the server's global ports to use, but in a multiple client system each desktop requires its own set of ports so that only the client's signature pads are available to the desktop rather than all of the signature pads on all of the clients.

OmniLaunch is an ActiveX component that runs in either Internet Explorer or Edge (Chromium-based, "Edgium") running in IE mode. If you are interested in OmniLaunch, contact our support team at support@my.scriptel.com or 844-972-7478.

== Documentation ==
coming soon