Skip to content

Commit 9abb7f1

Browse files
authored
v3.8.0
1 parent 4f7c430 commit 9abb7f1

File tree

7 files changed

+83
-25
lines changed

7 files changed

+83
-25
lines changed

β€Ž.github/ISSUE_TEMPLATE/bug_report.ymlβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ body:
4747
label: "Migrator version"
4848
description: |
4949
Which version of the CYBERTEC Migrator are you using?
50-
placeholder: "3.7.0"
50+
placeholder: "3.8.0"
5151

5252
- type: checkboxes
5353
validations:

β€Ž.github/ISSUE_TEMPLATE/question.ymlβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ body:
1414
label: "Migrator version"
1515
description: |
1616
Which version of the CYBERTEC Migrator are you using?
17-
placeholder: "3.7.0"
17+
placeholder: "3.8.0"
1818

1919
- type: textarea
2020
attributes:

β€ŽREADME.mdβ€Ž

Lines changed: 48 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,9 @@
1515
[_CYBERTEC Migrator_](https://www.cybertec-postgresql.com/en/products/cybertec-migrator/) is a streamlined and user-friendly tool that helps you to organize and efficiently migrate multiple Oracle databases to PostgreSQL.
1616
In addition to migrating your data professionally and securely with minimum effort, _CYBERTEC Migrator_ allows you to visually monitor and track the whole process at any time.
1717

18+
Do you want to know if the Migrator can migrate your Oracle database to PostgreSQL?
19+
Then [get the Migrator Standard Edition](https://www.cybertec-postgresql.com/en/products/cybertec-migrator#form), a __free version__ of the CYBERTEC Migrator, follow the offline instructions provided in [Getting Started](#offline-installation) section, and try it out.
20+
1821
<br/>
1922

2023
<p align="center">
@@ -31,32 +34,46 @@ For detailed information see the list of [supported migration features for Oracl
3134
1. [What's New](#whats-new)
3235
1. [Getting Started](#getting-started)
3336
1. [Running the Migrator](#running-the-migrator)
37+
1. [Getting Help](#getting-help)
3438
1. [Contact](#contact)
3539
1. [License](#license)
3640

3741
## What's New
3842

3943
For older releases see [Release Notes](RELEASE_NOTES.md).
4044

41-
### v3.7.0 - 2022-05-18
42-
43-
Do you want to know if the Migrator can migrate your Oracle database to PostgreSQL?
44-
45-
Then [get the Migrator Standard Edition](https://www.cybertec-postgresql.com/en/products/cybertec-migrator#form), a __free version__ (as in beer) of the CYBERTEC Migrator, follow the offline instructions provided in [Getting Started](#offline-installation) section, and try it out.
45+
### v3.8.0 - 2022-06-29
4646

4747
#### Features
4848

49-
- Improve migration job execution (which removed the Redis job queue as a dependency)
50-
- Provide help menu to reach out to CYBERTEC
51-
- Provide a [Migrator demo database environment](https://github.com/cybertec-postgresql/cybertec_migrator_demo) to facilitate a test-run of the Migrator Standard Edition
52-
- Added [License](#license) information
49+
- Configure the maximal number of parallel data transfers and index creation workers for each migration.
50+
The Migrator picks reasonable default values when a new migration is created:
51+
- `Data Tranfers`: number of CPUs where the Migrator is hosted
52+
- `Database Workers`: number of CPUs of the target database. Make sure to tune this parameter with the PostgreSQL configuration of [max_worker_processes, max_parallel_workers, max_parallel_maintenance_workers](https://www.postgresql.org/docs/current/runtime-config-resource.html)
53+
<p align="left">
54+
<img src="./docs/pictures/release-notes/v3.8.0/settings-parallel-workers.png"></img>
55+
</p>
56+
- Enhance sidebar: show synonym meta-data as pop-up
57+
<p align="left">
58+
<img src="./docs/pictures/release-notes/v3.8.0/sidebar-shows-synonym-meta-data.png"></img>
59+
</p>
60+
- Set/clear object type filter by selecting an `Object Type` in the overview tab. Use the `CTRL` key to filter for more than one database object type.
61+
<p align="left">
62+
<img src="./docs/pictures/release-notes/v3.8.0/set-object-type-filter-from-overview-tab.png"></img>
63+
</p>
64+
- Add [issue templates](https://github.com/cybertec-postgresql/cybertec_migrator/issues/new/choose) for asking questions.
5365

5466
#### Resolved Bugs
5567

56-
- Error when attempting to edit a function, procedure, trigger or view containing a `#` in its name
57-
- Trigger Type and Level can be changed even if the trigger is excluded
58-
- Column data-types qualified with `SYS` are not translated properly
59-
68+
* Empty connection check error message on `504 Gateway Time-Out`
69+
* Broken GUI workflow in the Analyze step on `504 Gateway Time-Out`
70+
* Error on migrating `REVERSE` indexes: PostgreSQL does not have/need an equivalent feature
71+
* Opening a non-existent migration endlessly shows the loading animation
72+
* Error on migrating sequences with negative `INCREMENT` - `START value cannot be greater than MAXVALUE`
73+
* Migration controls (resume, continue, etc.) occasionally do not behave as expected
74+
* Views depending on other views are not created in the correct order
75+
* Spacing between the migration log time and level is jumping
76+
* Incorrect name conflict detection for tables and triggers with the same identifier
6077

6178
## Getting Started
6279

@@ -103,12 +120,12 @@ The _CYBERTEC Migrator_ images can be obtained via two channels
103120
[OK] Generated environment file
104121
[INFO] Run './migrator install' to complete setup
105122
➜ ./migrator install
106-
[INFO] Pulling v3.7.0
123+
[INFO] Pulling v3.8.0
107124
Pulling core_db ... done
108125
Pulling core ... done
109126
Pulling web_gui ... done
110-
[OK] Pulled v3.7.0
111-
[INFO] Upgraded to v3.7.0
127+
[OK] Pulled v3.8.0
128+
[INFO] Upgraded to v3.8.0
112129
[INFO] Run './migrator up' to switch to new version
113130
[WARN] Switching will abort running migrations
114131
➜ ./migrator up
@@ -121,7 +138,8 @@ The _CYBERTEC Migrator_ images can be obtained via two channels
121138

122139
#### Offline installation
123140

124-
Get your Migrator installation package. You can get the Migrator Standard Edition [here](https://www.cybertec-postgresql.com/en/products/cybertec-migrator#form) for free.
141+
Get your Migrator offline installation package.
142+
You can get the Migrator Standard Edition [here](https://www.cybertec-postgresql.com/en/products/cybertec-migrator#form) for free.
125143
For the Professional or Enterprise Edition [get in touch with us](#contact) to request download credentials.
126144

127145
1. Extract the provided archive file
@@ -131,18 +149,18 @@ The _CYBERTEC Migrator_ images can be obtained via two channels
131149
5. Start the Migrator
132150

133151
```sh
134-
➜ tar xf cybertec_migrator-v3.7.0-standard.tar.gz
152+
➜ tar xf cybertec_migrator-v3.8.0-standard.tar.gz
135153
➜ cd cybertec_migrator
136154
➜ ./migrator configure
137155
[OK] Generated environment file
138156
[INFO] Run './migrator install' to complete setup
139-
➜ ./migrator install --archive ../cybertec_migrator-v3.7.0-standard.tar.gz
157+
➜ ./migrator install --archive ../cybertec_migrator-v3.8.0-standard.tar.gz
140158
[INFO] Extracting upgrade information
141-
Loaded image: cybertecpostgresql/cybertec_migrator-core:v3.7.0-standard
142-
Loaded image: cybertecpostgresql/cybertec_migrator-web_gui:v3.7.0-standard
159+
Loaded image: cybertecpostgresql/cybertec_migrator-core:v3.8.0-standard
160+
Loaded image: cybertecpostgresql/cybertec_migrator-web_gui:v3.8.0-standard
143161
Loaded image: postgres:13-alpine
144162
[INFO] Extracted upgrade information
145-
[INFO] Upgraded to v3.7.0-standard
163+
[INFO] Upgraded to v3.8.0-standard
146164
[INFO] Run './migrator up' to switch to new version
147165
[WARN] Switching will abort running migrations
148166
➜ ./migrator up
@@ -155,7 +173,9 @@ The _CYBERTEC Migrator_ images can be obtained via two channels
155173

156174
## Running the Migrator
157175

158-
The configuration provided with this repository starts the CYBERTEC Migrator via HTTP. The `EXTERNAL_HTTP_PORT` variable in the `.env` file (generated by `./migrator configure`) controls the choice of port on which the Migrator is served.
176+
Use your web browser to access the Migrator on the URL shown in the terminal with `migrator up`. In our example it would be `http://localhost`.
177+
178+
The configuration provided with this repository starts the CYBERTEC Migrator over HTTP. The `EXTERNAL_HTTP_PORT` variable in the `.env` file (generated by `./migrator configure`) controls the choice of port on which the Migrator is served.
159179

160180
The configuration is __not meant to be used in production environment__.
161181
Adapt the NGINX configuration in `docker/templates/default.conf.template` to your needs to run the service on HTTPS with proper credentials.
@@ -198,6 +218,11 @@ If you don't have access to an Oracle or PostgreSQL database to test the Migrato
198218
./migrator up
199219
```
200220

221+
## Getting Help
222+
223+
Raising an [issue](https://github.com/cybertec-postgresql/cybertec_migrator/issues/new/choose) is encouraged.
224+
We have templates to report bugs, requesting a new feature or for general questions.
225+
201226
## Contact
202227

203228
- [Sales](https://www.cybertec-postgresql.com/en/contact/)

β€ŽRELEASE_NOTES.mdβ€Ž

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

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

5+
### v3.8.0 - 2022-06-29
6+
7+
#### Features
8+
9+
- Configure the maximal number of parallel data transfers and index creation workers for each migration.
10+
The Migrator picks reasonable default values when a new migration is created:
11+
- `Data Tranfers`: number of CPUs where the Migrator is hosted
12+
- `Database Workers`: number of CPUs of the target database. Make sure to tune this parameter with the PostgreSQL configuration of [max_worker_processes, max_parallel_workers, max_parallel_maintenance_workers](https://www.postgresql.org/docs/current/runtime-config-resource.html)
13+
<p align="left">
14+
<img src="./docs/pictures/release-notes/v3.8.0/settings-parallel-workers.png"></img>
15+
</p>
16+
- Enhance sidebar: show synonym meta-data as pop-up
17+
<p align="left">
18+
<img src="./docs/pictures/release-notes/v3.8.0/sidebar-shows-synonym-meta-data.png"></img>
19+
</p>
20+
- Set/clear object type filter by selecting an `Object Type` in the overview tab. Use the `CTRL` key to filter for more than one database object type.
21+
<p align="left">
22+
<img src="./docs/pictures/release-notes/v3.8.0/set-object-type-filter-from-overview-tab.png"></img>
23+
</p>
24+
- Add [issue templates](https://github.com/cybertec-postgresql/cybertec_migrator/issues/new/choose) for asking questions.
25+
26+
#### Resolved Bugs
27+
28+
* Empty connection check error message on `504 Gateway Time-Out`
29+
* Broken GUI workflow in the Analyze step on `504 Gateway Time-Out`
30+
* Error on migrating `REVERSE` indexes: PostgreSQL does not have/need an equivalent feature
31+
* Opening a non-existent migration endlessly shows the loading animation
32+
* Error on migrating sequences with negative `INCREMENT` - `START value cannot be greater than MAXVALUE`
33+
* Migration controls (resume, continue, etc.) occasionally do not behave as expected
34+
* Views depending on other views are not created in the correct order
35+
* Spacing between the migration log time and level is jumping
36+
* Incorrect name conflict detection for tables and triggers with the same identifier
37+
538
### v3.7.0 - 2022-05-18
639

740
Do you want to know if the Migrator can migrate your Oracle database to PostgreSQL?
54.6 KB
Loading
44.5 KB
Loading
90.9 KB
Loading

0 commit comments

Comments
Β (0)