Skip to content

Commit 960978d

Browse files
joergschultzelutterjoergschultzelutter
committed
final modifications
1 parent 3eb3257 commit 960978d

File tree

2 files changed

+63
-33
lines changed

2 files changed

+63
-33
lines changed

‎Dockerfile‎

Lines changed: 36 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,37 @@
1+
# Port of the tk4-hercules dockerfile to Turnkey5, running on Alpine Linux
2+
#
3+
# Initial tk4-hercules author:
4+
# Ken Godoy - skunklabz (https://github.com/skunklabz/tk4-hercules)
5+
# Turnkey5 modifications & port to Alpine Linux:
6+
# Joerg Schultze-Lutter (https://github.com/joergschultzelutter/tk5-hercules)
7+
#
8+
# run via docker run -dti -p3270:3270 -p8038:8038 tk5
9+
#
10+
# This is free and unencumbered software released into the public domain.
11+
#
12+
# Anyone is free to copy, modify, publish, use, compile, sell, or
13+
# distribute this software, either in source code form or as a compiled
14+
# binary, for any purpose, commercial or non-commercial, and by any
15+
# means.
16+
#
17+
# In jurisdictions that recognize copyright laws, the author or authors
18+
# of this software dedicate any and all copyright interest in the
19+
# software to the public domain. We make this dedication for the benefit
20+
# of the public at large and to the detriment of our heirs and
21+
# successors. We intend this dedication to be an overt act of
22+
# relinquishment in perpetuity of all present and future rights to this
23+
# software under copyright law.
24+
#
25+
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
26+
# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
27+
# MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
28+
# IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
29+
# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
30+
# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
31+
# OTHER DEALINGS IN THE SOFTWARE.
32+
#
33+
# For more information, please refer to <http://unlicense.org/>
34+
135
FROM alpine as builder
236

337
WORKDIR /tk5/
@@ -17,15 +51,13 @@ RUN rm -rf /tk5/hercules/darwin && \
1751
FROM alpine
1852
MAINTAINER jsl
1953
LABEL version="1.00"
20-
LABEL description="Tur(n)key Level 5 Version 1.00"
21-
#LABEL description="OS/VS2 MVS 3.8j Service Level 8505, Tur(n)key Level 4- Version 1.00"
54+
LABEL description="OS/VS2 MVS 3.8j Service Level 8505, Tur(n)key Level 5 Version 1.00"
2255
WORKDIR /tk5/
2356
COPY --from=builder /tk5/ .
24-
VOLUME [ "/tk5/conf","/tk5/local_conf","/tk5/local_scripts","/tk5/prt","/tk5/dasd","/tk5/pch","/tk5/jcl","tk5/log" ]
57+
VOLUME [ "/tk5/conf","/tk5/local_conf","/tk5/local_scripts","/tk5/prt","/tk5/dasd","/tk5/pch","/tk5/jcl","tk5/log", "tk5/tape" ]
2558
RUN apk update && apk upgrade
2659
RUN apk add gcompat libstdc++ bash libbz2
2760
RUN cd /usr/lib && \
2861
ln -s libbz2.so.1 libbz2.so.1.0
29-
3062
CMD ["/tk5/mvs"]
3163
EXPOSE 3270 8038

‎README.md‎

Lines changed: 27 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,48 +1,46 @@
11
# tk5-hercules
22

