Skip to content

Commit 88fc67c

Browse files
KieranKaelinKieranKaelin
committed
v3.13.0
1 parent 7f67586 commit 88fc67c

File tree

6 files changed

+88
-40
lines changed

6 files changed

+88
-40
lines changed

‎README.md‎

Lines changed: 41 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -45,51 +45,52 @@ For detailed information see the list of [supported migration features for Oracl
4545

4646
For older releases see [Release Notes](RELEASE_NOTES.md).
4747

48-
### v3.12.0 - 2022-10-25
48+
### v3.13.0 - 2022-11-30
4949

5050
#### Features
5151

52-
- Enhance migration log in the data stage:
52+
- _Migration Assessment_:
5353

54-
- Improve summary of the start and end logs
54+
- Quickly determine how much effort an individual migration encompasses
55+
<p align="left">
56+
<img src="./docs/pictures/release-notes/v3.13.0/migration-assessment-bar-chart.png" />
57+
</p>
58+
- Inspect the cost for discrete database objects and identify outliers
59+
<p align="left">
60+
<img src="./docs/pictures/release-notes/v3.13.0/migration-assessment-table-and-donut-chart.png" />
61+
</p>
5562

56-
```text
57-
resumed data stage from oracle://localhost:1521/pdb1 to postgresql://localhost:5432/postgres: using 8 workers
58-
excluded tables: 1
59-
successful transfers: 1 (out of 7)
60-
remaining transfers: 6
63+
> Note: The figures given by the assessment are only a rough estimation. \
64+
> We will continue to tweak and improve these values as we collect experience and introduce new technologies, such as a PL/SQL parser.
6165
62-
...
66+
- _Migration Overview_: List empty and non-empty schemas separately
67+
<p align="left">
68+
<img src="./docs/pictures/release-notes/v3.13.0/migration-overview-empty-schemas.png" />
69+
</p>
6370

64-
failed executing data stage: stage run-time 00:01:534
65-
excluded tables: 1
66-
successful transfers: 6 (out of 7)
67-
remaining transfers: 1
68-
failed transfers: 1
69-
```
71+
> Note: Empty schemas are now excluded per default
7072
71-
- Print a warning if the source and/or target connection are not encrypted
72-
```text
73-
Info Data using secure connection to read data from oracle://pdb_sec [oracle://10.0.0.127:2484/pdb?protocol=tcps]
74-
Warning Data using insecure connection to write data to postgresql://localhost:5432/postgres
75-
```
76-
- Periodically log `data-migrator` transfer statistics for each table.
77-
This interval may be set using the [`CORE_DATA_MIGRATOR_PROGRESS_INTERVAL` environment variable](docs/faq.md#how-do-i-set-environment-variables) (default: `600000` milliseconds, `10` minutes)
73+
- _Migration Creation_: Improve feedback for invalid connection strings
74+
<p align="left">
75+
<img src="./docs/pictures/release-notes/v3.13.0/improved-connection-string-feedback.png" />
76+
</p>
7877

79-
```text
80-
Verbose Data loading data for table:"HR"."EMPLOYEES" [hr.employees]: processed 982 rows in 01:20.000 - 45 rows/sec (total: 41 rows/sec in 05:00.000)
81-
Verbose Data finished loading data for table:"HR"."EMPLOYEES" [hr.employees]: processed 1012 rows in 00:02:01 - 40 rows/sec
82-
```
78+
- _Migration Lifecycle_:
8379

84-
- Quote reserved identifiers when generating data queries for both Oracle and PostgreSQL
85-
- Add support for **secured communication** (TCPS) access to Oracle databases without using a _net service name_.
86-
For details, check out our [FAQ - How do I configure TCPS for Oracle databases](docs/faq.md#how-do-i-configure-tcps-for-oracle-databases) section
87-
- Configure the [`FREEZE` parameter](https://www.postgresql.org/docs/current/sql-copy.html) during the data transfer by setting the [`CORE_DATA_MIGRATOR_USE_COPY_FREEZE` environment variable](docs/faq.md#how-do-i-set-environment-variables) (default: `false`).
88-
Only use this setting if you are aware of its implications
80+
- Defer the creation of functions after those of tables to allow for the use of the `%TYPE` attribute
81+
- Enhance the migration log of the structure, integrity and logic stages to be on a par with those of the data stage
82+
- Configure the `COPY FREEZE` functionality introduced in `v3.12.0` for each individual table instead of the whole system.
83+
The `CORE_DATA_MIGRATOR_USE_COPY_FREEZE` environment variable has subsequently been removed.
84+
85+
- _Miscellaneous_: Rework the log output format and fidelity throughout the `core` container
8986

9087
#### Resolved Bugs
9188

92-
- An error on the target connection during the structure, integrity or logic stage may cause the Migrator core to crash
89+
- The Analyze step of the migration creation always shows `Jobs` as pending
90+
- LOBs exceeding the maximum size of 500MB do not fail with an appropriate error message
91+
- Setting the sidebar filter to `Index` does not include all indexes in the filter result
92+
- Usernames and passwords containing special characters cause the target connection check during migration creation to fail
93+
- Deleting a migration after executing a stage fails with an unexpected error
9394

9495
## Getting Started
9596

@@ -137,12 +138,12 @@ cat ~/password.txt | docker login --username <username> --password-stdin
137138
[OK] Generated environment file
138139
[INFO] Run './migrator install' to complete setup
139140
➜ ./migrator install
140-
[INFO] Pulling v3.12.0
141+
[INFO] Pulling v3.13.0
141142
Pulling core_db ... done
142143
Pulling core ... done
143144
Pulling web_gui ... done
144-
[OK] Pulled v3.12.0
145-
[INFO] Upgraded to v3.12.0
145+
[OK] Pulled v3.13.0
146+
[INFO] Upgraded to v3.13.0
146147
[WARN] Could not find TLS/SSL certificate
147148
[INFO] Run './migrator configure --tls self-signed-cert' to generate a self-signed TLS/SSL certificate
148149
➜ ./migrator configure --tls self-signed-cert
@@ -192,18 +193,18 @@ You can get the Migrator Standard Edition [here](https://www.cybertec-postgresql
192193
6. Start the Migrator
193194

194195
```sh
195-
➜ tar xf cybertec_migrator-v3.12.0-standard.tar.gz
196+
➜ tar xf cybertec_migrator-v3.13.0-standard.tar.gz
196197
➜ cd cybertec_migrator
197198
➜ ./migrator configure
198199
[OK] Generated environment file
199200
[INFO] Run './migrator install' to complete setup
200-
➜ ./migrator install --archive ../cybertec_migrator-v3.12.0-standard.tar.gz
201+
➜ ./migrator install --archive ../cybertec_migrator-v3.13.0-standard.tar.gz
201202
[INFO] Extracting upgrade information
202-
Loaded image: cybertecpostgresql/cybertec_migrator-core:v3.12.0-standard
203-
Loaded image: cybertecpostgresql/cybertec_migrator-web_gui:v3.12.0-standard
203+
Loaded image: cybertecpostgresql/cybertec_migrator-core:v3.13.0-standard
204+
Loaded image: cybertecpostgresql/cybertec_migrator-web_gui:v3.13.0-standard
204205
Loaded image: postgres:13-alpine
205206
[INFO] Extracted upgrade information
206-
[INFO] Upgraded to v3.12.0-standard
207+
[INFO] Upgraded to v3.13.0-standard
207208
[WARN] Could not find TLS/SSL certificate
208209
[INFO] Run './migrator configure --tls self-signed-cert' to generate a self-signed TLS/SSL certificate
209210
➜ ./migrator configure --tls self-signed-cert

‎RELEASE_NOTES.md‎

Lines changed: 47 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,53 @@
22

33
The release notes of the last release may be found on [README.md](README.md#whats-new).
44

5+
### v3.13.0 - 2022-11-30
6+
7+
#### Features
8+
9+
- _Migration Assessment_:
10+
11+
- Quickly determine how much effort an individual migration encompasses
12+
<p align="left">
13+
<img src="./docs/pictures/release-notes/v3.13.0/migration-assessment-bar-chart.png" />
14+
</p>
15+
- Inspect the cost for discrete database objects and identify outliers
16+
<p align="left">
17+
<img src="./docs/pictures/release-notes/v3.13.0/migration-assessment-table-and-donut-chart.png" />
18+
</p>
19+
20+
> Note: The figures given by the assessment are only a rough estimation. \
21+
> We will continue to tweak and improve these values as we collect experience and introduce new technologies, such as a PL/SQL parser.
22+
23+
- _Migration Overview_: List empty and non-empty schemas separately
24+
<p align="left">
25+
<img src="./docs/pictures/release-notes/v3.13.0/migration-overview-empty-schemas.png" />
26+
</p>
27+
28+
> Note: Empty schemas are now excluded per default
29+
30+
- _Migration Creation_: Improve feedback for invalid connection strings
31+
<p align="left">
32+
<img src="./docs/pictures/release-notes/v3.13.0/improved-connection-string-feedback.png" />
33+
</p>
34+
35+
- _Migration Lifecycle_:
36+
37+
- Defer the creation of functions after those of tables to allow for the use of the `%TYPE` attribute
38+
- Enhance the migration log of the structure, integrity and logic stages to be on a par with those of the data stage
39+
- Configure the `COPY FREEZE` functionality introduced in `v3.12.0` for each individual table instead of the whole system.
40+
The `CORE_DATA_MIGRATOR_USE_COPY_FREEZE` environment variable has subsequently been removed.
41+
42+
- _Miscellaneous_: Rework the log output format and fidelity throughout the `core` container
43+
44+
#### Resolved Bugs
45+
46+
- The Analyze step of the migration creation always shows `Jobs` as pending
47+
- LOBs exceeding the maximum size of 500MB do not fail with an appropriate error message
48+
- Setting the sidebar filter to `Index` does not include all indexes in the filter result
49+
- Usernames and passwords containing special characters cause the target connection check during migration creation to fail
50+
- Deleting a migration after executing a stage fails with an unexpected error
51+
552
### v3.12.0 - 2022-10-25
653

754
#### Features

‎docs/pictures/release-notes/v3.13.0/improved-connection-string-feedback.png‎

6.97 KB
Loading

‎docs/pictures/release-notes/v3.13.0/migration-assessment-bar-chart.png‎

32.7 KB
Loading

‎docs/pictures/release-notes/v3.13.0/migration-assessment-table-and-donut-chart.png‎

23.2 KB
Loading

‎docs/pictures/release-notes/v3.13.0/migration-overview-empty-schemas.png‎

4.84 KB
Loading

0 commit comments

Comments
 (0)