File size: 4,334 Bytes
4202f60
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
# Java 11+ Installation Guide for JAOPuTo Tool

**Required for**: JAO FBMC data collection via JAOPuTo tool

---

## Quick Install (Windows)

### Option 1: Adoptium Eclipse Temurin (Recommended)

1. **Download Java 17 (LTS)**:
   - Visit: https://adoptium.net/temurin/releases/
   - Select:
     - **Operating System**: Windows
     - **Architecture**: x64
     - **Package Type**: JDK
     - **Version**: 17 (LTS)
   - Download: `.msi` installer

2. **Install**:
   - Run the downloaded `.msi` file
   - Accept defaults (includes adding to PATH)
   - Click "Install"

3. **Verify**:
   ```bash
   java -version
   ```
   Should output: `openjdk version "17.0.x"`

---

### Option 2: Chocolatey (If Installed)

```bash
choco install temurin17
```

Then verify:
```bash
java -version
```

---

### Option 3: Manual Download (Alternative)

If Adoptium doesn't work:

1. **Oracle JDK** (Requires Oracle account):
   - https://www.oracle.com/java/technologies/downloads/#java17

2. **Amazon Corretto**:
   - https://aws.amazon.com/corretto/

---

## Post-Installation

### 1. Verify Java Installation

Open **Git Bash** or **Command Prompt** and run:

```bash
java -version
```

**Expected output**:
```
openjdk version "17.0.10" 2024-01-16
OpenJDK Runtime Environment Temurin-17.0.10+7 (build 17.0.10+7)
OpenJDK 64-Bit Server VM Temurin-17.0.10+7 (build 17.0.10+7, mixed mode, sharing)
```

### 2. Verify JAVA_HOME (Optional but Recommended)

```bash
echo $JAVA_HOME  # Git Bash
echo %JAVA_HOME%  # Command Prompt
```

If not set, add to environment variables:
- Path: `C:\Program Files\Eclipse Adoptium\jdk-17.0.10.7-hotspot\`
- Variable: `JAVA_HOME`

### 3. Test JAOPuTo

Download JAOPuTo.jar (see next section), then test:

```bash
java -jar tools/JAOPuTo.jar --help
```

Should display help information without errors.

---

## Download JAOPuTo Tool

### Official Download

1. **Visit**: https://publicationtool.jao.eu/core/
2. **Look for**: Download section or "JAOPuTo" link
3. **Save to**: `C:\Users\evgue\projects\fbmc_chronos2\tools\JAOPuTo.jar`

### Alternative Sources

If official site is unclear:

1. **JAO Support**:
   - Email: [email protected]
   - Subject: "JAOPuTo Tool Download Request"
   - Request: Latest JAOPuTo.jar for FBMC data download

2. **Check Documentation**:
   - https://www.jao.eu/core-fbmc
   - Look for API or data download tools

---

## Troubleshooting

### Issue: "java: command not found"

**Solution 1**: Restart Git Bash/terminal after installation

**Solution 2**: Manually add Java to PATH
- Open: System Properties → Environment Variables
- Edit: PATH
- Add: `C:\Program Files\Eclipse Adoptium\jdk-17.0.10.7-hotspot\bin`
- Restart terminal

### Issue: "JAR file not found"

**Check**:
```bash
ls -la tools/JAOPuTo.jar
```

**Solution**: Ensure JAOPuTo.jar is in `tools/` directory

### Issue: "Unsupported Java version"

JAOPuTo requires Java **11 or higher**.

Check version:
```bash
java -version
```

If you have Java 8 or older, install Java 17 (LTS).

### Issue: Multiple Java Versions

If you have multiple Java installations:

1. Check current version:
   ```bash
   java -version
   ```

2. List all installations:
   ```bash
   where java  # Windows
   ```

3. Set specific version:
   - Update PATH to prioritize Java 17
   - Or use full path: `"C:\Program Files\Eclipse Adoptium\...\bin\java.exe"`

---

## Next Steps After Java Installation

Once Java is installed and verified:

1. **Download JAOPuTo.jar**:
   - Save to: `tools/JAOPuTo.jar`

2. **Test JAO collection**:
   ```bash
   python src/data_collection/collect_jao.py --manual-instructions
   ```

3. **Begin Day 1 data collection**:
   ```bash
   # OpenMeteo (5 minutes)
   python src/data_collection/collect_openmeteo.py

   # ENTSO-E (longer, depends on data volume)
   python src/data_collection/collect_entsoe.py

   # JAO FBMC data
   python src/data_collection/collect_jao.py
   ```

---

## Quick Reference

| Item | Value |
|------|-------|
| **Recommended Version** | Java 17 (LTS) |
| **Minimum Version** | Java 11 |
| **Download** | https://adoptium.net/temurin/releases/ |
| **JAOPuTo Tool** | https://publicationtool.jao.eu/core/ |
| **Support** | [email protected] |
| **Verify Command** | `java -version` |

---

**Document Version**: 1.0
**Last Updated**: 2025-10-27
**Project**: FBMC Flow Forecasting MVP