Knowledge: andLinux Launcher - Revision history

Joachim: IP / port change howto

2009-05-23T10:34:04Z

IP / port change howto

←Older revision		Revision as of 10:34, 23 May 2009
Line 5:		Line 5:
	=== Protocol ===		=== Protocol ===

-	These launcher programs communicate with the andLinux VM via a socket. By default, the launchers know that the andLinux VM will be listening at IP address 192.168.11.150, on port 81. When the andLinux system boots up, a perl script is run that listens for input on this socket. That perl script is located at <tt>/usr/local/sbin/launcher.pl,</tt> and it is ~~hard~~-~~coded~~ to ~~listen on~~ port 81.	+	These launcher programs communicate with the andLinux VM via a socket. By default, the launchers know that the andLinux VM will be listening at IP address 192.168.11.150, on port 2081. When the andLinux system boots up, a perl script is run that listens for input on this socket. That perl script is located at <tt>/usr/local/sbin/launcher.pl,</tt> and its config file is located at <tt>/etc/andlinux/launcher-conf.pl</tt> (since Beta 2).
		+
		+	To change the IP address or port, you need to enter your desired values in the Windows registry as
		+
		+	<tt>\\HKEY_LOCAL_MACHINE\SOFTWARE\andLinux\Launcher\IP</tt>
		+	<tt>\\HKEY_LOCAL_MACHINE\SOFTWARE\andLinux\Launcher\Port</tt>
		+
		+	where IP is a string (type REG_SZ) and Port is a number (type REG_DWORD). Pay attention that numbers are encoded hexadecimal by default. When changing the port (e.g. to 1234), you'll need to add this line to the top of the launcher config file:
		+
		+	<tt>$localPort = 1234;</tt>

	The launcher programs send a small packet of data to the perl script, containing a line like <tt>'''cmd='''some-linux-app'''&file='''some-file.</tt> The perl script decodes this and runs the appropriate command, with the file (or whatever) as command-line arguments.		The launcher programs send a small packet of data to the perl script, containing a line like <tt>'''cmd='''some-linux-app'''&file='''some-file.</tt> The perl script decodes this and runs the appropriate command, with the file (or whatever) as command-line arguments.

Joachim at 19:09, 7 May 2009

2009-05-07T19:09:49Z

←Older revision		Revision as of 19:09, 7 May 2009
Line 1:		Line 1:
-	~~How andLinux works...~~
-
-	~~== Launcher ==~~
-
	Depending on how you choose to configure the system during the installation process, the andLinux system will either run <tt>xfce-panel</tt> to provide an X-based start menu, or it will run a custom perl daemon program to listen to ''launcher'' requests from Windows.		Depending on how you choose to configure the system during the installation process, the andLinux system will either run <tt>xfce-panel</tt> to provide an X-based start menu, or it will run a custom perl daemon program to listen to ''launcher'' requests from Windows.

Joachim: Documentation moved to Knowledge: andLinux Launcher: misleading old title

2009-05-07T19:06:40Z

Documentation moved to Knowledge: andLinux Launcher: misleading old title

←Older revision

Revision as of 19:06, 7 May 2009

Austin hastings: Extended launcher documentation

2008-05-21T12:03:48Z

Extended launcher documentation

←Older revision		Revision as of 12:03, 21 May 2008
Line 2:		Line 2:

	== Launcher ==		== Launcher ==
-	~~How the Launcher works.~~

-	~~There are~~ a ~~few small applications called launchers which start linux applications from windows. These launchers are small~~ ''~~'.exe''' files found in '~~''.~~\andLinux\Launcher\'''~~	+	Depending on how you choose to configure the system during the installation process, the andLinux system will either run <tt>xfce-panel</tt> to provide an X-based start menu, or it will run a custom perl daemon program to listen to ''launcher'' requests from Windows.

