{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Perform the following steps to deploy DPOD on a pre-installed RHEL/Rocky Linux operating system.","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Prerequisites","type":"text"}]},{"type":"paragraph","content":[{"text":"Make sure to follow the ","type":"text"},{"text":"Operating System Requirements for Non-Appliance Mode","type":"text","marks":[{"type":"link","attrs":{"href":"https://montier.atlassian.net/wiki/spaces/DPOD010023x/pages/16440887137"}}]},{"text":".","type":"text"}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Obtain the Software and the Activation Key","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the CEF file from Passport Advantage (file name is ","type":"text"},{"text":"DPOD_NonAppliance_.cef","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Download the activation key file from Passport Advantage (file name is ","type":"text"},{"text":"DPOD-full-version-activation-key-.zip","type":"text","marks":[{"type":"code"}]},{"text":" or ","type":"text"},{"text":"DPOD-api-calls-activation-key-.zip","type":"text","marks":[{"type":"code"}]},{"text":"):","type":"text"}]},{"type":"orderedList","attrs":{"order":1},"content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The activation key is included in the download assembly for the program you purchased. In Passport Advantage, ","type":"text"},{"text":"make sure to select version “1.0.x”","type":"text","marks":[{"type":"strong"}]},{"text":" (and not the specific DPOD version).","type":"text"},{"type":"hardBreak"},{"text":"For the ","type":"text"},{"text":"full version","type":"text","marks":[{"type":"strong"}]},{"text":", please apply the activation key found in eAssembly \"","type":"text"},{"text":"IBM DataPower Operations Dashboard V1.0.x Full Version Activation eAssembly","type":"text","marks":[{"type":"strong"}]},{"text":"\" (G071VEN/M088JEN).","type":"text"},{"type":"hardBreak"},{"text":"For the ","type":"text"},{"text":"API calls version","type":"text","marks":[{"type":"strong"}]},{"text":", please apply the activation key found in eAssembly \"","type":"text"},{"text":"IBM DataPower Operations Dashboard V1.0.x API Calls Version Activation eAssembly","type":"text","marks":[{"type":"strong"}]},{"text":"\" (G071TEN/M088HEN).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The activation key file is a password-protected zip file. ","type":"text"},{"text":"Do not try to unzip the activation key zip file.","type":"text","marks":[{"type":"strong"}]}]}]}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Execute the CEF File","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The installation is packaged as a CEF (Compressed Executable Format) file.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The CEF file may be executed from any directory that meets the following requirements (e.g.: ","type":"text"},{"text":"/installs","type":"text","marks":[{"type":"code"}]},{"text":"):","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The directory has at least 1GB of free space ","type":"text"},{"text":"after","type":"text","marks":[{"type":"underline"}]},{"text":" the CEF file is copied into it.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The directory is NOT mounted with ","type":"text"},{"text":"noexec","type":"text","marks":[{"type":"code"}]},{"text":" flag (e.g.: in ","type":"text"},{"text":"/etc/fstab","type":"text","marks":[{"type":"code"}]},{"text":").","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"The directory is NOT one of the following: ","type":"text"},{"text":"/app","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"/logs","type":"text","marks":[{"type":"code"}]},{"text":", ","type":"text"},{"text":"/data","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Copy the CEF file into the chosen directory.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Execute the following commands:","type":"text"}]},{"type":"codeBlock","content":[{"text":"cd \nsudo chmod 755 \nsudo ./","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"By default, the installation will extract temporary files to a sub-directory in the CEF file’s directory. To change the destination directory, use the option ","type":"text"},{"text":"--staging-path ","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Do not interrupt the software update process after you confirmed it and the background process has started.","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"If SSH connection is lost during upgrade, the upgrade will still continue. Reconnect to the server and check the log files for the process status and outcome.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Silent Installation","type":"text"}]},{"type":"paragraph","content":[{"text":"Installing DPOD in a silent mode is possible by supplying a YAML file with all the configuration properties required in the following format:","type":"text"}]},{"type":"codeBlock","content":[{"text":"installation:\n deploymentProfile: \n environmentName: \n appUserName: \n appUserGroup: \n externalIpAddress: \n timeZone: \n ntpServers: \n - \n - \ninstaller:\n isShowWelcome: false\n isEulaAccepted: true\n isInstallationConfirmed: true","type":"text"}]},{"type":"paragraph","content":[{"text":"Add the YAML file as an argument of the CEF file when executing it:","type":"text"}]},{"type":"codeBlock","content":[{"text":"sudo ./ --installation-config-file-path ","type":"text"}]},{"type":"paragraph","content":[{"text":"The following table describes the configuration properties in the YAML file:","type":"text"}]},{"type":"table","attrs":{"layout":"align-start","width":1800.0,"localId":"2e582eea-1087-4acd-98ac-999fd5e0acaa"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[376.0]},"content":[{"type":"paragraph","content":[{"text":"Property","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1421.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[376.0]},"content":[{"type":"paragraph","content":[{"text":"installation.deploymentProfile","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1421.0]},"content":[{"type":"paragraph","content":[{"text":"The deployment profile as described in ","type":"text"},{"text":"Hardware and Software Requirements","type":"text","marks":[{"type":"link","attrs":{"href":"https://montier.atlassian.net/wiki/spaces/DPOD010023x/pages/16274328217/Hardware+and+Software+Requirements#Resources-Requirements-and-Deployment-Profiles"}}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Possible values are: STD_MINIMAL, STD_LOW, STD_MEDIUM, STD_HIGH, STD_HIGH_20D","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[376.0]},"content":[{"type":"paragraph","content":[{"text":"installation.environmentName","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1421.0]},"content":[{"type":"paragraph","content":[{"text":"An 1-4 alphanumeric characters long name to identify the system (e.g.: prod, dev, etc.).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[376.0]},"content":[{"type":"paragraph","content":[{"text":"installation.appUserName","type":"text"},{"type":"hardBreak"},{"text":"installation.appUserGroup","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1421.0]},"content":[{"type":"paragraph","content":[{"text":"Non-privileged OS user and group, see ","type":"text"},{"text":"Operating System Requirements for Non-Appliance Mode","type":"text","marks":[{"type":"link","attrs":{"href":"https://montier.atlassian.net/wiki/spaces/DPOD010023x/pages/16440887137"}}]},{"text":" for more details.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[376.0]},"content":[{"type":"paragraph","content":[{"text":"installation.externalIpAddress","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1421.0]},"content":[{"type":"paragraph","content":[{"text":"IPv4 address to be used to access the Web Console / Admin Console / Agents (Syslog and WS-M).","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[376.0]},"content":[{"type":"paragraph","content":[{"text":"installation.timeZone","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1421.0]},"content":[{"type":"paragraph","content":[{"text":"System time zone.","type":"text"}]},{"type":"paragraph","content":[{"text":"Possible values can be displayed by executing ","type":"text"},{"text":"timedatectl list-timezones","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[376.0]},"content":[{"type":"paragraph","content":[{"text":"installation.ntpServers","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1421.0]},"content":[{"type":"paragraph","content":[{"text":"List of NTP server addresses (IP or domain name), an empty list will use the NTP servers already configure in the OS.","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[376.0]},"content":[{"type":"paragraph","content":[{"text":"installer.isShowWelcome","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1421.0]},"content":[{"type":"paragraph","content":[{"text":"When ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", skips the welcome screen of the installation. Defaults to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[376.0]},"content":[{"type":"paragraph","content":[{"text":"installer.isEulaAccepted","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1421.0]},"content":[{"type":"paragraph","content":[{"text":"When ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", indicates that the terms of the EULA are accepted by the user who’s installing the application, and skips the EULA screen of the installation. Defaults to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[376.0]},"content":[{"type":"paragraph","content":[{"text":"installer.isInstallationConfirmed","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1421.0]},"content":[{"type":"paragraph","content":[{"text":"When ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":", indicates that the installations configuration is correct and that the changes made by the installation to the operating system are accepted accepted by the user who’s installing the application, and skips the confirmation screen of the installation. Defaults to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]}]}]},{"type":"paragraph"}],"version":1}

Browser not supported