Installing on Windows v55

You can use the graphical installer to install the Migration Toolkit on Windows. To download the installer, visit the Downloads page.

Once you download the installer, right-click the installer icon, and select Run As Administrator from the context menu. When the Language Selection popup opens, select an installation language and click OK to continue to the Setup window.

Note

This guide uses the term Stack Builder to refer to either StackBuilder Plus (distributed with EDB Postgres Advanced Server) or Stack Builder (distributed with the PostgreSQL one-click installer from EnterpriseDB).

You must have a Java JVM (version 1.8.0 or later) in place before Stack Builder can perform a Migration Toolkit installation.

The Java executable must be in your search path (%PATH% on Windows) Use the following commands to set the search path (substituting the name of the directory that holds the Java executable for javadir):

On Windows, use the command:

SET PATH=javadir;%PATH%

On Linux, use the command:

PATH=javadir:$PATH

After setting the search path, you can use the Stack Builder installation wizard to install Migration Toolkit into either EDB Postgres Advanced Server or PostgreSQL.

Launching StackBuilder Plus from EDB Postgres Advanced Server

To launch StackBuilder Plus from an existing EDB Postgres Advanced Server installation, navigate through the Start (or Applications) menu to the EDB Postgres menu; open the EDB Add-ons menu, and select the StackBuilder Plus menu option.

Launching Stack Builder from PostgreSQL

To launch Stack Builder from a PostgreSQL installation, navigate through the Start (or Applications) menu to the PostgreSQL menu, and select the Application StackBuilder Plus menu option.

Stack Builder opens as shown below.

The Stack Builder welcome window.

The Stack Builder welcome window

Use the drop-down listbox to select the target server installation from the list of available servers. If your network requires you to use a proxy server to access the Internet, use the Proxy servers button to open the Proxy servers dialog and specify a server; if you do not need to use a proxy server, click Next to open the application selection window.

If you are using StackBuilder Plus to add Migration Toolkit to your EDB Postgres Advanced Server installation, expand the Add-ons, tools and utilities node of the tree control, and check the box next to EnterpriseDB Migration Toolkit. Click Next to continue.

Note

If you are using Stack Builder to add Migration Toolkit to your PostgreSQL installation, expand the EnterpriseDB Tools node of the tree control (located under the Registration-required and trial productsnode), and select Migration Toolkit checkbox. Click Next to continue.

The Stack Builder application selection window.

The Stack Builder application selection window

Confirm that Migration Toolkit is included in the Selected Packages list and that the Download directory field contains an acceptable download location.

The Stack Builder selection confirmation window.

The Stack Builder selection confirmation window

Click Next to start the Migration Toolkit download.

Stack Builder confirms the file download.

Stack Builder confirms the file download

When the download completes, Stack Builder confirms that the installation files have been successfully downloaded. Choose Next to open the Migration Toolkit installation wizard.

When prompted by the Migration Toolkit installation wizard, specify a language for the installation and click OK to continue.

The Migration Toolkit installation wizard opens. Click Next to continue.

The Migration Toolkit installation wizard.

The Migration Toolkit installation wizard

Carefully review the license agreement before highlighting the appropriate radio button; click Next to continue.

The EnterpriseDB license agreement.

The EnterpriseDB license agreement

By default, Migration Toolkit will be installed in the mtk directory; accept the default installation directory as displayed, or modify the directory, and click Next to continue.

Specify a Migration Toolkit installation directory.

Specify a Migration Toolkit installation directory

The installation wizard confirms that the Setup program is ready to install Migration Toolkit; click Next to start the installation.

Setup is ready to start the Migration Toolkit installation.

Setup is ready to start the Migration Toolkit installation

A dialog confirms that the Migration Toolkit installation is complete; click Finish to exit the Migration Toolkit installer.

The Migration Toolkit wizard has finished.

The Migration Toolkit wizard has finished

When Stack Builder finalizes installation of the last selected component, it displays the Installation Completed window. Click Finish to close Stack Builder.

Stack Builder confirms the installation is complete.

Stack Builder confirms the installation is complete

After installing Migration Toolkit, you must install the appropriate JDBC drivers before performing a migration. See Installing a JDBC driver for more information.