Installing the Application
If you are upgrading, ensure you have consulted the appropriate upgrade instructions before you install. See Updating an Existing Installation for general upgrade advice.
Follow these steps to install the application with the installation wizard. Additional types of installations are possible. See Command Line and Silent Installations for information about those.
1. Log in as a user with administrator’s permissions on the Windows machine where you want to install the software or as any non-root account on Linux / Solaris.1
2. If you are installing from CD, insert it into its drive.2 In Windows, installation autoruns. If the installer does not appear, or if you have disabled autorun, you can run the win_install.exe shortcut from a file manager.
To install on Linux or Solaris, run linux_install.sh3 or sol_install.sh.
3. A dialog appears as the Setup program initializes the installation wizard, then it reminds you to shut down other running software (this may include anti-virus software). Click Next.
4. Installation performs a series of system checks to verify the target system is supported.4 If all checks pass, the license agreement appears. You must accept the license to proceed. Click Next.
5. A Component Summary Screen appears, listing the package you are about to install. Click Next.
6. Another screen reminds you to shut down other applications, and for Windows reminds you User Account Control (UAC) needs to be disabled. A link to instructions about disabling UAC also appears. Click Next.
7. If you are upgrading from a previous version, the next screen detects it. The next two screens remind you to backup the database, and ask whether to re-build the database. See Upgrading from Previous Versions for more about what to expect in upgrade installations.
8. The next screen lets you select the directory where the application installs. If you want to install to a different directory, type the path or click Choose to select another in a directory browser.5 After confirming the installation location, click Next.
9. Select the setup type from the available options.
Complete -- Installs the application server, database server, mediation server, and client on the host.
If you select the included MySQL database in a subsequent screen, the installer prompts for the data location (by default [installation root]\oware3rd\mysql), initial and maximum database size.
If you selected Oracle as your database (on a separate machine) a subsequent screen prompts you for the Oracle connection details when installing an Application Server with Oracle as the chosen DBMS. Fill in initial values for Logon User and Password along with the Host, Port and SID.
Application Server -- This leads to screens where you confirm the hostname (by default the existing machine’s name), heap size, and database location. Refer to Memory Tuning (Heap) for more about setting heap size for this and web server.
In a subsequent screen you must confirm whether to install the Application Server as a service (or daemon); you can also elect to start it manually. See Starting Application Server for more information on autostart. 6
Web Portal -- This series of screens prompts you for the location of the web server (IP / Hostname and port), and its memory heap. Application server must already have been installed for this selection. Separate web servers are recommended when more web clients access your system. See System Basics for more sizing advice.
Custom-- This leads to screens where you can select from among the available features to install. These include Application Server, Web Server, Mediation Server, or Database.
If you install a mediation server, you must enter the Redcell partition it addresses, accept or alter the subnet mask for it. By default the subnet mask is 255.255.255.0. This mask represents the portion of the network serviced by this agent.
If you install to a stand-alone database, you can select from either the included MySQL or Oracle.
MySQL installation asks you to specify the data path, a minimum and maximum size. If you specify no maximum, then the database will grow until the disk is full. Best practice is to configure Database Archiving Policies (DAPs) to prevent a full disk.
Oracle does not install an Oracle database, but points the application server to an Oracle instance that must already be installed. You must specify its User, Password, Host, Port and SID in subsequent screens.
In the screens for these alternatives, you can also check Autostart to have the installed.7
10. Select where you want the product icons for your installation to appear, and whether they are to be accessible for just your login, or all users.
Enter the partition name if your desired name differs from the supplied default, and insure it starts with a letter, and select whether to autostart. Click Next.
In some installations, the next screen lets you select a heap size to tune Application Server performance. Either accept the default for this and the web portal, or alter them according to your system’s needs. Click Next.
11. If installing to a multi-homed machine (multiple NICs), choose a default IP address for use by the software. Installation automatically records this address.Click Next.
You can add the following properties to owareapps\installprops\installed.properties to override portions of the IP selection’s impacts:
# specific interface used for all NMS initiated
# communications to the network
# specific interface used for binding mediation
# listeners such as SNMP trap listener
# specific interface used for all northbound
# communications to external management system(s)
For any property, replace the localhost text with the correct IP. See Overriding Properties for more about the point in overriding properties.
12. Select an Oracle8 or MySQL (included) database.
MySQL installation requests a data path, an initial size and maximum size. A blank maximum allows growth without limits.
13. An installation summary appears. Click Install, and the installer installs all of the required software for your hardware configuration.
14. If you are installing on Linux / Solaris, you must run a setup script in a separate shell, logged in as root user. Installation prompts you to run a generated script after the install phase finishes. This script records information in case you need technical assistance and installs some files as root. Open a new shell, log in as root, and run the listed script ($OWARE_USER_ROOT/install/root/setup.sh).
This step installs some essential environment files. It does not check for patches (the installation does that). The contents of patch_check.log.timestamp now appear embedded in setup.log.
15. MySQL: The installer either builds the database for first time use or prompts you to rebuild it if a database already exists. Building the database for the first time may take several minutes to complete.
Ensure your Linux package has not already installed a version of the embedded database. If it has, uninstall that database before proceeding. Also: Do not configure and/or install a database larger than the available disk space.
Regardless of the initial database size, post-installation configuration of Database Aging Policies (DAP) can have a significantly impact on how fast it reaches its capacity. The default DAP for alarms, for example, never cleans open alarms from the database. Similarly, defaults for archiving event history may not suit your environment. Consult the Redcell Synergy User Guide for details about tuning these policies.
16. Oracle: For Oracle databases run the following command lines:
loaddb -u system -w manager -s. 9
Oracle Database Management addresses fine-tuning these installation steps.
17. When you install Application Server a service, the installer prompts to let you start the service without rebooting again. If you elect to start the Application Server service, a monitor icon appears in the Windows tray that is yellow as Application Server starts up, and green when it is completely up and running.
To confirm Application Server is running, you can run pmgetstatus in a shell. Both Application Server and Web Server (status indicated by the Apache icon) must be completely started before you can open the client.
18. Finally, the application prompts you to click Done.
19. After you complete the installation, you may want to install Adobe Acrobat Reader. You can download a free copy from www.adobe.com. This application requires Acrobat to successfully print reports. Additional post-Redcell Synergy installations can also include Perl and FTP/TFTP servers. See Installing Perl and Setting Up FTP / TFTP.
To start the client, open a browser to http://[application server name or IP address]:8080.