Skip to content

Commit 930e17f

Browse files
committed
v3.7.0
1 parent f30f6ac commit 930e17f

File tree

3 files changed

+117
-72
lines changed

3 files changed

+117
-72
lines changed

β€ŽREADME.mdβ€Ž

Lines changed: 95 additions & 71 deletions
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ In addition to migrating your data professionally and securely with minimum effo
1818
<br/>
1919

2020
<p align="center">
21-
<a href="http://www.youtube.com/watch?v=8hSrFVOw3Rc"><img alt="CYBERTEC Migrator v3 Demonstration" width="384px" src="http://img.youtube.com/vi/8hSrFVOw3Rc/0.jpg"/></a><br/>
21+
<a href="https://www.youtube.com/watch?v=z79_lZHmDG4&t=0s"><img alt="CYBERTEC Migrator v3 Demonstration" width="384px" src="http://img.youtube.com/vi/8hSrFVOw3Rc/0.jpg"/></a><br/>
2222
<b>Product Demo</b>
2323
</p>
2424

@@ -29,125 +29,142 @@ For detailed information see the list of [supported migration features for Oracl
2929
## Table of Contents
3030

3131
1. [What's New](#whats-new)
32-
2. [Getting Started](#getting-started)
33-
3. [Running the Migrator](#running-the-migrator)
34-
4. [Contact](#contact)
32+
1. [Getting Started](#getting-started)
33+
1. [Running the Migrator](#running-the-migrator)
34+
1. [Contact](#contact)
35+
1. [License](#license)
3536

3637
## What's New
3738

3839
For older releases see [Release Notes](RELEASE_NOTES.md).
3940

40-
### v3.6.0 - 2022-04-26
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.
4146

4247
#### Features
4348

44-
- Add support for __stage post-hook SQL scripts__ to adapt the migration with functionalities not provided by the Migrator.
45-
The scripts are executed at the end of a stage.
46-
Typical use cases for such scripts are to create database objects which are not present in the source database, or to define ownership and access permissions.
47-
- Add a stage post-hook script in the _Stages Tab_.
48-
<p align="left">
49-
<img src="./docs/pictures/release-notes/v3.6.0/stage-post-hook-scripts.png"></img>
50-
</p>
51-
- Editor for stage hook scripts. It is possible to temporary disable a hook script.
52-
<p align="left">
53-
<img src="./docs/pictures/release-notes/v3.6.0/stage-post-hook-script-editor.png"></img>
54-
</p>
55-
- The execution of the stage post-hook scripts are __logged for audit purposes__.
56-
<p align="left">
57-
<img src="./docs/pictures/release-notes/v3.6.0/stage-post-hook-script-logging.png"></img>
58-
</p>
59-
- Improve _Data stage_: list and range __partitions and sub-partitions__ of partitioned tables are __migrated in parallel__.
60-
- Support migration of `GENERATED AS IDENTITY` constraint.
61-
- Improve user experience:
62-
- Code editors verify DDL code to provide fast error feedback.
63-
<p align="left">
64-
<img src="./docs/pictures/release-notes/v3.6.0/editor-code-verification.png"></img>
65-
</p>
66-
- Add keyboard hotkey `Ctrl`-`Enter` to start migration job execution.
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
6753

6854
#### Resolved Bugs
6955

70-
- Failed to created migration of an Oracle database containing a column that uses a data-type from the `SYS` schema
71-
- Starting a migration job with more than one stage and incorrect target connection bricks the migration
72-
- Sidebar filter showing schemas that contain none of the filter results
73-
- Misleading console log entries `No metadata found. There is more than once class-validator version installed probably ...`
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+
7460

7561
## Getting Started
7662

7763
### Requirements
7864

79-
_CYBERTEC Migrator_ is distributed as a set of [Docker](https://www.docker.com/) images that are brought up by [Docker Compose](https://docs.docker.com/compose/).
65+
_CYBERTEC Migrator_ is distributed as a set of [container images](https://github.com/opencontainers/image-spec/blob/main/spec.md) that are managed with the help of [Docker Compose](https://docs.docker.com/compose/).
8066

8167
- [`docker`](https://docs.docker.com/get-docker/)
8268
- [`docker-compose`](https://docs.docker.com/compose/install/) (`>= 1.27.0`)
8369
- `git` (`>= 2.20.1`)
8470
- `bash` (`>= 4.0`)
8571

86-
### Obtaining Images
8772

88-
_CYBERTEC Migrator_ images can be obtained through Docker Hub.
89-
An offline installation package is also available for environments in which networking restrictions are imposed.
73+
### Migrator Installation
74+
75+
The _CYBERTEC Migrator_ images can be obtained via two channels
76+
- [Online installation via container registry](#online-installation)
77+
- From an [offline installation](#offline-installation) package for environments in which networking restrictions are imposed
78+
79+
| πŸ’‘ | The Migrator Standard Edition is only available as [offline installation package](https://www.cybertec-postgresql.com/en/products/cybertec-migrator#form) |
80+
| --- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
81+
82+
#### Online installation
83+
84+
You need an account on the [Docker Hub](https://hub.docker.com/) container image registry.
9085

91-
- Docker Hub
9286
Please [get in touch with us](#contact) if your account has not been granted access to the respective images.
87+
Make sure you are logged in the Docker Hub registry with the correct user.
9388

9489
```sh
9590
cat ~/password.txt | docker login --username <username> --password-stdin
9691
```
9792

98-
- Offline installation package
99-
Please [get in touch with us](#contact) to request download credentials.
100-
101-
### Setup
102-
103-
- Online installation
104-
105-
1. Clone the repository
106-
2. Change directory into cloned repository
93+
1. Clone this git repository
94+
2. Change working directory to the previously cloned repository
10795
3. Generate default configuration
108-
4. Download images
109-
110-
<br/>
96+
4. Download and load container images
97+
5. Start the Migrator
11198

11299
```sh
113-
git clone https://github.com/cybertec-postgresql/cybertec_migrator
114-
cd cybertec_migrator
115-
./migrator configure
116-
./migrator install
100+
➜ git clone https://github.com/cybertec-postgresql/cybertec_migrator
101+
➜ cd cybertec_migrator
102+
➜ ./migrator configure
103+
[OK] Generated environment file
104+
[INFO] Run './migrator install' to complete setup
105+
➜ ./migrator install
106+
[INFO] Pulling v3.7.0
107+
Pulling core_db ... done
108+
Pulling core ... done
109+
Pulling web_gui ... done
110+
[OK] Pulled v3.7.0
111+
[INFO] Upgraded to v3.7.0
112+
[INFO] Run './migrator up' to switch to new version
113+
[WARN] Switching will abort running migrations
114+
➜ ./migrator up
115+
Creating network "cybertec_migrator-network" with the default driver
116+
Creating cybertec_migrator_core_db_1 ... done
117+
Creating cybertec_migrator_core_1 ... done
118+
Creating cybertec_migrator_web_gui_1 ... done
119+
[OK] Started on 'http://localhost'
117120
```
118121

119-
- Offline installation
122+
#### Offline installation
120123

121-
| πŸ’‘ | Installation archives also serve as upgrade archives |
122-
| --- | ---------------------------------------------------- |
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.
125+
For the Professional or Enterprise Edition [get in touch with us](#contact) to request download credentials.
123126

124127
1. Extract the provided archive file
125-
2. Change directory to the directory created in the previous step
128+
2. Change working directory to newly created directory
126129
3. Generate default configuration
127-
4. Import images from archive
128-
129-
<br/>
130+
4. Import container images from archive
131+
5. Start the Migrator
130132

131133
```sh
132-
tar xf cybertec_migrator-vX.Y.Z.tar.gz
133-
cd cybertec_migrator
134-
./migrator configure
135-
./migrator install --archive ../cybertec_migrator-vX.Y.Z.tar.gz
134+
➜ tar xf cybertec_migrator-v3.7.0-standard.tar.gz
135+
➜ cd cybertec_migrator
136+
➜ ./migrator configure
137+
[OK] Generated environment file
138+
[INFO] Run './migrator install' to complete setup
139+
➜ ./migrator install --archive ../cybertec_migrator-v3.7.0-standard.tar.gz
140+
[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
143+
Loaded image: postgres:13-alpine
144+
[INFO] Extracted upgrade information
145+
[INFO] Upgraded to v3.7.0-standard
146+
[INFO] Run './migrator up' to switch to new version
147+
[WARN] Switching will abort running migrations
148+
➜ ./migrator up
149+
Creating network "cybertec_migrator-network" with the default driver
150+
Creating cybertec_migrator_core_db_1 ... done
151+
Creating cybertec_migrator_core_1 ... done
152+
Creating cybertec_migrator_web_gui_1 ... done
153+
[OK] Started on 'http://localhost'
136154
```
137155

138156
## Running the Migrator
139157

140-
```sh
141-
./migrator up
142-
```
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.
143159

144-
CYBERTEC Migrator only supports connections via HTTP.
160+
The configuration is __not meant to be used in production environment__.
161+
Adapt the NGINX configuration in `docker/templates/default.conf.template` to your needs to run the service on HTTPS with proper credentials.
145162

146-
The `EXTERNAL_HTTP_PORT` variable in the `.env` file (generated by `./migrator configure`) controls the choice of port on which the Migrator is served.
163+
If you don't have access to an Oracle or PostgreSQL database to test the Migrator, use our [Migrator demo database environment](https://github.com/cybertec-postgresql/cybertec_migrator_demo).
147164

148165
### Upgrades
149166

150-
| ⚠️ | Running migrations _will_ be interrupted by applying upgrades |
167+
| ⚠️ | Running migrations _will_ be interrupted by applying upgrades |
151168
| --- | ------------------------------------------------------------- |
152169

153170
- Online upgrade
@@ -166,6 +183,9 @@ The `EXTERNAL_HTTP_PORT` variable in the `.env` file (generated by `./migrator c
166183

167184
- Offline upgrade
168185

186+
| πŸ’‘ | Installation archives also serve for upgrading the Migrator |
187+
| --- | ----------------------------------------------------------- |
188+
169189
1. Update release information
170190
2. Upgrade to version bundled in archive
171191
3. Apply upgrade
@@ -181,4 +201,8 @@ The `EXTERNAL_HTTP_PORT` variable in the `.env` file (generated by `./migrator c
181201
## Contact
182202

183203
- [Sales](https://www.cybertec-postgresql.com/en/contact/)
184-
- [Report Bug](https://cybertec.atlassian.net/servicedesk/customer/portal/3/group/4/create/23)
204+
205+
## License
206+
207+
The content of this repository is under the [MIT License](LICENSE) in case you have to adapt the deployment to your needs.
208+
The CYBERTEC Migrator delivered in the container images uses a proprietary license with an [EULA](EULA.md).

β€ŽRELEASE_NOTES.mdβ€Ž

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

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

5+
### v3.7.0 - 2022-05-18
6+
7+
Do you want to know if the Migrator can migrate your Oracle database to PostgreSQL?
8+
9+
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.
10+
11+
#### Features
12+
13+
- Improve migration job execution (which removed the Redis job queue as a dependency)
14+
- Provide help menu to reach out to CYBERTEC
15+
- Provide a [Migrator demo database environment](https://github.com/cybertec-postgresql/cybertec_migrator_demo) to facilitate a test-run of the Migrator Standard Edition
16+
- Added [License](#license) information
17+
18+
#### Resolved Bugs
19+
20+
- Error when attempting to edit a function, procedure, trigger or view containing a `#` in its name
21+
- Trigger Type and Level can be changed even if the trigger is excluded
22+
- Column data-types qualified with `SYS` are not translated properly
23+
524
### v3.6.0 - 2022-04-26
625

726
#### Features

β€Ždocs/oracle-migration-support.mdβ€Ž

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
11
# Supported features for migration from Oracle
22

3+
Supported features of the [CYBERTEC Migrator](../README.md).
4+
35
## Database Object Types
46

57
| CREATE | | Comment |
68
|-------------------|----|------------------------------------------------------------|
7-
| DATABASE LINK | βœ… | |
9+
| DATABASE LINK | βœ… | visible, use PostgreSQL [Foreign Data Wrapper] |
810
| DIRECTORY | ❌ | |
911
| FUNCTION | βœ… | code needs to be translated manually |
1012
| INDEX | βœ… | |

0 commit comments

Comments
Β (0)