Upgrading to IBM AD V 6.1.3.0
- By using IBM AD Upgrade Wizard.
- Upgrading from IBM AD V6.1.2.0 by using IBM AD Upgrade Wizard
- Upgrading from IBM AD V6.1.1.0 by using IBM AD Upgrade Wizard
- Upgrading from IBM AD V6.1.0.0 by using IBM AD Upgrade Wizard
- Upgrading from IBM AD V6.0.2.0 by using IBM AD Upgrade Wizard
- Upgrading from IBM AD V6.0.1.0 by using IBM AD Upgrade Wizard
- Upgrading from IBM AD V6.0.0.0 by using IBM AD Upgrade Wizard
- Upgrading from IBM AD V5.1.0.9 by using IBM AD Upgrade Wizard
- Upgrading from IBM AD V5.1.0.8 by using IBM AD Upgrade Wizard
- Upgrading from IBM AD V5.1.0.7 by using IBM AD Upgrade Wizard
Important: If you upgrade IBM AD since V5.1.0.7 by using IBM AD Upgrade Wizard, you must run the IBM AD Upgrade Wizard after the installation is finished. Otherwise, some configurations might be lost. For example, the audit service will not be started. - By choosing one of the following upgrade scenarios and by checking the detailed instructions in the corresponding section.
Upgrading from IBM AD V6.1.2.0 by using IBM AD Upgrade Wizard
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same
IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Configuration Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application Discovery and Delivery Intelligence for IBM Z is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Notes:
- Depending on the machine performance, you might see that the Context root not found page in your browser. Wait for a minute and then refresh the page until you see the IBM AD Configuration Wizard showing in your browser.
- Depending on the machine performance, the browser might display a message indicating that it does not trust the website's certificate. This can also occur if the browser was opened during the installation of Application Discovery and did not have the opportunity to load the newly installed Application Discovery self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the URL of the IBM AD Configuration Wizard, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM AD Configuration Wizard page now is displayed without any warnings.
- Go through IBM AD Configuration Wizard, continue with the rest
of the steps, and click Done.Note: During this step, you might be asked to restart the browser, reconfigure security settings, or reconfigure the relational database server due to the upgrade of security settings in AD. You can follow these pages to complete the reconfigurations.
- Access IBM Application Discovery Configuration Service from
, go to the Dashboard tab, and verify whether
the status of Graph Database is in the Error state. If
the Graph Database is in the Error state, perform the
following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to Save. , re-enter the password for GraphDB Server's root user, and click
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect for Mainframe chapter from the Program
Directory for IBM Application Discovery Connect for Mainframe document. It
can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important:
- Starting with IBM ADDI V6.1.0.0, there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Before you upgrade IBM AD Analyze Client from
previous versions, configure the installed ADDI to invoke a garbage collection (GC) upon startup. To
complete this step, make sure that org.eclipse.equinox.p2.ui.sdk.scheduler
bundle is available. Locate and open both plugin_customization.ini files that
can be found in 2 different plugins folders under Eclipse installation folder, and add the following line.
org.eclipse.equinox.p2.ui.sdk.scheduler/gcOnStartup=true
Then, save the files and start the upgrade process. The remaining jar files that are unused or duplicated will be automatically removed.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading from IBM AD V6.1.1.0 by using IBM AD Upgrade Wizard
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same
IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Configuration Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application Discovery and Delivery Intelligence for IBM Z is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Notes:
- Depending on the machine performance, you might see that the Context root not found page in your browser. Wait for a minute and then refresh the page until you see the IBM AD Configuration Wizard showing in your browser.
- Depending on the machine performance, the browser might display a message indicating that it does not trust the website's certificate. This can also occur if the browser was opened during the installation of Application Discovery and did not have the opportunity to load the newly installed Application Discovery self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the URL of the IBM AD Configuration Wizard, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM AD Configuration Wizard page now is displayed without any warnings.
- Go through IBM AD Upgrade Wizard, continue with the rest of the steps, and click Done.
- Access IBM Application Discovery Configuration Service from
, go to the
Dashboard tab, and verify whether the status of Graph
Database is in the Error state. If the Graph
Database is in the Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration Service
Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important:
- Starting with IBM ADDI V6.1.0.0, there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Before you upgrade IBM AD Analyze Client from
previous versions, configure the installed ADDI to
invoke a garbage collection (GC) upon startup. To complete this step, make sure that
org.eclipse.equinox.p2.ui.sdk.scheduler bundle is available. Locate and open
both plugin_customization.ini files that can be found in 2 different
plugins folders under Eclipse
installation folder, and add the following line.
org.eclipse.equinox.p2.ui.sdk.scheduler/gcOnStartup=true
Then, save the files and start the upgrade process. The remaining jar files that are unused or duplicated will be automatically removed.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading from IBM AD V6.1.0.0 by using IBM AD Upgrade Wizard
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Configuration Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Notes:
- Depending on the machine performance, you might see that the Context root not found page in your browser. Wait for a minute and then refresh the page until you see the IBM AD Configuration Wizard showing in your browser.
- Depending on the machine performance, the browser might display a message indicating that it does not trust the website's certificate. This can also occur if the browser was opened during the installation of Application Discovery and did not have the opportunity to load the newly installed Application Discovery self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the URL of the IBM AD Configuration Wizard, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM AD Configuration Wizard page now is displayed without any warnings.
- Go through IBM AD Upgrade Wizard, continue with the rest of the steps, and click Done.
- Access IBM Application Discovery Configuration Service from
, go to the
Dashboard tab, and verify whether the status of Graph
Database is in the Error state. If the Graph
Database is in the Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration Service
Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important:
- Starting with IBM ADDI V6.1.0.0, there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Before you upgrade IBM AD Analyze Client from
previous versions, configure the installed ADDI to
invoke a garbage collection (GC) upon startup. To complete this step, make sure that
org.eclipse.equinox.p2.ui.sdk.scheduler bundle is available. Locate and open
both plugin_customization.ini files that can be found in 2 different
plugins folders under Eclipse installation folder, and add the following line.
org.eclipse.equinox.p2.ui.sdk.scheduler/gcOnStartup=true
Then, save the files and start the upgrade process. The remaining jar files that are unused or duplicated will be automatically removed.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading from IBM AD V6.0.2.0 by using IBM AD Upgrade Wizard
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same
IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Configuration Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Notes:
- Depending on the machine performance, you might see that the Context root not found page in your browser. Wait for a minute and then refresh the page until you see the IBM AD Configuration Wizard showing in your browser.
- Depending on the machine performance, the browser might display a message indicating that it does not trust the website's certificate. This can also occur if the browser was opened during the installation of Application Discovery and did not have the opportunity to load the newly installed Application Discovery self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the URL of the IBM AD Configuration Wizard, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM AD Configuration Wizard page now is displayed without any warnings.
- Go through IBM AD Upgrade Wizard, continue with the rest of the steps, and click Done.
- Access IBM Application Discovery Configuration Service from
, go to the
Dashboard tab, and verify whether the status of Graph
Database is in the Error state. If the Graph
Database is in the Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration Service
Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect for Mainframe chapter from the Program Directory for IBM Application Discovery Connect for Mainframe document. It can
be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important:
- Starting with IBM ADDI V6.1.0.0, there is no compatibility with previous versions of IBM AD Analyze ClientIBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Before you upgrade IBM AD Analyze Client from
previous versions, configure the installed ADDI to invoke a garbage collection (GC) upon startup. To
complete this step, make sure that org.eclipse.equinox.p2.ui.sdk.scheduler
bundle is available. Locate and open both plugin_customization.ini files that
can be found in 2 different plugins folders under Eclipse installation folder,
and add the following line.
org.eclipse.equinox.p2.ui.sdk.scheduler/gcOnStartup=true
Then, save the files and start the upgrade process. The remaining jar files that are unused or duplicated will be automatically removed.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Analyze Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading from IBM AD V6.0.1.0 by using IBM AD Upgrade Wizard
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Notes:
- Depending on the machine performance, you might see that the Context root not found page in your browser. Wait for a minute and then refresh the page until you see the IBM AD Configuration Wizard showing in your browser.
- Depending on the machine performance, the browser might display a message indicating that it does not trust the website's certificate. This can also occur if the browser was opened during the installation of Application Discovery and did not have the opportunity to load the newly installed Application Discovery self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the URL of the IBM AD Configuration Wizard, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM AD Configuration Wizard page now is displayed without any warnings.
- Go through IBM AD Upgrade Wizard, continue with the rest of the steps, and click Done.
- Access IBM Application Discovery Configuration Service from
, go to the Dashboard
tab, and verify whether the status of Graph Database is in the
Error state. If the Graph Database is in the
Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important:
- Starting with IBM ADDI V6.1.0.0, there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Before you upgrade IBM AD Analyze Client from
previous versions, configure the installed ADDI to
invoke a garbage collection (GC) upon startup. To complete this step, make sure that
org.eclipse.equinox.p2.ui.sdk.scheduler bundle is available. Locate and open
both plugin_customization.ini files that can be found in 2 different
plugins folders under Eclipse
installation folder, and add the following line.
org.eclipse.equinox.p2.ui.sdk.scheduler/gcOnStartup=true
Then, save the files and start the upgrade process. The remaining jar files that are unused or duplicated will be automatically removed.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading from IBM AD V6.0.0.0 by using IBM AD Upgrade Wizard
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Notes:
- Depending on the machine performance, you might see that the Context root not found page in your browser. Wait for a minute and then refresh the page until you see the IBM AD Configuration Wizard showing in your browser.
- Depending on the machine performance, the browser might display a message indicating that it does not trust the website's certificate. This can also occur if the browser was opened during the installation of Application Discovery and did not have the opportunity to load the newly installed Application Discovery self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the URL of the IBM AD Configuration Wizard, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM AD Configuration Wizard page now is displayed without any warnings.
- Go through IBM AD Upgrade Wizard, continue with the rest of the steps, and click Done.
- Access IBM Application Discovery
Configuration Service from Dashboard tab, and verify whether
the status of Graph Database is in the Error state. If
the Graph Database is in the Error state, perform the
following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to Save. , re-enter the password for GraphDB Server's root user, and click
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
, go to the - Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important:
- Starting with IBM ADDI V6.1.0.0, there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Before you upgrade IBM AD Analyze Client from
previous versions, configure the installed ADDI to
invoke a garbage collection (GC) upon startup. To complete this step, make sure that
org.eclipse.equinox.p2.ui.sdk.scheduler bundle is available. Locate and open
both plugin_customization.ini files that can be found in 2 different
plugins folders under Eclipse installation folder, and add the following line.
org.eclipse.equinox.p2.ui.sdk.scheduler/gcOnStartup=true
Then, save the files and start the upgrade process. The remaining jar files that are unused or duplicated will be automatically removed.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading from IBM AD V5.1.0.9 by using IBM AD Upgrade Wizard
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Notes:
- Depending on the machine performance, you might see that the Context root not found page in your browser. Wait for a minute and then refresh the page until you see the IBM AD Configuration Wizard showing in your browser.
- Depending on the machine performance, the browser might display a message indicating that it does not trust the website's certificate. This can also occur if the browser was opened during the installation of Application Discovery and did not have the opportunity to load the newly installed Application Discovery self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the URL of the IBM AD Configuration Wizard, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM AD Configuration Wizard page now is displayed without any warnings.
- Go through IBM AD Upgrade Wizard, continue with the rest of the steps, and click Done.
- Access IBM Application Discovery Configuration Service from
, go to the Dashboard
tab, and verify whether the status of Graph Database is in the
Error state. If the Graph Database is in the
Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important:
- Starting with IBM ADDI V6.1.0.0, there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Before you upgrade IBM AD Analyze Client from
previous versions, configure the installed ADDI to invoke a garbage collection (GC) upon startup. To
complete this step, make sure that org.eclipse.equinox.p2.ui.sdk.scheduler
bundle is available. Locate and open both plugin_customization.ini files that
can be found in 2 different plugins folders under Eclipse installation folder,
and add the following line.
org.eclipse.equinox.p2.ui.sdk.scheduler/gcOnStartup=true
Then, save the files and start the upgrade process. The remaining jar files that are unused or duplicated will be automatically removed.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading from IBM AD V5.1.0.8 by using IBM AD Upgrade Wizard
- With IBM AD 5.1.0.8 installed and
configured, and before you run the IBM ADDI
V6.1.3.0 installer, you need to stop IBM
Application Discovery Graph Service as follows:
- On Windows, go to \IBM Application Discovery
Batch Server\orientdb\orientdb-community\bin and execute the
shutdown.bat -p <YourOrientDBPassword>
command to stop IBM Application Discovery Graph Service.
- On Windows, go to \IBM Application Discovery
Batch Server\orientdb\orientdb-community\bin and execute the
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Notes:
- Depending on the machine performance, you might see that the Context root not found page in your browser. Wait for a minute and then refresh the page until you see the IBM AD Configuration Wizard showing in your browser.
- Depending on the machine performance, the browser might display a message indicating that it does not trust the website's certificate. This can also occur if the browser was opened during the installation of Application Discovery and did not have the opportunity to load the newly installed Application Discovery self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the URL of the IBM AD Configuration Wizard, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM AD Configuration Wizard page now is displayed without any warnings.
- Go through IBM AD Upgrade Wizard, continue with the rest of the steps, and click Done.
- Access IBM Application Discovery Configuration Service from
, go to the Dashboard
tab, and verify whether the status of Graph Database is in the
Error state. If the Graph Database is in the
Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important:
- Starting with IBM ADDI V6.1.0.0, there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Before you upgrade IBM AD Analyze Client from
previous versions, configure the installed ADDI to invoke a garbage collection (GC) upon startup. To
complete this step, make sure that org.eclipse.equinox.p2.ui.sdk.scheduler
bundle is available. Locate and open both plugin_customization.ini files that
can be found in 2 different plugins folders under Eclipse installation folder,
and add the following line.
org.eclipse.equinox.p2.ui.sdk.scheduler/gcOnStartup=true
Then, save the files and start the upgrade process. The remaining jar files that are unused or duplicated will be automatically removed.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading from IBM AD V5.1.0.7 by using IBM AD Upgrade Wizard
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Notes:
- Depending on the machine performance, you might see that the Context root not found page in your browser. Wait for a minute and then refresh the page until you see the IBM AD Configuration Wizard showing in your browser.
- Depending on the machine performance, the browser might display a message indicating that it does not trust the website's certificate. This can also occur if the browser was opened during the installation of Application Discovery and did not have the opportunity to load the newly installed Application Discovery self-signed certificate. To resolve this issue, restart the browser to reload its trusted certificates store. Copy the URL of the IBM AD Configuration Wizard, close the browser, and reopen it. Then, paste and go to the copied URL. The IBM AD Configuration Wizard page now is displayed without any warnings.
- Go through IBM AD Upgrade Wizard, continue with the rest of the steps, and click Done.
- Access IBM Application Discovery Configuration Service from
, go to the Dashboard
tab, and verify whether the status of Graph Database is in the
Error state. If the Graph Database is in the
Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important:
- Starting with IBM ADDI V6.1.0.0, there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Before you upgrade IBM AD Analyze Client from
previous versions, configure the installed ADDI to
invoke a garbage collection (GC) upon startup. To complete this step, make sure that
org.eclipse.equinox.p2.ui.sdk.scheduler bundle is available. Locate and open
both plugin_customization.ini files that can be found in 2 different
plugins folders under Eclipse installation folder, and add the following line.
org.eclipse.equinox.p2.ui.sdk.scheduler/gcOnStartup=true
Then, save the files and start the upgrade process. The remaining jar files that are unused or duplicated will be automatically removed.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading manually from IBM AD V5.1.0.6
Steps to be performed when you upgrade IBM AD V5.1.0.6 to IBM AD V6.1.3.0.
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Important: In case the IBM AD Configuration Wizard shows instead of the IBM AD Upgrade Wizard, go to the browser URL address and manually change it from /ad/admin/setup to /ad/admin/setup/upgrade and then press Enter. The IBM AD Upgrade Wizard should now load.Important: Do not run through IBM AD Upgrade Wizard at this point. There are manual steps that need to be performed before running through the IBM AD Upgrade Wizard steps.
- Access IBM Application Discovery Configuration Service from
and perform the following actions:Important: An error message
IAYAD0065E Server connection error.
may appear once the IBM Application Discovery Configuration Service Admin opens. Close the message and continue with the steps.- Go to Important:
- By default, the Audit database name EZ#AUDIT (for SQL Server) is displayed. If Audit Service was previously configured, enter Audit Database name that is present in the backed-up server.xml file. If Audit Service wasn't previously configured, you can use the default name.
- If IBM AD Cross Applications Service wasn’t configured in the previously installed version then an error message could appear after clicking the Save button. Close it and continue with the steps.
. Click on your "target environment" name, go to
, and update the database names, especially for Audit
Database, and click Save. After the save action finishes, do not restart any
services as suggested on the page. - Go to the Configure tab, click the edit button of the target environment, change the
status from Inactive to Active, and click Save. Note: Wait until the process is finished. This process can take a few minutes to complete.
- Go to Modify the General and Port Settings. . Click on your target environment and make sure that all port numbers are available in the Ports area. If a port number is missing, you can enter it manually. For more information, see
- Go to
- Go back to the browser tab where the IBM AD Upgrade Wizard was
opened. Go through IBM AD Upgrade Wizard steps. Continue with the
rest of the steps, and click Done.Important: There is a chance that Graph Database Server might report an error. If that happens, then continue with the steps.
- Reboot the workstation.
- Access IBM Application Discovery Configuration Service from
, go to the Dashboard
tab, and verify whether the status of Graph Database is in the
Error state. If the Graph Database is in the
Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important: Starting with IBM ADDI V6.1.0.0 there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading manually from IBM AD V5.1.0.5
Steps to be performed when you upgrade IBM AD V5.1.0.5 to IBM AD V6.1.3.0.
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Important: In case the IBM AD Configuration Wizard shows instead of the IBM AD Upgrade Wizard, go to the browser URL address and manually change it from /ad/admin/setup to /ad/admin/setup/upgrade and then press Enter. The IBM AD Upgrade Wizard should now load.Important: Do not run through IBM AD Upgrade Wizard at this point. There are manual steps that need to be performed before running through the IBM AD Upgrade Wizard steps.
- Access IBM Application Discovery Configuration Service from
and perform the following actions:Important: An error message
IAYAD0065E Server connection error.
may appear once the IBM Application Discovery Configuration Service Admin opens. Close the message and continue with the steps.- Go to Important:
- By default, the Audit database name EZ#AUDIT (for SQL server) is displayed. If Audit Service was previously configured, enter Audit Database name that is present in the backed-up server.xml file. If Audit Service wasn't previously configured, you can use the default name.
- If IBM AD Cross Applications Service wasn’t configured in the previously installed version then an error message could appear after clicking the Save button. Close it and continue with the steps.
. Click on your "target environment" name, go to
, and update the database names, especially for Audit
Database, and click Save. After the save action finishes, do not restart any
services as suggested on the page. - Go to the Configure tab, click the edit button of the target environment, change the
status from Inactive to Active, and click Save. Note: Wait until the process is finished. This process can take a few minutes to complete.
- Go to Modify the General and Port Settings. . Click on your target environment and make sure that all port numbers are available in the Ports area. If a port number is missing, you can enter it manually. For more information, see
- Go to
- Go back to the browser tab where the IBM AD Upgrade Wizard was
opened. Go through IBM AD Upgrade Wizard steps. Continue with the
rest of the steps, and click Done.Important: There is a chance that Graph Database Server might report an error. If that happens, then continue with the steps.
- Reboot the workstation.
- Access IBM Application Discovery Configuration Service from
, go to the Dashboard
tab, and verify whether the status of Graph Database is in the
Error state. If the Graph Database is in the
Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the s document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important: Starting with IBM ADDI V6.1.0.0 there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading manually from IBM AD V5.1.0.4
Steps to be performed when you upgrade IBM AD V5.1.0.4 to IBM AD V6.1.3.0.
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Important: In case the IBM AD Configuration Wizard shows instead of the IBM AD Upgrade Wizard, go to the browser URL address and manually change it from /ad/admin/setup to /ad/admin/setup/upgrade and then press Enter. The IBM AD Upgrade Wizard should now load.Important: Do not run through IBM AD Upgrade Wizard at this point. There are manual steps that need to be performed before running through the IBM AD Upgrade Wizard steps.
- Make sure to manually delete the cross databases that were used by IBM AD Cross Applications Service in IBM AD V5.1.0.4 from Microsoft SQL Server.
- Access IBM Application Discovery Configuration Service from
and perform the following actions:Important: An error message
IAYAD0065E Server connection error.
may appear once the IBM Application Discovery Configuration Service Admin opens. Close the message and continue with the steps.- Go to Important:
- By default, the Audit database name EZ#AUDIT (for SQL Server) is displayed. If Audit Service was previously configured, enter Audit Database name that is present in the backed-up server.xml file. If Audit Service wasn't previously configured, you can use the default name.
- If IBM AD Cross Applications Service wasn’t configured in the previously installed version then an error message could appear after clicking the Save button. Close it and continue with the steps.
. Click on your "target environment" name, go to
, and update the database names, especially for Audit
Database, and click Save. After the save action finishes, do not restart any
services as suggested on the page. - Go to the Configure tab, click the edit button of the target environment, change the
status from Inactive to Active, and click Save. Note: Wait until the process is finished. This process can take a few minutes to complete.
- Go to Modify the General and Port Settings. . Click on your target environment and make sure that all port numbers are available in the Ports area. If a port number is missing, you can enter it manually. For more information, see
- Go to
- Go back to the browser tab where the IBM AD Upgrade Wizard was
opened. Go through IBM AD Upgrade Wizard steps. Continue with the
rest of the steps, and click Done.Important: There is a chance that Graph Database Server might report an error. If that happens, then continue with the steps.
- Reboot the workstation.
- Access IBM Application Discovery Configuration Service from
, go to the Dashboard
tab, and verify whether the status of Graph Database is in the
Error state. If the Graph Database is in the
Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important: Starting with IBM ADDI V6.1.0.0 there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading manually from IBM AD V5.1.0.3
Steps to be performed when you upgrade IBM AD V5.1.0.3 to IBM AD V6.1.3.0.
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Important: In case the IBM AD Configuration Wizard shows instead of the IBM AD Upgrade Wizard, go to the browser URL address and manually change it from /ad/admin/setup to /ad/admin/setup/upgrade and then press Enter. The IBM AD Upgrade Wizard should now load.Important: Do not run through IBM AD Upgrade Wizard at this point. There are manual steps that need to be performed before running through the IBM AD Upgrade Wizard steps.
- Configure IBM AD Mainframe Projects
Service and IBM AD Cross Applications
Service as follows:
- IBM AD Mainframe Projects Service - is a mandatory service that needs to be configured to authorize the access to the AD projects. The list of projects is not cached at the restart of the IBM AD Analyze Client and it is necessary to use the Get project list contextual-menu option each time when IBM AD Analyze Client starts. For more information on how to configure IBM AD Mainframe Projects Service, see STEP 7. Configuring IBM AD Mainframe Projects Service.
- IBM AD Cross Applications Service - is an additional service that needs to be configured to show calls between different mainframe projects that have their databases on the same DB instance in IBM AD Analyze Client. For more information on how to configure IBM AD Cross Applications Service, see STEP 10. Configuring IBM AD Cross Application Service.
- Access IBM Application Discovery Configuration Service from
and perform the following actions:Important: An error message
IAYAD0065E Server connection error.
may appear once the IBM Application Discovery Configuration Service Admin opens. Close the message and continue with the steps.- Go to Important:
- By default, the Audit database name EZ#AUDIT (for SQL Server) is displayed. If Audit Service was previously configured, enter Audit Database name that is present in the backed-up server.xml file. If Audit Service wasn't previously configured, you can use the default name.
- If IBM AD Cross Applications Service wasn’t configured in the previously installed version then an error message could appear after clicking the Save button. Close it and continue with the steps.
. Click on your "target environment" name, go to
, and update the database names, especially for Audit
Database, and click Save. After the save action finishes, do not restart any
services as suggested on the page. - Go to the Configure tab, click the edit button of the target environment, change the
status from Inactive to Active, and click Save. Note: Wait until the process is finished. This process can take a few minutes to complete.
- Go to Modify the General and Port Settings. . Click on your target environment and make sure that all port numbers are available in the Ports area. If a port number is missing, you can enter it manually. For more information, see
- Go to
- Go back to the browser tab where the IBM AD Upgrade Wizard was
opened. Go through IBM AD Upgrade Wizard steps. Continue with the
rest of the steps, and click Done.Important: There is a chance that Graph Database Server might report an error. If that happens, then continue with the steps.
- Reboot the workstation.
- Access IBM Application Discovery Configuration Service from
, go to the Dashboard
tab, and verify whether the status of Graph Database is in the
Error state. If the Graph Database is in the
Error state, perform the following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important: Starting with IBM ADDI V6.1.0.0 there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading manually from IBM AD V5.1.0.2
Steps to be performed when you upgrade IBM AD V5.1.0.2 to IBM AD V6.1.3.0.
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Important: In case the IBM AD Configuration Wizard shows instead of the IBM AD Upgrade Wizard, go to the browser URL address and manually change it from /ad/admin/setup to /ad/admin/setup/upgrade and then press Enter. The IBM AD Upgrade Wizard should now load.Important: Do not run through IBM AD Upgrade Wizard at this point. There are manual steps that need to be performed before running through the IBM AD Upgrade Wizard steps.
- Make sure to configure the following services:
- IBM AD File Service
Prior to IBM AD V5.1.0.3, the sources and the project folders need to be shared.
Starting with IBM AD V5.1.0.3, IBM AD File Service was introduced and in the context of the authorization/authentication, the access rights of users or users' groups are mapped to a certain folder with the source files that are on the same machine with IBM AD File Service or not. Once authenticated and authorized, the user can start the analysis on the source files as long as the user has read access rights.
If you still want to use the existing projects, you need to add the path to the shared sources folders that were used during the project creation, when configuring IBM AD File Service. In this way, you are still able to access the sources from another machine. This path needs to be added in the conf.yaml file, in the mapping section, where the remote parameter is present.
Note: If the authorization/authentication feature is not used, for the new projects you need to have a shared folder to access those files from another machine. If the authorization/authentication feature is used, for the new projects it is not necessary to have a shared folder. For more information on how to configure IBM AD File Service, see STEP 5. Configuring IBM AD File Service. - IBM AD Search Service
Prior to IBM AD V5.1.0.3, IBM AD Batch Server was generating, through the index component, the indexed data for the resources of a project into a path set in the project.properties file. In IBM AD Analyze Client a search in resources was directly performed by using Search in Files analysis.
Starting with IBM AD V5.1.0.3, IBM AD Search Service is responsible with the access to the indexed data. Whether the authorization/authentication feature is used or not, the folder path in which the indexes are generated needs to be accessible both for IBM AD Batch Server and IBM AD Search Service. The path where the index data is generated needs to be added in the conf.yaml file, where the indexPath parameter is present. This path can be found under <IBM ADDI Installation Folder>\IBM Application Discovery Batch Server\conf\project.properties, where the index.indexFolder parameter is present.
The path to the source folders that are added to the project or any additional folder that needs to be indexed (apart from the project folders), needs to be added in the conf.yaml file of IBM AD File Service, where the mapping section is present. The path to the additional folder can be found under <IBM ADDI Installation Folder>\IBM Application Discovery Batch Server\conf\project.properties, where the index.extraSources parameter is present.Note: Make sure that IBM AD Search Service and IBM AD File Service are started as Search in Files analysis depends on them. If the authorization/authentication feature is used, the user that is logged in IBM AD Analyze Client needs to have read access rights to see the content of the files where the search pattern appears. For more information on how to configure IBM AD Search Service, see STEP 8. Configuring IBM AD Search Service. - IBM AD Manual Resolutions
Service
Prior IBM AD V5.1.0.3, the dynamic call resolutions were stored and managed by using files located in the .resolutions folder under each project's path.
Starting with IBM AD V5.1.0.3, IBM AD Manual Resolutions Service manages these files, so the path where these files are generated is separated from project's path and needs to be accessible only for IBM AD Manual Resolutions Service. This path where the journal files are generated needs to be added in the conf.yaml file, where the projectPath parameter is present. Once a project is imported, a folder with the same name is generated in that path and hosts all the files that are needed to manage dynamic call resolutions. For more information on how to configure IBM AD Manual Resolutions Service, see STEP 6. Configuring IBM AD Manual Resolution Service.Note: Make sure that IBM AD Manual Resolutions Service is started as the import process depends on it.To preserve the journal files that were used in the previous versions, the moveResolutions.ps1 script allows you to automatically move the journal files from a previous location to a new destination, where for each project, a folder that contains the journal files is created.
To run the moveResolutions.ps1 script, perform the following steps:- Go to the <IBM ADDI Installation Folder>\IBM Application Discovery Manual Resolutions Service folder and locate the moveResolutions.ps1 script.
- Run the moveResolutions.ps1 script by using Windows PowerShell.
- Set the source parameter, which represents the path where the IBM AD Build Client projects were created. The default path is found in IBM AD Configuration Server at the following location: .
- Set the destination parameter, which represents the path for the files that are moved on.
- As a result, all the journal files are moved in the newly set location.
- IBM AD Mainframe Projects Service - is a mandatory service that needs to be configured to authorize the access to the AD projects. The list of projects is not cached at the restart of the IBM AD Analyze Client and it is necessary to use the Get project list contextual-menu option each time when IBM AD Analyze Client starts. For more information on how to configure IBM AD Mainframe Projects Service, see STEP 7. Configuring IBM AD Mainframe Projects Service.
- IBM AD Cross Applications Service - is an additional service that needs to be configured to show calls between different mainframe projects that have their databases on the same DB instance. For more information on how to configure IBM AD Cross Applications Service, see STEP 10. Configuring IBM AD Cross Application Service.
- IBM AD File Service
- Access IBM Application Discovery Configuration Service from
and perform the following actions:Important: An error message
IAYAD0065E Server connection error.
may appear once the IBM Application Discovery Configuration Service Admin opens. Close the message and continue with the steps.- Go to Important:
- By default, the Audit database name EZ#AUDIT (for SQL Server) is displayed. If Audit Service was previously configured, enter Audit Database name that is present in the backed-up server.xml file. If Audit Service wasn't previously configured, you can use the default name.
- If IBM AD Cross Applications Service wasn’t configured in the previously installed version then an error message could appear after clicking the Save button. Close it and continue with the steps.
. Click on your "target environment" name, go to
, and update the database names, especially for Audit
Database, and click Save. After the save action finishes, do not restart any
services as suggested on the page. - Go to the Configure tab, click the edit button of the target environment, change the
status from Inactive to Active, and click Save. Note: Wait until the process is finished. This process can take a few minutes to complete.
- Go to Modify the General and Port Settings. . Click on your target environment and make sure that all port numbers are available in the Ports area. If a port number is missing, you can enter it manually. For more information, see
- Go to
- Go back to the browser tab where the IBM AD Upgrade Wizard was
opened. Go through IBM AD Upgrade Wizard steps. Continue with the
rest of the steps, and click Done.Important: There is a chance that Graph Database Server might report an error. If that happens, then continue with the steps.
- Reboot the workstation.
- Access IBM Application Discovery
Configuration Service from Dashboard tab, and verify whether
the status of Graph Database is in the Error state. If
the Graph Database is in the Error state, perform the
following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to GraphDB Server's root user, and click Save. , re-enter the password for
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
, go to the - Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important: Starting with IBM ADDI V6.1.0.0 there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.
Upgrading manually from IBM AD V5.1.0.0
Steps to be performed when you upgrade IBM AD V5.1.0.0 to IBM AD V6.1.3.0.
- Run the IBM ADDI V6.1.3.0 installer without
uninstalling AD components and make sure that the same IBM AD installation path is used.Important: On the IBM Application Discovery Upgrade Wizard page, ensure that the Open IBM Application Discovery Upgrade Wizard checkbox is selected. The IBM AD Upgrade Wizard will open in the system's default browser after the upgrade is completed.
- Once the installation process of IBM Application
Discovery and Delivery Intelligence is
completed, it will open IBM AD Upgrade Wizard in a new tab of
the default browser.Important: In case the IBM AD Configuration Wizard shows instead of the IBM AD Upgrade Wizard, go to the browser URL address and manually change it from /ad/admin/setup to /ad/admin/setup/upgrade and then press Enter. The IBM AD Upgrade Wizard should now load.Important: Do not run through IBM AD Upgrade Wizard at this point. There are manual steps that need to be performed before running through the IBM AD Upgrade Wizard steps.
- Make sure to configure the following services:
- IBM AD File Service
Prior to IBM AD V5.1.0.3, the sources and the project folders need to be shared.
Starting with IBM AD V5.1.0.3, IBM AD File Service was introduced and in the context of the authorization/authentication, the access rights of users or users' groups are mapped to a certain folder with the source files that are on the same machine with IBM AD File Service or not. Once authenticated and authorized, the user can start the analysis on the source files as long as the user has read access rights.
If you still want to use the existing projects, you need to add the path to the shared sources folders that were used during the project creation, when configuring IBM AD File Service. In this way, you are still able to access the sources from another machine. This path needs to be added in the conf.yaml file, in the mapping section, where the remote parameter is present.
Note: If the authorization/authentication feature is not used, for the new projects you need to have a shared folder to access those files from another machine. If the authorization/authentication feature is used, for the new projects it is not necessary to have a shared folder. For more information on how to configure IBM AD File Service, see STEP 5. Configuring IBM AD File Service. - IBM AD Search Service
Prior to IBM AD V5.1.0.3, IBM AD Batch Server was generating, through the index component, the indexed data for the resources of a project into a path set in the project.properties file. In IBM AD Analyze Client a search in resources was directly performed by using Search in Files analysis.
Starting with IBM AD V5.1.0.3, IBM AD Search Service is responsible with the access to the indexed data. Whether the authorization/authentication feature is used or not, the folder path in which the indexes are generated needs to be accessible both for IBM AD Batch Server and IBM AD Search Service. The path where the index data is generated needs to be added in the conf.yaml file, where the indexPath parameter is present. This path can be found under <IBM ADDI Installation Folder>\IBM Application Discovery Batch Server\conf\project.properties, where the index.indexFolder parameter is present.
The path to the source folders that are added to the project or any additional folder that needs to be indexed (apart from the project folders), needs to be added in the conf.yaml file of IBM AD File Service, where the mapping section is present. The path to the additional folder can be found under <IBM ADDI Installation Folder>\IBM Application Discovery Batch Server\conf\project.properties, where the index.extraSources parameter is present.Note: Make sure that IBM AD Search Service and IBM AD File Service are started as Search in Files analysis depends on them. If the authorization/authentication feature is used, the user that is logged in IBM AD Analyze Client needs to have read access rights to see the content of the files where the search pattern appears. For more information on how to configure IBM AD Search Service, see STEP 8. Configuring IBM AD Search Service. - IBM AD Manual Resolutions
Service
Prior IBM AD V5.1.0.3, the dynamic call resolutions were stored and managed by using files located in the .resolutions folder under each project's path.
Starting with IBM AD V5.1.0.3, IBM AD Manual Resolutions Service manages these files, so the path where these files are generated is separated from project's path and needs to be accessible only for IBM AD Manual Resolutions Service. This path where the journal files are generated needs to be added in the conf.yaml file, where the projectPath parameter is present. Once a project is imported, a folder with the same name is generated in that path and hosts all the files that are needed to manage dynamic call resolutions. For more information on how to configure IBM AD Manual Resolutions Service, see STEP 6. Configuring IBM AD Manual Resolution Service.Note: Make sure that IBM AD Manual Resolutions Service is started as the import process depends on it.To preserve the journal files that were used in the previous versions, the moveResolutions.ps1 script allows you to automatically move the journal files from a previous location to a new destination, where for each project, a folder that contains the journal files is created.
To run the moveResolutions.ps1 script, perform the following steps:- Go to the <IBM ADDI Installation Folder>\IBM Application Discovery Manual Resolutions Service folder and locate the moveResolutions.ps1 script.
- Run the moveResolutions.ps1 script by using Windows PowerShell.
- Set the source parameter, which represents the path where the IBM AD Build Client projects were created. The default path is found in IBM AD Configuration Server at the following location: .
- Set the destination parameter, which represents the path for the files that are moved on.
- As a result, all the journal files are moved in the newly set location.
- IBM AD Mainframe Projects Service - is a mandatory service that needs to be configured to authorize the access to the AD projects. The list of projects is not cached at the restart of the IBM AD Analyze Client and it is necessary to use the Get project list contextual-menu option each time when IBM AD Analyze Client starts. For more information on how to configure IBM AD Mainframe Projects Service, see STEP 7. Configuring IBM AD Mainframe Projects Service.
- IBM AD Cross Applications Service - is an additional service that needs to be configured to show calls between different mainframe projects that have their databases on the same DB instance. For more information on how to configure IBM AD Cross Applications Service, see STEP 10. Configuring IBM AD Cross Application Service.
- IBM AD File Service
- Access IBM Application Discovery
Configuration Service from Important: An error message
IAYAD0065E Server connection error.
may appear once the IBM Application Discovery Configuration Service Admin opens. Close the message and continue with the steps.- Go to Important:
- By default, the Audit database name EZ#AUDIT (for SQL server) is displayed. If Audit Service was previously configured, enter Audit Database name that is present in the backed-up server.xml file. If Audit Service wasn't previously configured, you can use the default name.
- If IBM AD Cross Applications Service wasn’t configured in the previously installed version then an error message could appear after clicking the Save button. Close it and continue with the steps.
. Click on your "target environment" name, go to
, and update the database names, especially for Audit
Database, and click Save. After the save action finishes, do not restart any
services as suggested on the page. - Go to the Configure tab, click the edit button of the target environment, change the
status from Inactive to Active, and click Save. Note: Wait until the process is finished. This process can take a few minutes to complete.
- Go to Modify the General and Port Settings. . Click on your target environment and make sure that all port numbers are available in the Ports area. If a port number is missing, you can enter it manually. For more information, see
and perform the following actions: - Go to
- Go back to the browser tab where the IBM AD Upgrade Wizard was
opened. Go through IBM AD Upgrade Wizard steps. Continue with the
rest of the steps, and click Done.Important: There is a chance that Graph Database Server might report an error. If that happens, then continue with the steps.
- Reboot the workstation.
- Access IBM Application Discovery
Configuration Service from Dashboard tab, and verify whether
the status of Graph Database is in the Error state. If
the Graph Database is in the Error state, perform the
following steps:
- Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window. Note: Make sure that you have the appropriate administrative rights to open Task Manager.
- Select the Details tab and make sure that the Command line column is present. If the Command line column is not present, right-click on the Name column, choose Select Columns, tick the Command line box, and click Ok.
- Search for the java.exe processes, where in Command line can be identified the line that contains the -XX:+HeapDumpOnOutOfMemoryError parameter. Right-click on the related java.exe process and select End process tree.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and refresh the page.
- Make sure that Graph Database is in the Offline state.
- Go to Save. , re-enter the password for GraphDB Server's root user, and click
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Graph Database.
, go to the - Press Ctrl + Alt + Del and choose Task Manager to open the Task
Manager window.
- Go to the Dashboard tab in IBM Application Discovery Configuration Service Admin and restart Mainframe projects service.
- Go to IBM Application Discovery Configuration
Service Admin and perform the following steps:
- Make sure that all database names are present in their related fields, if not enter the related database name.
- Even if the Audit database and Cross analysis database database names are present in their related fields, re-enter the database names, click Save, and confirm the changes by clicking Ok.
- Restart IBM Application Discovery WebSphere Liberty Profile Service. The service can be started from Windows Services (services.msc) by locating IBM Application Discovery WebSphere Liberty Profile Service and by clicking Restart.
- Go to the Dashboard tab and restart Cross applications service.
in - To install the latest version of IBM AD Connect for
Mainframe,
follow the instructions in the Installing IBM Application Discovery Connect
Mainframe chapter from the Program Directory for IBM Application
Discovery Connect for Mainframe document. It can be downloaded from the IBM Application Discovery and
Delivery Intelligence for IBM Z Library page.
Note: The Program Directory for IBM Application Discovery Connect for Mainframe document it is also provided in .PDF format and it is included in the zipped installation package.
- Upgrade IBM AD Analyze Client that is
currently installed into an Eclipse package or IBM
IDz to the latest level as follows:Important: Starting with IBM ADDI V6.1.0.0 there is no compatibility with previous versions of IBM AD Analyze Client. It is necessary to install or update to the latest version of IBM AD Analyze Client. The latest version of IBM AD Analyze Client is delivered through the IBM ADDI V6.1.3.0 base-level package.
- Install the latest version of IBM AD Analyze Client. For more information, see Installing IBM AD Analyze Client.
- Configure IBM AD Analyze Client. For more information, see Configuring IBM AD Analyze Client.
- Open IBM AD Analyze Client.
- Access IBM Application Discovery Configuration Service from .
- Go to IBM Application Discovery Configuration Service Admin. In the Annotations database, even if the Annotations database name is present in the related field, re-enter the Annotations database name, click Save, and confirm the changes by clicking Ok. in
- Restart IBM AD Analyze Client.
- Mandatory: upgrade the repository for each project by using either IBM AD Build Client or IBM AD Build Configuration.
- Mandatory: perform a full Build of each IBM AD project.
- Highly recommended: migrate from a self-signed certificate to a single signed certificate for secure connection.
Instructions for upgrading the repository can be found at Upgrade a Repository.
Instructions for performing a full Build of the project can be found at Building Projects.
Instructions for migrate from a self-signed certificate to a single signed certificate can be found at Migrating from a self-signed certificate to a single signed chain certificate.