Netcool/Web GUI OMNIbus Web GUI 8.1 Selective (Export/Import) Version 2016.11.29.01 Stanford Madriaga IBM Netcool Support

COPYING DATA BETWEEN Web GUI SERVERS USAGE: To make partial (selective export/import) or full copy (cloning) of Web GUI data to another Web GUI with the same version. DOC http://www.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNIbus.doc_8.1.0/webtop/wip/task/web_adm_exportimport.html REQUIREMENTS

• Same Web GUI version, Same TIP/DASH TYPES:

• Export/Import (i.e. Selective) – pick the components

Dependencies are included i.e. Specified Map will include used Filters, Dependent Filters, Views

• Cloning – copy everything

Everything = Filters, Maps, Menus, Prompts, Relationships, Tools, Views, files/dir Does not include ncwDataSourceDefinitions.xml, datasources file

OTHER TYPES:

• Manually omnibus_webgui/etc server.init > timedtasks.enabled:true OR restart watch out for server.init, ncwDataSourceDefinitions.xml, waapi.init

• High Availability/Load Balancing (HA/LB)

1st good node > config to DB > config will get propagated

• Migration

i.e Web GUI v7.4 to v8.1

GENERAL PROCESS (Export/Import, Cloning, Web GUI 8.1)

• Define data to export using properties file • Run export • Copy data.zip to target • Run Import • Restart

EXPORT/IMPORT (SELECTIVE)

• Put to debug

JazzSM_HOME/ui/etc/logging.properties (default: JazzSM_HOME = /opt/IBM/JazzSM)

https://www.ibm.com/support/knowledgecenter/SSSHTQ_8.1.0/com.ibm.netcool_OMNI

bus.doc_8.1.0/webtop/wip/task/web_adm_expimploglevel.html

• Define data

WEBGUI_HOME/integration/importexport_tool/etc/OMNIbusWebGUI_settings.properties (default: WEBGUI_HOME = /opt/netcool/IBM/netcool/omnibus_webgui)

• Export

./consolecli.sh Export --username smadmin --password password --excludePlugins ExportPagePlugin,ChartExportPlugin --settingFile WEBGUI_HOME/integration/importexport_tool/etc/OMNIbusWebGUI_settings.properties

List of Plugins (sample):

Result of Export:

ZipUtil v1.6

o Use to unzip data to make changes and zip files/dir back to data.zip o Obtain from IBM Support (file ziputil_1.6.zip) o Set JAVA_HOME=WAS_HOME/AppServer/java_1.7_64

Steps: o Unzip data.zip

o Make changes Search and Replace find . -type f -print0 | xargs -0 sed -i 's/ORIG/DESIRED/g'

o Zip to data.zip

• Copy data.zip to target (JazzSM_HOME/ui/input)

• Import

Adjust OMNIbusWebGUI_settings.properties

./consolecli.sh Import --username smadmin --password password --excludePlugins ImportPagePlugin,ChartImportPlugin --settingFile WEBGUI_HOME/integration/importexport_tool/etc/OMNIbusWebGUI_settings.properties Error!

Try: Tip: Exclude problematic plugins ./consolecli.sh Import --username smadmin --password password --excludePlugins ImportPagePlugin,ChartImportPlugin,CmsImportPlugin --settingFile WEBGUI_HOME/integration/importexport_tool/etc/OMNIbusWebGUI_settings.properties

• Restart

TROUBLESHOOTING

- No Web GUI data after Import

o Restart Web GUI after Import o Check directories after restart. If still no files from target, check data.zip

- No Web GUI in data.zip

o Check product.home variable. o Check defined selections. (No spaces after variable values)

- Plugin Issues

o Exclude problematic Plugins (Use ListExportPlugins, ListImportPlugins)

- Output / Input dir

o Remove old files. Only have data.zip

KNOWN ISSUES

- IV90146: DEPENDENT FILTERS ARE NOT PERSISTED TO FILTER.XML

Export reads filter.xml. If the association to dependent filters are not written into filter.xml, then they will be missing in data.zip. Workaround: Stop and restart the source Web GUI server.

MustGather

Source Server - Versions (imcl listInstalledPackages -features –long and from GUI) - consolecli.sh ListExportPlugins - Command used and console ouput - consolecli.log - omnibus_webgui/etc - data.zip Target Server - Versions (imcl listInstalledPackages -features –long and from GUI) - consolecli.sh ListImportPlugins - Command used and console ouput - consolecli.log - omnibus_webgui/etc - JazzSM/profile/logs/

ENHANCEMENT REQUESTS https://www.ibm.com/developerworks/rfe/