When you want to install the Tur(n)key Sysgen environment, you will have to setup the Hercules environment first. This process is described in the document Installing Hercules & Support Programs.
This part of the installation sets up the Sysgen environment on your Linux machine. First of all
you will have to specify into which directory the MVS system will be installed. The default is
mvs38j in your home directory. The default can be overwritten in the
Target directory definition Please enter the target directory, or press enter for default (mvs38j) The directory can be given as an absolute path, i.e. with a / character at the beginning, or as a relative path. In this case the path will be relative to /home/volker ===>
Next you will be asked about the operational parameters of your hercules instance:
Console Port (CNSLPORT) Definition Please enter the portnumber that Hercules should listen at for incoming telnet and/or tn3270 connections for its builtin telnet server ===> (3270)
The console port (CNSLPORT) is the TCP/IP port number on which Hercules will listen to incoming telnet and/or tn3270 requests. The number shown is the default port number which will be selected when you just press [ENTER]. Please note that the port number has no relationship to the devicetype being used, i.e. a TN3270 session may well be connected to port 5555, and a device 3505 may well be connected to port 3270
Another TCP/IP port used by Hercules is the Socket Reader Device port. This port allows sending JCL streams to the MVS reader via a TCP/IP connection. Which port number should be used will be configured via the next prompt:
Socket Reader Device Port Definition Please enter the portnumber that Hercules should listen at for incoming data for the socket device card reader ===> (3505)
Again, if you just press [ENTER], the default port number shown will be used.
Hercules provides a (rudimentary) http server which can be used to control Hercules operations via a web browser. This server will listen to incoming http requests on the port number specified on the next question:
Web server port (HTTPPORT) Definition Please enter the portnumber that Hercules should listen at for incoming http requests to its builtin web server ===> (8081)
The time for questions is nearly over now. The setup script will now show the installation options so far:
Installation options: CPU Type is: i686 Source path: /mnt/cdrom Target path: /home/volker/mvs38j Type of installation: sysgen Location of Tur(n)key DASD images: HD Telnet console port: 3270 Web server port: 8081 Socket device port: 3505 Continue with Installation ===> (Y)?
Pressing the ENTER key will now complete the installation, and you will see the progress like this:
Building ./log directory Installing Tur(n)key MVS 3.8J files: Building ./conf directory Building ./jcl directory Building ./scripts directory Building ./dasd directory Building ./shadow directory Building ./prt directory Building ./pch directory Building ./tapes directory Press the ENTER key to continue
and, when you press ENTER now, the installation ends with the following screen:
+=============================================================================+ | | | Installation is now complete | | ============================ | | | | | | You can now change to the installation directory and start MVS 3.8 | | by entering | | | | startmvs | | | | on the command line | | | | | | Enjoy your private mainframe | | | +=============================================================================+ Press the ENTER key to continue
The installation of the SYSGEN system is now complete. To create a new MVS system you should now consult the MVS System Generation document.