2 Installing the Connector

The Oracle Enterprise Manager Connector Framework requires a web service interface for forwarding event information to Microsoft SCOM. To integrate with Enterprise Manager, a third-party SCOM web service front-end must be installed. In addition to the web service front-end, an Oracle SCOM Agent must also be installed. Both of these components are included in the Oracle Enterprise Manager SCOM connector installation package.

You can install the web service on any Unix or Windows system that has connectivity with the SCOM server. In addition to the SCOM web service front-end, you must also install a back-end Oracle SCOM Agent. The Oracle SCOM Agent is preconfigured and is also included in the Oracle Enterprise Manager SCOM connector installation package.

Figure 2-1 shows the communication between the various components of the SCOM Connector.

Figure 2-1 Connector Communication Between Components

Connector Communication Between Components

The following sections in this chapter discuss these topics:

Note:

Unless otherwise noted, these instructions apply to the SCOM 2012 connector and to the SCOM 2007 connectors. Instructions specific to the SCOM 2007 connectors are available in Appendix E, "SCOM 2007 Connector".

2.1 Installation Platforms

You can install the SCOM web service on the following platforms that support Oracle Java Development Kit (JDK) 6.0:

  • Microsoft Windows

  • Oracle Solaris

  • Linux

Depending on the following SCOM connector versions, you can install the Oracle SCOM Agent on the Microsoft Windows server platform:

  • For the SCOM 2012 connector, the Microsoft Windows 2008 and 2012 server platforms are supported.

  • For both SCOM 2007 connectors, the Microsoft Windows 2000, 2003, and 2008 server platforms are supported.

Note:

