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 subse­quent screen, the installer prompts for the data location (by default [instal­lation 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 Appli­cation 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 maxi­mum, 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

Click Next.

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.

Click Next.

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\instal­led.properties to override portions of the IP selection’s impacts:

#

# specific interface used for all NMS initiated

# communications to the network

com.dorado.mediation.outbound.address=localhost

#

# specific interface used for binding mediation

# listeners such as SNMP trap listener

com.dorado.mediation.listener.address=localhost

#

# specific interface used for all northbound

# communications to external management system(s)

com.dorado.mediation.northbound.address=localhost

 

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.

Click Next.

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.tim­e­stamp 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

Then run:

oraclepostinstall

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.




  1. You must install to Linux / Solaris as a non-root user with the permission to create directories in the selected installa­tion path. Installing to a directory that requires root level access fails. Also: Using the Windows login “admin” to do the installation wipes out any pre-configured “admin” per­missions that come with the application. Therefore, do not use “admin” as the installing user account. Also: Do not install as a Windows user with a space in the login name.
  2. You cannot install from a directory whose name begins with @. Also: You must extract any compressed (zipped) installation source before executing the installation.
  3. Linux installation can start in the following ways: a) type ./linux_install.sh in a shell. This lets application server, autostart function. b) Double click on the linux_install.sh file in the installation directory. This produces a screen with running options. if you click Run application server autostart functions. If you click on Run in Terminal it does not.
  4. If you are installing the software on a machine with multi­ple Network Interface Cards (NICs), installation prompts you to select one IP address for the system you are install­ing. Also: Windows 2008 may not support the installer finding the host's IP Address. In such cases, a screen appears where you can enter the IP address and Partition Name for your installation.
  5. If you try to install to a location where you do not have write permissions, the installer fails to create the target directory structure. You must have permission to create the directory as the user running the installation. If not, log in as root and either create the target directory and configure permissions or grant permissions on the parent directory so user can create a subdirectory later (during installation).
  6. You must also include a medserver configuration for the application server to perform mediation tasks. If you do not, then the application server’s mediation capabilities are disabled. If some time later you want to disable mediation capabilities configured here, you can add oware.apps­erver.mediation.setup=false to the installprops/lib/installed.properties file.
  7. If you want your server to autostart, but want to tune it before it autostarts, elect to install as a service/daemon, but run it manually first until tuning is done, then resume using autostart. For Windows: go to Services in Control Panel, stop the service and make it start manually instead of automatically. You can set it to automatically start when you are ready to resume using autostart. For UNIX: after rebooting (if that occurs), use the pmstopall command to stop appserver. Start and stop manually using startapps­erver/stopappserver. Then run pmstartall or reboot to resume using autostart. See startappserver / stopappserver Command Lines on page 66. As always, run oware in Win­dows, or . /etc/.dsienv in UNIX before running command lines.
  8. Again, the installer does not install Oracle, it assumes an installation of that database already exists. Since installing Oracle is a process apart from this installation Redcell Synergy does not create db_setup.log. See Oracle Database Management for more about Oracle databases.
  9. if loaddb -u system -w password does not work the first time then add -d.