The StackBuilder Plus utility provides a graphical interface that simplifies the process of downloading and installing modules that complement your Advanced Server installation. When you install a module with StackBuilder Plus, StackBuilder Plus automatically resolves any software dependencies.Please note: If your installation resides on a Linux system, you must install the redhat-lsb package before invoking StackBuilder Plus. For more information, see Section 4.1.StackBuilder Plus requires Internet access; if your installation of Advanced Server resides behind a firewall (with restricted Internet access), StackBuilder Plus can download program installers through a proxy server. The module provider determines if the module can be accessed through an HTTP proxy or an FTP proxy; currently, all updates are transferred via an HTTP proxy and the FTP proxy information is not used.You can invoke StackBuilder Plus at any time after the installation has completed by selecting the StackBuilder Plus menu option from the Postgres Plus Add-ons menu (Linux) or from the Apps menu (Windows). Enter your system password (if prompted), and the StackBuilder Plus welcome window opens (shown in Figure 4.62).If the selected Advanced Server installation has restricted Internet access, use the Proxy Servers button on the Welcome window to open the Proxy servers dialog (shown in Figure 4.63).Enter the IP address and port number of the proxy server in the HTTP proxy or FTP proxy fields on the Proxy servers dialog. Currently, all StackBuilder Plus modules are distributed via HTTP proxy (FTP proxy information is ignored). Click OK to continue.The tree control on the StackBuilder Plus module selection window (shown in Figure 4.64) displays a node for each module category.
• If the module is installed, you will see the word (installed) to the right of the module name.
• If a module name is in bold type, the installer has detected a mismatch between the available version and the installed version.
• To add new modules to the selected Advanced Server installation, check the box to the left of the module name and click Next. A window opens, requesting your EnterpriseDB registration information (as shown in Figure 4.65).Figure 4.65 — The User Authentication window.Before downloading and installing modules and updates with StackBuilder Plus, you must enter the user information associated with your EnterpriseDB account. If you do not have an EnterpriseDB user account, click the link provided to open a web browser, and enter your user information.Enter the email address of a registered account in the Email field, and the corresponding password in the Password field, and click Next to continue. The next dialog confirms the packages selected (Figure 4.66).You can change the directory; use the button to the right of the Download directory field to open a file selector, and choose an alternate location to store the downloaded installers. Click Next to connect to the server and download the required installation files. (see Figure 4.67).When the download completes, a window opens to confirm that the installation files have been downloaded and are ready for installation (see Figure 4.68).You can check the box next to Skip Installation, and select Next to exit StackBuilder Plus without installing the downloaded files, or leave the box unchecked and click Next to start the installation process.Each downloaded installer has different requirements. As the installers execute, they may prompt you to confirm acceptance of license agreements, to enter passwords, and enter configuration information.During the installation process, you may be prompted by one (or more) of the installers to restart your system. Select No or Restart Later until all installations are completed. When the last installation has completed, re-boot the system to apply all of the updates.You may occasionally encounter packages that don’t install successfully. If a package fails to install, StackBuilder Plus will alert you to the installation error with a popup dialog, and write a message to the log file at:On Windows: %TEMP%On Linux: /rootWhen the installation is complete, StackBuilder Plus will alert you to the success or failure of the installations of the requested packages (see Figure 4.69). If you were prompted by an installer to restart your computer, re-boot now.The following table lists the modules supported by StackBuilder Plus. Please note that the list is subject to change and varies by platform.