For information on how to install the SCOM 2012 Connector in High Availability using Windows Failover Clustering, refer to My Oracle Support (https://support.oracle.com) Doc ID 1674577.1: 
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrl-state=m78vx2zfr_123&id=1674577.1

2.2 Prerequisites

In order to install the connector, the My Oracle Support Preferred Credentials must be set to enable the download of the connector through self-update. To set the credentials, perform the following steps:

  1. From the Enterprise Manager console, click Setup.

  2. Select My Oracle Support in the pane.

  3. Select Set Credentials, then enter the username and password information and click Apply.

  4. From the Enterprise Manager console, click Setup.

  5. Select Extensibility in the pane.

  6. Select Self Update and click Check Updates to schedule a job to collect the metadata for the connectors.

Refer to the "Setting up Self Update" section of the "Updating Cloud Control" chapter in the Oracle Enterprise Manager Cloud Control Administrator's Guide for more details:

http://docs.oracle.com/cd/E24628_01/doc.121/e24473/self_update.htm#BEJJEHDJ

Note:

You can also set up Self Update in offline mode. See the "Applying an Update in Offline Mode" section from the Oracle Enterprise Manager Cloud Control Administrator's Guide for details: 
http://docs.oracle.com/cd/E24628_01/doc.121/e24473/self_update.htm#BEJICEBD

The following are prerequisites you should review before installing the connector:

  • A utility for unzipping .zip files is available where the SCOM Agent is to be installed

  • Oracle Java Development Kit (JDK) 6.0 Update 11 or higher is installed on the system where the SCOM Web Service will be installed.

    Note:

    The web service does not support JDK 7 and must be run with JDK 6 Update 11 or higher.

  • In order to create events to Microsoft SCOM, you must import the OracleEnterpriseManager.Alert.Creator Management Pack from the Microsoft SCOM server. The Management Pack file is provided with the SCOM Agent installation binaries.

2.3 Installing the Connector in Enterprise Manager

The SCOM connector is not included out-of-box so it must be downloaded from the Oracle Enterprise Manager store. All connectors in the Enterprise Manager store are available on the Self Update page for downloading provided the My Oracle Support Preferred Credentials are configured. See Prerequisites for instructions. The installation files for the Oracle SCOM agent and web service are packaged with the SCOM connector. The connector must be installed first in order to gain access to the installation files.

Perform the following steps to download and install (apply) the connector.

  1. From the Enterprise Manager console, click Setup.

  2. Select Extensibility in the pane.

  3. Get a list of available connectors by selecting Self Update and then clicking Management Connector.

    The Microsoft SCOM connectors should be listed here with a status of Available.

  4. Click the appropriate Microsoft SCOM connector to select it and then click Download.

    The Schedule Download window will be displayed to determine when the download should be performed.

  5. Click Select to download immediately.

    Note:

    If you want to schedule the download for a later time, specify the date/time when the download should take place and click Select. You must return to finish the remainder of this procedure after the scheduled download date/time.

  6. If necessary, refresh the screen until the status of the connector changes to Downloaded.

  7. Click the appropriate Microsoft SCOM connector to select it and then click Apply.

    You will be prompted to confirm the operation and then a window appears that indicates the request has been submitted.

  8. Refresh the screen until the status of the connector changes from Apply Scheduled to Applied.

2.3.1 Installing the Connector if Enterprise Manager is in "Offline" Mode

Under certain circumstances, such as in high security environments, an active Internet connection between Enterprise Manager and the Enterprise Manager Update Store may not be available. In such situations, Enterprise Manager can be set to install the connector in an "offline" mode.

The installation process still requires that a computer exist at your site that has Internet access, as a connection to the Enterprise Manager Update Store is still required to obtain the necessary files. The files that you download to this computer can then be transferred to a computer behind your firewall.

To install the connector if Enterprise Manager is in "offline" mode:

  1. From the system that you will ultimately deploy the connector, set Enterprise Manager Cloud Control to Offline Mode:

    1. From the Setup menu, select Provisioning and Patching, then select Offline Patching.

    2. In the Online and Offline Settings page, select Offline.

  2. From the Setup menu, select Extensibility, then select Self Update.

  3. On the Self Update page, click Check Updates. A message appears with the following URL to an Oracle site from where the updates catalog file can be downloaded:

    https://updates.oracle.com/Orion/Download/download_patch/p9348486_112000_Generic.zip

  4. From an Internet-enabled computer, download the catalog file using the aforementioned URL.

  5. Copy the downloaded catalog file to the OMS host or the Management Agent host where you plan to import the connector.

  6. Import the catalog file to Enterprise Manager:

    • If the catalog file is on the OMS host:

      emcli import_update_catalog -file="file" -omslocal

      Where:

      • -file: is the direct path to the connector archive (*.zip).

      • -omslocal: indicates that the path mentioned in the -file option is directly accessible to the Enterprise Manager server

    • If the catalog file is on a different host:

      emcli import_update_catalog -file="file" -host="hostname" [-credential_set_name="setname"] | -credential_name="name" -credential_owner="owner"

    Example 2-1 shows a sample for importing the catalog archive.

  7. On the Self Update page, in the table, click Management Connectors.

  8. On the Connector Updates page, select the imported update that is available for download. Click Download.

    A message appears with a URL to an Oracle site from where the update can be downloaded.

  9. From a computer that is connected to the internet, download the update using the aforementioned URL.

  10. Copy the downloaded file to the OMS host or the Management Agent host where you plan to deploy the connector.

  11. To import the downloaded connector archive into Enterprise Manager, run the following command:

    emcli import_update -file=”<path to *.zip file>” -omslocal

    Where:

    • -file: is the direct path to the connector archive (*.zip).

    • -omslocal: indicates that the path mentioned in the -file option is directly accessible to the Enterprise Manager server

Example 2-1 Sample for Importing Catalog Archive

emcli import_update_catalog -file="/u01/common/p9348486_112000_Generic.zip"  -omslocal

Imports the master catalog file p9348486_112000_Generic.zip. The file must exist
on the OMS host. In a multiple OMS setup, the request can be processed by any
OMS, so the file should be accessible from the OMS processing the request. This
means that the file must be kept on a shared location that is accessible from all
the OMS instances.

emcli import_update_catalog -file="/u01/common/p9348486_112000_Generic.zip" -host="host1.example.com" -credential_set_name="HostCredsNormal"
 
Imports the master catalog file p9348486_112000_Generic.zip that is present on 
the host host1.example.com. The host must be a managed host target in Enterprise
Manager, and the Management Agent on this host must be up and running. The
preferred unprivileged credentials for host host1.example.com are used to retrieve
the remote file.

2.4 Installing and Running the Oracle SCOM Agent

The following sections provide procedures for installing and running the Oracle SCOM Agent:

2.4.1 Preinstallation Requirements

Note:

These requirements apply to the SCOM 2012 connector only. For the SCOM 2007 connectors, see Verify Preinstallation Requirements in Appendix E.

The following requirements apply to the system where the Oracle SCOM Agent is installed.

  • .NET framework 4.0 is installed.

  • ASP.NET 4.0 is installed.

    After .NET framework 4.0 is installed, enter the following command to install ASP.NET 4.0:

    %SystemRoot%\Microsoft.NET\Framework\v4.0.xxxxx\aspnet_regiis –i

    WARNING:

    This command upgrades other applications running under IIS to version 4.0.

  • Internet Information Services (IIS) 7.0 or higher is installed

  • CGI and ISAPI Extensions Role Services are installed. To install the Role Services, perform the following steps:

    1. Click Start, then Administrative Tools, and finally Server Manager to open the Server Manager

    2. Expand Roles in the left panel.

    3. Scroll down to the Web Server (IIS) section and click on Add Role Services. This will open the Add Role Services window.

    4. Check the check box for CGI and ISAPI Extensions under Web Server/Application Development.

    5. Click Next and then Install.

  • ISAPI and CGI Restrictions are set to allowed for ASP.NET 4.0. To enable ASP.NET 4.0, perform the following steps:

    1. Click Start, then Administrative Tools, and finally Internet Information Services (IIS) Manager to open the IIS Manager

    2. Click the local machine name under Connections.

    3. Select Content View. ISAPI and CGI Restrictions should be listed.

    4. Double click ISAPI and CGI Restrictions. The ISAPI and CGI Restrictions page is displayed.

    5. Right click on the appropriate v4.0 line for your environment and select Allow.

    Note:

    The path that contains Framework is for 32-bit environments, and the path that contains Framework64 is for 64-bit environments.

2.4.2 Setting Up the Agent Account

Note:

These instructions apply to the SCOM 2012 connector only. For the SCOM 2007 connectors, see Verify Agent Account Prerequisites in Appendix E.

Before installing the Oracle SCOM Agent, you need to set up an account for the Oracle SCOM Agent to access the SCOM API. The account must satisfy the following requirements:

2.4.2.1 System Center Operations Manager 2012 Administrator Groups

To determine the groups that are designated as an System Center Operations Manager 2012 Administrator, perform the following steps:

  1. In the Administration pane of the System Center Operations Manager 2012 console (Figure 2-2 shows the console), select Administration, then Security, then User Roles. The User Roles should be displayed in the center pane.

  2. Right-click on Operations Manager Administrators and select Properties. The General Properties tab lists the groups that have administrative permissions in the User Role members window. The account the Agent uses must be a member of one of the groups listed here, or you need to add one of its groups to this list.

Figure 2-2 Operations Manager Administrators Console

Ops Manager Admin Console

2.4.3 Installing the Agent

The SCOM Web Service uses the back-end Oracle SCOM Agent to access the SCOM API. The Oracle SCOM Agent must be installed on a Windows system that has connectivity to the SCOM server. The Oracle SCOM Agent is preconfigured to interface with the SCOM Web Service and requires minimal configuration.

Note:

There should only be one installed instance of the Oracle SCOM Agent.

To install the Oracle SCOM Agent, perform the following steps:

  1. Obtain a copy of the agent installation file from the Management Server host machine as specified in Exporting the Agent Installation Files and put the SCOMAgent.zip installation file into the directory where you want to install the Oracle SCOM Agent.

  2. Unzip the contents of the SCOMAgent.zip file to any directory.

    This extracts the SCOMAgentInstaller.msi and the OracleEnterpriseManager.Alert.Creator.xml files into the designated directory.

  3. Navigate to the directory and run the Oracle SCOM Agent installer by double-clicking on the SCOMAgentInstaller.msi file.

    This starts the installer and displays the Welcome to the Oracle SCOM Agent Setup Wizard page.

  4. Click Next to display the Service Type page.

  5. Select the type of service to be installed under IIS. The default and recommended service type is Web Site.

    This installs the service as a stand-alone web site. Selecting Virtual Directory installs the service as a Virtual Directory under an existing web site.

  6. Click Next to display the Select Installation Folder page.

  7. Enter the location to install the Agent or accept the default location of C:\iWaveSoftware\SCOMConnectorAgent.

  8. Click Next to display the SCOM Agent Options page.

  9. Enter the name to use when registering the connector in SCOM, or accept the default value of SCOM Agent.

  10. Click Next to display the Confirm Installation page.

  11. Click Next to display the SCOM Management Group Configuration page, and enter the information for the following required fields on the form:

    • Host name or IP address of the SCOM server

    • Domain of the account to use when connecting to the SCOM API

    • User name of the account to use when connecting to the SCOM API

    • Password of the account to use when connecting to the SCOM API

    Note:

    The information for the account from Setting Up the Agent Account should be entered in the Domain, Username, and Password fields.

  12. Click Done to proceed. The window displayed next depends on the Service Type you selected in step 5 above.

    • If you selected Web Site:

      The Web Site Configuration window appears. This window contains the Web Site Name and Port Number fields, and both have default values. Accept the default values or change them to the desired values.

    • If you selected Virtual Directory:

      The Virtual Directory Configuration window appears. This window defines the name of the virtual directory to create and the web site within which it will be installed. Accept the default values or change them to the desired values.

  13. For either window, click OK to proceed and display the Web Service Credentials window. This window defines the credentials to specify when testing the newly installed Oracle SCOM Agent.

  14. Specify valid Windows account credentials and click OK.

    The installer now invokes the web service to verify that it is operational. A window pops up with the results of the test.

  15. Close the window. The Installation Successful window appears. This window lists the URL of the Oracle SCOM Agent.

    Note the URL. You will need this whenever you install the SCOM Web Service.

  16. Click OK to continue. The Installation Complete window appears.

  17. Click Close to complete the Agent installation process.

2.4.4 Configuring Agent Notification

Note:

These instructions apply to the SCOM 2012 connector only.

If the Agent was NOT installed on the SCOM server, you must perform the following steps to configure the SCOM server to send a notification message to the SCOM agent whenever an alert is created by the SCOM 2012 connector:

  1. Obtain a copy of the notification setup file from the Management Server host machine as specified in Exporting the Agent Installation Files and put the SCOMNotification.zip installation file into the directory where you want to install the Agent Notification utility.

  2. Unzip the contents of the SCOMNotification.zip file to any directory. This creates the bin\NotificationConfiguration.exe and the OracleEnterpriseManager.Alert.Creator.xml files in the designated directory.

  3. Right click on the NotificationConfiguration.exe file and select Run as administrator. The Agent Connection Information window will be displayed as shown in Figure 2-3.

  4. Enter the information required to connect to the SCOM Agent as described below:

    1. Agent URL: Enter the URL that was noted when you installed the Oracle SCOM Agent. You will need to replace localhost with the actual hostname or IP address of the system where the Oracle SCOM Agent was installed.

    2. Domain: Enter the domain of the account to use when connecting to the Oracle SCOM Agent. This field can be left blank if you are using an account that is local to the system where the Oracle SCOM Agent is installed.

    3. User Name: Enter the username of the account to use when connecting to the Oracle SCOM Agent. This must be a valid user account that has permission to access the system where the Oracle SCOM Agent is installed.

    4. Password: Enter the password to use when connecting to the Oracle SCOM Agent. This must be the password of the account specified in the User Name field.

    Note:

    Most likely, the Domain, User Name, and Password information will be the credentials entered in step 14 of Installing the Agent.

  5. Click OK.

Figure 2-3 Agent Connection Information Window

Agent Connection Information Window

2.4.5 Installing the Alert Creator Management Pack

A management pack file named OracleEnterpriseManager.Alert.Creator.xml is also included in the Agent/Notification installation zip files. This management pack is required to create alerts in SCOM. Follow the steps below to import the management pack into SCOM:

Note:

These instructions are for SCOM 2012 only. For instructions to install the Alert Creator Management Pack for SCOM 2007, see Install the Alert Creator Management Pack in Appendix E.

  1. In the Administration pane of the Operations Manager console, select Administration, then Management Packs.

  2. Right-click on Management Packs and select Import Management Packs… The Select Management Packs window appears.

  3. For SCOM 2012, click Add and select Add from disk...

  4. Navigate to the directory where the OracleEnterpriseManager.Alert.Creator.xml file is located.

  5. Select the OracleEnterpriseManager.Alert.Creator.xml file and click Open. The Import Management Packs window appears.

  6. Click Install to import the management pack.

  7. Click Close after the management pack has been imported.

The Agent is now configured to insert alerts into SCOM.

2.4.6 Starting and Stopping the Agent

The installer automatically starts the Agent. To stop the agent, open the IIS manager, select the web site where it was installed, then click Stop. To start, click Start.

2.4.7 Uninstalling the Alert Creator Management Pack

To remove the alert creator management pack OracleEnterpriseManager.Alert.Creator.xml, perform the following steps:

  1. In the Administration pane of the Operations Manager console, select Administration, then Management Packs.

  2. In the Management Packs pane, right click the Oracle Enterprise Manager Alert Creator management pack and click Delete.

  3. On the message stating that deleting the management pack might affect the scoping of some user roles, click Yes.

2.4.8 Uninstalling the Oracle SCOM Agent

To uninstall the Oracle SCOM Agent, perform the following steps:

  1. Open the Control Panel and select Add/Remove Programs.

  2. Find and select SCOM Agent. Select Uninstall, and click Yes, to confirm.

  3. Manually navigate to the installation directory and remove any remaining installation files. The default installation directory is for the agent is

    C:\iWaveSoftware\

  4. (Optional) Remove or disable the domain Agent Account created exclusively for the Oracle SCOM Agent.

2.4.9 Exporting the Agent Installation Files

The agent installation file is included in the Self Update archive that was installed in Installing the Connector in Enterprise Manager. To extract the installation file, perform the following steps.

  1. Determine the command required to export the agent installation file. To do this, perform the following steps:

    • From the Enterprise Manager console, click Setup.

    • Select Extensibility in the pane.

    • Select Self Update and then click Management Connector.

    • Click the appropriate Microsoft SCOM connector name, then select Export from the Actions list.

    A pop-up window will appear with the command required to export the file. Figure 3-5 shows an example.

  2. Open a command window on the Operations Manager host machine and navigate to a temporary directory where the file can be copied.

  3. Log in to emcli using the following command. You will be asked to provide the password information for the Super Administrator account.

    emcli login -username=<Super Administrator>

    Note:

    For information about using emcli, see the Oracle® Enterprise Manager Command Line Interface guide at: 
    http://docs.oracle.com/cd/E24628_01/em.121/e17786.pdf

  4. Run the emcli export_update command from your system, changing <dirname> to the full path of the temporary directory.

    A zip file will be created. The file name will be comprised of the id value specified in the export_update command with a .zip extension.

  5. Extract the agent installation files from the zip file using the following command:

    unzip *.zip archives/SCOM*.zip

2.5 Installing the Microsoft SCOM Web Service

The SCOM web service acts as a front-end for all data flowing into and out of SCOM. Oracle Enterprise Manager posts calls to the web service whenever it needs to create or update an event.

You can install the SCOM web service on any Unix or Windows system that has Oracle JDK 6.0 installed and has connectivity to the Oracle SCOM Agent and the Oracle Enterprise Manager server.

The following sections provide instructions for installing the Microsoft SCOM web service on Unix and Windows platform:

2.5.1 Installing and Running the Microsoft SCOM Web Service on Unix

The following sections explain how to install and then subsequently run the Web Service:

2.5.1.1 Prerequisites

The following prerequisites must be met before proceeding to the next section.

  • Oracle Java Development Kit (JDK) version 6 Update 11 or higher is installed.

    Note:

    JDK 7 is not supported; so, it must be JDK version 6 with an Update version equal to or greater than 11.

  • JAVA_HOME environment variable is set to the JDK installation directory.

2.5.1.2 Installing the Web Service on Unix

To install the web service on a Unix platform, perform the following steps:

  1. Create a directory where you want to install the web service.

  2. Obtain a copy of the web service installation file from the Management Server host machine as specified in Exporting the Web Service Installation File.

  3. Copy the SCOM_webservices_adapter.jar file to the web service installation directory.

  4. Open a terminal and change the working directory to the installation directory.

  5. Enter the following command to unzip and extract the .jar file:

    $JAVA_HOME/bin/jar xvf SCOM_webservices_adapter.jar

    This creates the adapters directory that contains the installation files.

    Note:

    If the system where the SCOM web service is being installed does not have the JDK installed, you cannot extract the jar file contents. You need to copy the jar file to a system that has the JDK installed and transfer the files after they have been extracted.

  6. Enter the following command to change the working directory:

    • For SCOM 2012:

      cd adapters/endpoints/SCOM

    • For SCOM 2007:

      cd adapters/endpoints/SCOM2007

  7. Enter the following command to run the installation script:

    sh ./install.sh

  8. When the script prompts whether you want to use HTTPS:

    • If you specify Y, the web service is set up to use HTTPS port number 8443.

    • If you specify N, the web service is set up to use HTTP port number 8080.

    Note:

    Refer to Changing Default Port Numbers in Appendix A for details on changing default port numbers.

  9. When the script prompts for the user name of the web service, enter the user name that must be provided to access the SCOM Web Service.

    The user name can be any value and is not associated with any specific OS or SCOM account. Make a note of this value and supply it when configuring the SCOM connector in Enterprise Manager.

  10. When the script prompts for the password of the web service, enter the password that must be provided to access the SCOM Web Service.

    The password can be any value and is not associated with any specific OS or SCOM account. Note this value and supply it when configuring the SCOM connector in Enterprise Manager.

  11. After the script prompts for the URL of the Oracle SCOM Agent, enter the URL that was noted when you installed the Oracle SCOM Agent. If the web service is being installed on a different machine than the Oracle SCOM Agent, the localhost in the URL must be replaced with the actual hostname or IP address of the machine where the Oracle SCOM Agent is installed.

  12. After the script prompts for the username and password to use when accessing the Agent, enter a valid Windows username and password.

    Note:

    If the account is a domain account, include the domain information when specifying the username. The format must follow the standard Windows format where the domain is specified first, followed by a backslash, and then the username is specified last. For example: domain\username.

  13. After the script displays the message "SCOM Web Service Complete," press Enter to complete the installation.

  14. If the web service was configured to run using the HTTPS protocol, you must set up SSL as specified in Configuring Enterprise Manager to use SSL.

The web service framework is now installed and ready to start.

2.5.1.3 Running the Web Service on Unix

To run the Microsoft SCOM Web Service framework commands listed with the following tasks, first change the working directory to the following in the installation directory:

adapters/bin

  • Start — ./service.sh start

  • Shut Down — ./service.sh stop

  • Restart — ./service.sh restart

  • Check Status — ./service.sh status

2.5.1.4 Testing the Web Service on Unix

Perform the following steps to verify that the Microsoft SCOM Web Service is functional.

  1. Open a terminal and change the working directory to the adapters/bin directory in the installation directory.

  2. Enter the following command to run the test script:

    ./testAdapter.sh

  3. When the utility prompts for the web service password, enter the password you specified for the SCOM web service in step 10 of section Installing the Web Service on Unix.

If the test completes successfully, the last line the utility displays is "Test completed successfully."

2.5.1.5 Uninstalling the Web Service on Unix

To uninstall the web service on Unix:

  1. Run the service.sh status command to determine whether the web service is running.

  2. If the web service is running, run the service.sh stop command to stop the web service and verify it completes successfully.

  3. Delete all files in the installation directory.

2.5.2 Installing and Running the Microsoft SCOM Web Service on Windows

The following sections explain how to install and then subsequently run the Web Service.

2.5.2.1 Prerequisites

The following prerequisites must be met before proceeding to the next section.

  • Oracle Java Development Kit (JDK) version 6 Update 11 or higher is installed.

    Note:

    JDK 7 is not supported; so, it must be JDK version 6 with an Update version equal to or greater than 11.

  • JAVA_HOME environment variable is set to the JDK installation directory.

  • Zip utility, such as WinZip, is installed for unzipping a zip file.

2.5.2.2 Installing the Web Service on Windows

To install the web service on a Windows platform, perform the following steps:

  1. Create a directory where you want to install the web service.

  2. Obtain a copy of the web service installation file from the Management Server host machine as specified in Exporting the Web Service Installation File.

  3. Copy the SCOM_webservices_adapter.jar file to the web service installation directory.

  4. Open a terminal and change the working directory to the installation directory.

  5. Enter the following command to unzip and extract the .jar file:

    %JAVA_HOME%\bin\jar xvf SCOM_webservices_adapter.jar

    This creates the adapters directory that contains the installation files.

    Note:

    If the system where the SCOM web service is being installed does not have the JDK installed, you cannot extract the jar file contents. You need to copy the jar file to a system that has the JDK installed and transfer the files after they have been extracted.

  6. Enter the following command to change the working directory:

    • For SCOM 2012:

      cd adapters\endpoints\SCOM

    • For SCOM 2007:

      cd adapters\endpoints\SCOM2007

  7. Enter the following command to run the installation script:

    .\install.bat

  8. When the script prompts whether you want to use HTTPS:

    • If you specify Y, the web service is set up to use HTTPS port number 8443.

    • If you specify N, the web service is set up to use HTTP port number 8080.

      Note:

      Refer to Changing Default Port Numbers in Appendix A for details on changing default port numbers.

  9. When the script prompts for the user name of the web service, enter the user name that must be provided to access the SCOM Web Service.

    The user name can be any value and is not associated with any specific OS or SCOM account. Make a note of this value and supply it when configuring the SCOM connector in Enterprise Manager.

  10. When the script prompts for the password of the web service, enter the password that must be provided to access the SCOM Web Service.

    The password can be any value and is not associated with any specific OS or SCOM account. Note this value and supply it when configuring the SCOM connector in Enterprise Manager.

  11. After the script prompts for the URL of the Oracle SCOM Agent, enter the URL that was noted when you installed the Oracle SCOM Agent. If the web service is being installed on a different machine than the Oracle SCOM Agent, the localhost in the URL must be replaced with the actual hostname or IP address of the machine where the Oracle SCOM Agent is installed.

  12. After the script prompts for the username and password to use when accessing the Agent, enter a valid Windows username and password.

    Note:

    If the account is a domain account, include the domain information when specifying the username. The format must follow the standard Windows format where the domain is specified first, followed by a backslash, and then the username is specified last. For example: domain\username.

  13. After the script displays the message "SCOM Web Service Complete," press Enter to complete the installation.

  14. If the web service was configured to run using the HTTPS protocol, you must set up SSL as specified in Configuring Enterprise Manager to use SSL.

The following steps are optional. If you want the web service to run as a Windows service, perform the following steps.

  1. Change the working directory to the adapters\bin directory in the installation directory.

  2. If the web service will be run using a 64-bit JDK, copy the iWaveAdapters.exe and iWaveAdaptersw.exe files from the x64 directory to the current directory (.) overwriting the existing files.

  3. Enter the following command to install the web service as a Windows service:

    service.bat install

  4. If the web service will be run using a 64-bit JDK, perform the following substeps to configure the service to use the 64-bit JDK:

    1. In the adapters\bin directory, double click the iWaveAdaptersw.exe file. This will cause the iWave Adapters Properties window to be displayed.

    2. Click the Java tab. The Java tab will be displayed that shows the JVM settings as shown in Figure 2-4.

    3. Uncheck the Use default check box if it is checked.

    4. Click ellipse button to open the Select Java Virtual Machine DLL window.

    5. Navigate to the jvm.dll file in the 64-bit JDK installation directory and click Open.

    6. Click OK.

The web service framework is now installed and ready to start.

Figure 2-4 Java Tab on the iWave Adapters Properties Window

Java Tab on the iWave Adapters Properties Window

2.5.2.3 Running the Web Service on Windows

Standalone Service

To start the SCOM web service framework when set up as a standalone application (not set up to run as a Windows service):

  1. Change the working directory to the adapters\bin directory in the installation directory.

  2. Run the following command:

    startAdapters.bat

To shut down the SCOM web service framework, close the window where you started the adapter.

Windows Service

To start the SCOM web service framework when set up to run as a Windows service, enter the following command:

net start iWaveAdapters

To shut down the SCOM web service framework, enter the following command:

net stop iWaveAdapters

2.5.2.4 Testing the Web Service on Windows

Perform the following steps to verify that the Microsoft SCOM Web Service is functional.

  1. Open a terminal and change the working directory to the adapters\bin directory in the installation directory.

  2. Enter the following command to run the test script:

    .\testAdapter.bat

  3. When the utility prompts for the web service password, enter the password you specified for the SCOM web service in step 10 of section Installing the Web Service on Windows (Windows).

If the test completes successfully, the last line the utility displays is "Test completed successfully."

2.5.2.5 Uninstalling the Web Service on Windows

To uninstall the web service on Windows, determine if the web service is installed as a Windows service:

  1. If the web service is installed as a Windows service, perform the following steps:

    1. Determine if the web service is running.

    2. If the web service is running, run the service.bat stop command to stop the web service and verify it completes successfully.

    3. Run the service.bat uninstall command to remove it as a Windows service and verify it completes successfully.

  2. If the web service is not installed as a Windows service, perform the following steps:

    1. Determine if the web service is running.

    2. If the web service is running, stop the web service by closing the Java window.

  3. Delete all files in the installation directory.

2.5.3 Exporting the Web Service Installation File

The web service installation file is included in the zip file that was extracted in step 4 of Exporting the Agent Installation Files. To extract the installation file, perform the following steps.

  1. Open a command window on the Operations Manager host machine and navigate to the temporary directory where the zip file was created.

  2. Extract the web service installation file using the following command:

    unzip *.zip archives/SCOM_webservices_adapter.jar

2.6 Uninstalling the Connector

To uninstall the connector, you must first delete all defined instances of the connector, then you must delete the connector from the Self Update page.

  1. From the Setup menu, select Extensibility, then Management Connectors.

  2. Select an instance of the connector you want to delete, then click Delete.

  3. On the Confirmation page, click Yes.

  4. Repeat steps 2 and 3 until all instances of the connector have been deleted.

  5. From the Setup menu, select Extensibility, then Self Update.

  6. Click on the Management Connector link in the Type column. A list of updates appears for Management Connectors.

  7. Click on the connector you want to delete, select Actions, then select Delete. The Delete Update window appears.

  8. Click Delete to delete the connector. A pop-up confirmation window appears.

  9. Click OK to confirm and delete the connector.