Z/Linux Emulation with Hercules - Revision history

Leo: Leo moved page Hercules Z/Linux Guide to Z/Linux Emulation with Hercules without leaving a redirect: article name consistency

2019-09-12T06:04:25Z

Leo moved page Hercules Z/Linux Guide to Z/Linux Emulation with Hercules without leaving a redirect: article name consistency

← Older revision		Revision as of 06:04, 12 September 2019
(No difference)

Leo: Text replacement - "" to "}}"

2017-02-24T19:14:17Z

Text replacement - "</code>" to "}}"

← Older revision		Revision as of 19:14, 24 February 2017
Line 16:		Line 16:
	=== Images ===		=== Images ===

	Download the images from http://ftp.debian.org/debian/dists/stable/main/installer-s390/current/ into {{code\|rdr/~~</code>~~.		Download the images from http://ftp.debian.org/debian/dists/stable/main/installer-s390/current/ into {{code\|rdr/}}.

	Create a configuration file at {{code\|~/zlinux/s390.cnf~~</code>~~ with:		Create a configuration file at {{code\|~/zlinux/s390.cnf}} with:

	<syntaxhighlight lang="text" line start="1" enclose="div">		<syntaxhighlight lang="text" line start="1" enclose="div">
Line 254:		Line 254:
	SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet.		SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet.

	You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put {{code\|/~~</code>~~ in DASD 0.0.0120 and {{code\|/home~~</code>~~ in DASD 0.0.0.121. You do not need to format the disks.		You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put {{code\|/}} in DASD 0.0.0120 and {{code\|/home}} in DASD 0.0.0.121. You do not need to format the disks.

	[[File:Zlinux1.png ‎\|thumbnail]]		[[File:Zlinux1.png ‎\|thumbnail]]

Leo: Text replacement - "`" to "{{code|"`


2017-02-24T19:12:47Z
Text replacement - "<code>" to "{{code|"

				
				
				
				
				
				← Older revision
				Revision as of 19:12, 24 February 2017
				
Line 16:
Line 16:
=== Images === === Images ===



Download the images from http://ftp.debian.org/debian/dists/stable/main/installer-s390/current/ into <code>rdr/</code>. Download the images from http://ftp.debian.org/debian/dists/stable/main/installer-s390/current/ into {{code|rdr/</code>.



Create a configuration file at <code>~/zlinux/s390.cnf</code> with: Create a configuration file at {{code|~/zlinux/s390.cnf</code> with:



<syntaxhighlight lang="text" line start="1" enclose="div"> <syntaxhighlight lang="text" line start="1" enclose="div">
Line 254:
Line 254:
SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet. SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet.



You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks. You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put {{code|/</code> in DASD 0.0.0120 and {{code|/home</code> in DASD 0.0.0.121. You do not need to format the disks.



[[File:Zlinux1.png ‎|thumbnail]] [[File:Zlinux1.png ‎|thumbnail]]



Leo: /* Installation */
2013-05-08T04:13:15Z
Installation

				
				
				
				
				
				← Older revision
				Revision as of 04:13, 8 May 2013
				
Line 250:
Line 250:
Once that's all set up, you should be able to SSH to the installer at installer@10.1.10.2 Once that's all set up, you should be able to SSH to the installer at installer@10.1.10.2



=== Installation === === Install Debian ===



SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet. SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet.
Line 259:
Line 259:
[[File:Zlinux2.png ‎|thumbnail]] [[File:Zlinux2.png ‎|thumbnail]]



Everything afterwards should be quite straight forward.



[[Category:Todo]] === Stopping / Starting the VM ===
 
You can poweroff or shutdown the guest like you would usually.
 
To boot the VM, run:
 lpc 120
 
which will boot from your /root partition.
 
[[Category:Guides]]





Leo: /* Installation */
2013-05-06T05:52:59Z
Installation

				
				
				
				
				
				← Older revision
				Revision as of 05:52, 6 May 2013
				
Line 256:
Line 256:
You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks. You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks.



[[File:Zlinux1|thumbnail|zlinux1]] [[File:Zlinux1.png ‎|thumbnail]]
[[File:Zlinux2.png ‎|thumbnail]]






[[Category:Todo]] [[Category:Todo]]





Leo at 05:49, 6 May 2013
2013-05-06T05:49:04Z


				
				
				
				
				
				← Older revision
				Revision as of 05:49, 6 May 2013
				
Line 256:
Line 256:
You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks. You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks.



  [[File:Zlinux1|thumbnail|zlinux1]]






[[Category:Todo]] [[Category:Todo]]





Leo at 20:10, 5 May 2013
2013-05-05T20:10:22Z


				
				
				
				
				
				← Older revision
				Revision as of 20:10, 5 May 2013
				
Line 72:
Line 72:
</syntaxhighlight> </syntaxhighlight>



Set up networking: === Networking ===
Ensure your tun0 interface can talk out. We will make a NAT using IPTables:
 
<syntaxhighlight lang="bash" line start="1" enclose="div"> <syntaxhighlight lang="bash" line start="1" enclose="div">
iptables -t nat -A POSTROUTING -o eth0 -s 10.1.10.0/24 -j MASQUERADE iptables -t nat -A POSTROUTING -o eth0 -s 10.1.10.0/24 -j MASQUERADE
Line 81:
Line 83:
</syntaxhighlight> </syntaxhighlight>



=== Starting the Installation ===
Start hercules as root Start hercules as root



Line 235:
Line 238:






  === Make sure Networking Works ===
  Now that the installer is ready, we need to set up the networking.
Still need to set up networking... 



  ip a   ip a



if you don't see an IP on your tun0 device... do it manually if you don't see an IP on your tun0 device, you will need to define it manually.



  ifconfig tun0 10.1.10.1   ifconfig tun0 10.1.10.1
  route add 10.1.10.2 gw 10.1.10.1   route add 10.1.10.2 gw 10.1.10.1



you should now be able to ping 10.1.10.2 Once that's all set up, you should be able to SSH to the installer at installer@10.1.10.2
 
=== Installation ===
 
SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet.
 
You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks.
 
 



Once that's all set up, you should be able to SSH to the installer at installer@10.1.10.2 



[[Category:Todo]] [[Category:Todo]]





Leo at 19:47, 5 May 2013
2013-05-05T19:47:19Z

Show changes


Leo at 18:51, 5 May 2013
2013-05-05T18:51:31Z


				
				
				
				
				
				← Older revision
				Revision as of 18:51, 5 May 2013
				
Line 87:
Line 87:
ipl c ipl c
</syntaxhighlight> </syntaxhighlight>


<syntaxhighlight lang="console" line start="1" enclose="div" style="">
Configure the network device
----------------------------

Please choose the type of your primary network interface that you will need for
installing the Debian system (via NFS or HTTP). Only the listed devices are
supported.
Network device type:
  1. ctc: Channel to Channel (CTC) or ESCON connection
  2. qeth: OSA-Express in QDIO mode / HiperSockets
  3. iucv: Inter-User Communication Vehicle - available for VM guests only
Prompt: '?' for help>
Command ==> .1
</syntaxhighlight>







<syntaxhighlight lang="text" line start="1" enclose="div"> <syntaxhighlight lang="text" line start="1" enclose="div">
The following device numbers might belong to CTC or ESCON connections.
CTC read device:
  1. 0.0.0a00      2. 0.0.0a01
Prompt: '?' for help>
Command ==> .1

</syntaxhighlight>


<syntaxhighlight lang="text" line start="1" enclose="div">
The following device numbers might belong to CTC or ESCON connections.
CTC write device:
  1. 0.0.0a00      2. 0.0.0a01
Prompt: '?' for help>
Command ==> .2
</syntaxhighlight>

<syntaxhighlight lang="text" line start="1" enclose="div">
Protocol for this connection:
  1. S/390 (0)  *!  2. Linux (1)      3. OS/390 (3)
Prompt: '?' for help, default=1>
Command ==> .1

</syntaxhighlight>

<syntaxhighlight lang="text" line start="1" enclose="div">
Configure a network using static addressing
-------------------------------------------

The IP address is unique to your computer and consists of four numbers
separated by periods.  If you don't know what to use here, consult your network
administrator.
IP address:
Prompt: '?' for help>
Command ==> .10.1.10.2

</syntaxhighlight>

<syntaxhighlight lang="text" line start="1" enclose="div">
The point-to-point address is used to determine the other endpoint of the point
to point network.  Consult your network administrator if you do not know the
value.  The point-to-point address should be entered as four numbers separated
by periods.
Point-to-point address:
Prompt: '?' for help>
Command ==> .10.1.10.1
</syntaxhighlight>



<syntaxhighlight lang="text" line start="1" enclose="div">



The following device numbers might belong to CTC or ESCON connections. The following device numbers might belong to CTC or ESCON connections.
CTC read device: CTC read device:





Leo: /* Requirements */
2013-05-05T18:43:23Z
Requirements

				
				
				
				
				
				← Older revision
				Revision as of 18:43, 5 May 2013
				
Line 6:
Line 6:
Install hercules, either from a package manager or from source. Install hercules, either from a package manager or from source.



Create the directory where z/linux will reside. I will be putting it in my home directory.
<syntaxhighlight lang="bash" line start="1" enclose="div"> <syntaxhighlight lang="bash" line start="1" enclose="div">
cd ~ cd ~

← Older revision		Revision as of 19:12, 24 February 2017
Line 16:		Line 16:
	=== Images ===		=== Images ===

	Download the images from http://ftp.debian.org/debian/dists/stable/main/installer-s390/current/ into <code>rdr/</code>.		Download the images from http://ftp.debian.org/debian/dists/stable/main/installer-s390/current/ into {{code\|rdr/</code>.

	Create a configuration file at <code>~/zlinux/s390.cnf</code> with:		Create a configuration file at {{code\|~/zlinux/s390.cnf</code> with:

	<syntaxhighlight lang="text" line start="1" enclose="div">		<syntaxhighlight lang="text" line start="1" enclose="div">
Line 254:		Line 254:
	SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet.		SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet.

	You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks.		You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put {{code\|/</code> in DASD 0.0.0120 and {{code\|/home</code> in DASD 0.0.0.121. You do not need to format the disks.

	[[File:Zlinux1.png ‎\|thumbnail]]		[[File:Zlinux1.png ‎\|thumbnail]]

← Older revision		Revision as of 04:13, 8 May 2013
Line 250:		Line 250:
	Once that's all set up, you should be able to SSH to the installer at installer@10.1.10.2		Once that's all set up, you should be able to SSH to the installer at installer@10.1.10.2

	=== ~~Installation~~ ===		=== Install Debian ===

	SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet.		SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet.
Line 259:		Line 259:
	[[File:Zlinux2.png ‎\|thumbnail]]		[[File:Zlinux2.png ‎\|thumbnail]]

			Everything afterwards should be quite straight forward.

	[[Category:~~Todo~~]]		=== Stopping / Starting the VM ===

			You can poweroff or shutdown the guest like you would usually.

			To boot the VM, run:
			lpc 120

			which will boot from your /root partition.

			[[Category:Guides]]

← Older revision		Revision as of 05:52, 6 May 2013
Line 256:		Line 256:
	You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks.		You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks.

	[[File:Zlinux1\|thumbnail\|~~zlinux1~~]]		[[File:Zlinux1.png ‎\|thumbnail]]
			[[File:Zlinux2.png ‎\|thumbnail]]


	[[Category:Todo]]		[[Category:Todo]]

← Older revision		Revision as of 05:49, 6 May 2013
Line 256:		Line 256:
	You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks.		You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks.

			[[File:Zlinux1\|thumbnail\|zlinux1]]


	[[Category:Todo]]		[[Category:Todo]]

← Older revision		Revision as of 20:10, 5 May 2013
Line 72:		Line 72:
	</syntaxhighlight>		</syntaxhighlight>

	~~Set up networking~~:		=== Networking ===
			Ensure your tun0 interface can talk out. We will make a NAT using IPTables:

	<syntaxhighlight lang="bash" line start="1" enclose="div">		<syntaxhighlight lang="bash" line start="1" enclose="div">
	iptables -t nat -A POSTROUTING -o eth0 -s 10.1.10.0/24 -j MASQUERADE		iptables -t nat -A POSTROUTING -o eth0 -s 10.1.10.0/24 -j MASQUERADE
Line 81:		Line 83:
	</syntaxhighlight>		</syntaxhighlight>

			=== Starting the Installation ===
	Start hercules as root		Start hercules as root

Line 235:		Line 238:


			=== Make sure Networking Works ===
			Now that the installer is ready, we need to set up the networking.
	~~Still~~ need to set up networking...

	ip a		ip a

	if you don't see an IP on your tun0 device~~... do~~ it manually		if you don't see an IP on your tun0 device, you will need to define it manually.

	ifconfig tun0 10.1.10.1		ifconfig tun0 10.1.10.1
	route add 10.1.10.2 gw 10.1.10.1		route add 10.1.10.2 gw 10.1.10.1

	you should ~~now~~ be able to ~~ping~~ 10.1.10.2		Once that's all set up, you should be able to SSH to the installer at installer@10.1.10.2

			=== Installation ===

			SSH to the IP, and you should begin the installation without issue. If you can't download the release data for any reason, try to SSH to the installer again and spawn a shell. From there, you can troubleshoot any networking issues you might have. For me, I ran into an issue with DNS not working due to it being on an unknown subnet.

			You should go through the installation steps as you would normally would with a debian install. Eventually, you will hit a stage named " Configure direct access storage devices (DASD)". You will need to put <code>/</code> in DASD 0.0.0120 and <code>/home</code> in DASD 0.0.0.121. You do not need to format the disks.



	~~Once that's all set up, you should be able to SSH to the installer at installer@10.1.10.2~~

	[[Category:Todo]]		[[Category:Todo]]

← Older revision		Revision as of 18:43, 5 May 2013
Line 6:		Line 6:
	Install hercules, either from a package manager or from source.		Install hercules, either from a package manager or from source.

			Create the directory where z/linux will reside. I will be putting it in my home directory.
	<syntaxhighlight lang="bash" line start="1" enclose="div">		<syntaxhighlight lang="bash" line start="1" enclose="div">
	cd ~		cd ~

Z/Linux Emulation with Hercules - Revision history

Leo: Leo moved page Hercules Z/Linux Guide to Z/Linux Emulation with Hercules without leaving a redirect: article name consistency

Leo: Text replacement - "" to "}}"

Leo: Text replacement - "" to "{{code|"

Leo: /* Installation */

Leo: /* Installation */

Leo at 05:49, 6 May 2013

Leo at 20:10, 5 May 2013

Leo at 19:47, 5 May 2013

Leo at 18:51, 5 May 2013

Leo: /* Requirements */

Leo: Text replacement - "`" to "{{code|"`