Install DX NetOps Mediation Manager

Use this article to install  on the Windows or UNIX systems. This article contains the following topics:
camm36
Use this article to install
DX NetOps
on the Windows or UNIX systems. This article contains the following topics:
Installation Planning
The installation prerequisites are as follows:
  • Ensure that users of
    DX NetOps
    and CA Performance Management are in the same user group.
  • Administrator privileges on Windows systems
  • Comply with the system requirements, web browser requirements, supported platforms, and compatibility matrix. For more information, see System Requirements.
  • Java Runtime Environment (JRE) version 1.8 or later
    We recommend that you obtain the latest version of JRE from the Java download site.
Install
DX NetOps
This procedure describes the steps to install
DX NetOps
on Windows or UNIX systems.
Follow these steps:
  1. Log in to the server with the user ID that you want the
    DX NetOps
    processes to use.
    We refer to the user ID throughout this document as CAMM_USER. If you use an invalid user ID, an error occurs and the installation fails.
  2. Start the
    DX NetOps
    installation with the corresponding command based on your operating system:
    • UNIX systems
      $JAVA_HOME/bin/java -jar CAMM-Installer-3.7.0.jar
    • Windows systems
      1. Insert the installation CD-ROM and open Windows Explorer.
      2. Locate and double-click the executable JAR file, CAMM-Installer-3.7.0.jar.
  3. Click Next on the Welcome dialog.
  4. Read the Important Information and click Next.
  5. Review the licensing agreement, accept, and click Next.
  6. Specify a target path for the installation. Or click Choose to browse to an installation location.
    When installing on a Windows System, the default installation directory is C:\Program Files\CA\CAMM. When installing on a UNIX System (Linux or Solaris), the default installation directory is /opt/CA/CAMM.
  7. Select Typical for the new installation.
  8. Select one or more required installation packages.
    • MultiController
    • LocalController
  9. Configure the following
    DX NetOps
    foundation parameters:
    • User ID
      Specifies the user ID for the Generic Executor for the
      DX NetOps
      installation. The user ID is the CAMM_USER and defaults to the current user ID.
      Default:
      root
      Use the same user ID that you used to install Data Collector or the user must have read or write access to $DATA_COLLECTOR_INSTALL/apache-karaf-x.y.z/MediationCenter.
    • Port
      Specifies the port where the Generic Executor listens.
               Default
    : TCP port 29560
  10. Specify whether you install primary or secondary MultiController.
  11. (Optional) Configure the following parameters of primary MultiController:
    For the first installation, configure the primary MultiController. You can configure the secondary MultiController in the subsequent step.
    • MC IP
      Specifies the IP address or host name for the primary MultiController.
      Make sure that the host name is resolved to an IP address for to function properly. supports IP V4.
    • Failover Threshold
      Determines the elapsed time, in seconds, with no received heartbeat messages, in seconds, and signals LocalController failure. When this threshold is reached, the MultiController activates the standby LocalController.
      Default:
      600
    • Will the other MC exist in the cluster?
      Indicates that another MultiController exists or may exist in the cluster.
  12. (Optional) Configure the following parameter for another MultiController in the same cluster:
    • The Other MC IP
      Specifies the secondary MultiController IP address, if you installed and configured a primary MultiController.
      If you installed a secondary MultiController in a previous step, this value is the primary MultiController IP address.
      If this server is a backup server, install the secondary MultiController on a different host server.
  13. Configure the following parameters for the web authentication:
    • User
      Specifies the login name for the
      DX NetOps
      Web Manager.
      Default
      : admin
    • Password
      Specifies the login password for the
      DX NetOps
      Web Manager.
      Default:
      camm
    • Web Port
      Specifies the port for the web UI.
      Default:
      8880
  14. (Optional) Configure the following parameters for LocalController. At least one LocalController is required on any server where the Engine and Presenter subcomponents are running.
    • LC IP
      Specifies the IP address or host name for the LocalController.
      Make sure that the host name is resolved to an IP address for
      DX NetOps
      to function properly.
      DX NetOps
      supports IP V4.
    • LC Port
      Specifies the port for this LocalController.
      Default:
      29598
    • Failover Threshold
      Determines the time (in seconds) that can elapse with no received heartbeat messages. The loss of heartbeat messages indicates the subcomponent failure. When the threshold is reached, the LocalController restarts the Engine, Presenter, or both components.
      Default:
      600
  15. Review the installation summary and click Install.
  16. Click Done.
    The installation is complete.
  17. Navigate to $CAMM_HOME and check the installer information in the version.xml file. The contents of the version.xml file resemble the following format:
    <?xml version="1.0" ?> <CAMM-Version> <Current> <Version><3.7.0>/Version> <Revision><Installer revision number></Revision> </Current> </CAMM-Version>
  18. To start the application, type http://<
    PrimaryMCMachineIP
    >:<
    web-port
    > in a browser.
    Where <
    web-port
    > is the port number that is configured during the
    DX NetOps
    Installation and <
    PrimaryMCMachine IP
    > is the IP address or hostname of the primary MultiController system.
  19. Type the login credentials.
    The
    DX NetOps
    application starts.
    For more information about using the options in UI, see the Using section.
Starting and Stopping Services
This section describes how to start and stop services on the following operating systems:
3
During the
DX NetOps
installation, the Generic Executor and the Web Manager are registered as Services. The service names are CAMM-GE-{user}-{port}, and CAMM-tomcat7-8880. You can automatically start or stop
DX NetOps
at the system startup or shut down by executing specific commands as discussed in this section.
The following diagram illustrates the process flow of starting and stopping services:
Process flow diagram for starting and stopping services-XML
Process flow diagram for starting and stopping services-XML
UNIX
You can execute the startall or stopall script or the init.camm script to start or stop
DX NetOps
. The init.camm script is in the Tools directory in the DX NetOps MM Home directory.
Execute the following init.camm.install script, as root or sudo su, to start or stop
DX NetOps
automatically at the system startup or shut down:
shell# tools/init.camm.install
Execute the following init.camm.uninstall script to remove the setting that automatically starts or stops
DX NetOps
:
shell# tools/init.camm.uninstall
Windows
Execute init.camm.install.bat to install the setting that automatically starts or stops
DX NetOps
:
C:/CAMM/tools/init.camm.install.bat
Execute init.camm.uninstall.bat to remove the setting that automatically starts or stops
DX NetOps
:
C:/CAMM/tools/init.camm.uninstall.bat