-	~~The Launcher program opens a connection via Ethernet to the small perl script in the VM. This perl script starts the Linux program. It can be found~~ in '''/~~usr~~/~~local/sbin/launcher~~.pl'''	+	A set of executables is installed in your <tt>''C:\Program Files\andLinux''</tt><tt>'''\Launcher'''</tt> Windows directory. These programs include applications, like <tt>and'''Karbon'''.exe</tt> and <tt>and'''KWord'''.exe</tt>, as well as a special utility program called <tt>andCmd.exe.</tt> These launchers are run when you click their icons in the andLinux menu (installed in the system tray, if you permit it); they can also be run directly from Windows Explorer, added to the Start menu (create a shortcut), etc.

-	~~The default host is 192.168.11.150 and default port is 81. To change these defaults, follow [[Quick_Tips#Change_Launcher_Port\|these instructions]].~~	+	=== Protocol ===

-	~~'''/etc/winterm''' contains~~ the ~~link to '''~~/usr/local/sbin/launcher.pl''' ~~or to~~ '''~~/usr/bin/xfce~~-~~panel~~'''	+	These launcher programs communicate with the andLinux VM via a socket. By default, the launchers know that the andLinux VM will be listening at IP address 192.168.11.150, on port 81. When the andLinux system boots up, a perl script is run that listens for input on this socket. That perl script is located at <tt>/usr/local/sbin/launcher.pl,</tt> and it is hard-coded to listen on port 81.
		+
		+	The launcher programs send a small packet of data to the perl script, containing a line like <tt>'''cmd='''some-linux-app'''&file='''some-file.</tt> The perl script decodes this and runs the appropriate command, with the file (or whatever) as command-line arguments.
		+
		+	=== Default User ===
		+
		+	The andLinux launcher daemon runs as root by default. In order to change this user, see [[Howto: change default user]]. It is doable, but somewhat involved -- you will need about 15 minutes.

Rmallins: small grammar changes plus linked to instructions to change default launcher IP & port.

2008-05-19T23:39:34Z

small grammar changes plus linked to instructions to change default launcher IP & port.

←Older revision		Revision as of 23:39, 19 May 2008
Line 1:		Line 1:
-	How andLinux ~~work~~...	+	How andLinux works...

	== Launcher ==		== Launcher ==
	How the Launcher works.		How the Launcher works.

-	There ~~exist~~ a few ~~launcher for starting~~ linux applications from windows. ~~Theses launcher~~ are small '''.exe''' files found in '''.\andLinux\Launcher\'''	+	There are a few small applications called launchers which start linux applications from windows. These launchers are small '''.exe''' files found in '''.\andLinux\Launcher\'''

	The Launcher program opens a connection via Ethernet to the small perl script in the VM. This perl script starts the Linux program. It can be found in '''/usr/local/sbin/launcher.pl'''		The Launcher program opens a connection via Ethernet to the small perl script in the VM. This perl script starts the Linux program. It can be found in '''/usr/local/sbin/launcher.pl'''

-	The default host is 192.168.11.150 and default port is 81.	+	The default host is 192.168.11.150 and default port is 81. To change these defaults, follow [[Quick_Tips#Change_Launcher_Port\|these instructions]].

	'''/etc/winterm''' contains the link to '''/usr/local/sbin/launcher.pl''' or to '''/usr/bin/xfce-panel'''		'''/etc/winterm''' contains the link to '''/usr/local/sbin/launcher.pl''' or to '''/usr/bin/xfce-panel'''

3ds: started to explane the Launcher... But i really don't known how it works :(

2008-04-22T11:30:37Z

started to explane the Launcher... But i really don't known how it works :(

New page

How andLinux work...

== Launcher ==
How the Launcher works.

There exist a few launcher for starting linux applications from windows. Theses launcher are small '''.exe''' files found in '''.\andLinux\Launcher\'''

The Launcher program opens a connection via Ethernet to the small perl script in the VM. This perl script starts the Linux program. It can be found in '''/usr/local/sbin/launcher.pl'''

The default host is 192.168.11.150 and default port is 81.

'''/etc/winterm''' contains the link to '''/usr/local/sbin/launcher.pl''' or to '''/usr/bin/xfce-panel'''