3+
[![License: The Unlicense](https://img.shields.io/badge/License-Unlicense-blue.svg)](https://unlicense.org)
4+
35
Port of skunklabz' [tk4-hercules](https://github.com/skunklabz/tk4-hercules) docker file to [MVS 3.8j with Turnkey Version 5.2](https://www.prince-webdesign.nl/tk5), now running on Alpine Linux
46

57
## Usage
68

79
- Run `docker run -ti -p 3270:3270 -p8038:8038 skunklabz/tk5-hercules`
810
- Use a browser to check on the system's status by visiting `http://127.0.0.1:8038`
9-
- Boot startup will take approx. 60 seconds.
10-
- Once the bootup is complete and you see the Turnkey boot screen, use e.g. `c3270 127.0.0.1:3270` for connecting to the local MVS instance.
11+
- Total boot startup will take approximately 60 seconds.
12+
- Once the bootup is complete and you see the Turnkey boot screen on the status page, use e.g. `c3270 127.0.0.1:3270` for connecting to the local MVS instance.
1113

1214

1315
## Persistence
14-
(copied from [tk4-hercules](https://github.com/skunklabz/tk4-hercules)'s documentation):
15-
1616
To run with persistence so that you don't lose your data after stopping the docker container please use the following command to start it up.
1717

1818
```
1919
docker run -d \
20-
--mount source=tk4-conf,target=/tk4-/conf \
21-
--mount source=tk4-local_conf,target=/tk4-/local_conf \
22-
--mount source=tk4-local_scripts,target=/tk4-/local_scripts \
23-
--mount source=tk4-prt,target=/tk4-/prt \
24-
--mount source=tk4-dasd,target=/tk4-/dasd \
25-
--mount source=tk4-pch,target=/tk4-/pch \
26-
--mount source=tk4-jcl,target=/tk4-/jcl \
27-
--mount source=tk4-log,target=/tk4-/log \
20+
--mount source=tk5-conf,target=/tk5/conf \
21+
--mount source=tk5-local_conf,target=/tk5/local_conf \
22+
--mount source=tk5-local_scripts,target=/tk5/local_scripts \
23+
--mount source=tk5-prt,target=/tk5/prt \
24+
--mount source=tk5-dasd,target=/tk5/dasd \
25+
--mount source=tk5-pch,target=/tk5/pch \
26+
--mount source=tk5-jcl,target=/tk5/jcl \
27+
--mount source=tk5-log,target=/tk5/log \
28+
--mount source=tk5-tape,target=/tk5/tape \
2829
-p 3270:3270 \
29-
-p 8038:8038 tk4
30+
-p 8038:8038 tk5
3031
```
3132

3233
### Description of persisted directories
33-
- /tk4-/conf
34-
- This is where the master configuration file tk4-.cnf is stored
35-
- /tk4-/local_conf
36-
- Scripts for initialization and unattended operations
37-
- /tk4-/local_scripts
38-
- There are 10 files located here that are meant for user applied modifications and are run after Hercules initialization, when operating in manual mode or after MVS 3.8j initialization when operating in unattended mode
39-
- /tk4-/prt
40-
- Used for simulated line printer devices
41-
- /tk4-/pch
42-
- Card punch devices output stored here
43-
- /tk4-/dasd
44-
- This contains all of the simulated CKD DASD volumes. Count key data or CKD is a direct-access storage device (DASD)
45-
- /tk4-/jcl
46-
- contains the SYSGEN Job Control Files
47-
- /tk4-/log
48-
- contains log files created during sysgen
34+
35+
| Directory | Description |
36+
|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
37+
| `/tk5/conf` | This is where the master configuration file `tk5.cnf` is stored |
38+
| `/tk5/local_conf` | Scripts for initialization and unattended operations |
39+
| `/tk5/local_scripts` | There are 10 files located here that are meant for user applied modifications and are run after Hercules initialization, when operating in manual mode or after MVS 3.8j initialization when operating in unattended mode |
40+
| `/tk5/prt` | Used for simulated line printer devices |
41+
| `/tk5/pch` | Card punch devices output stored here |
42+
| `/tk5/dasd` | This contains all of the simulated CKD DASD volumes. Count key data or CKD is a direct-access storage device (DASD) | |
43+
| `/tk5/jcl` | contains the SYSGEN Job Control Files |
44+
| `/tk5/log` | contains log files created during sysgen |
45+
| `/tk5/tape` | Used for simulated tape devices |
46+

0 commit comments

Comments
 (0)