Skip Headers
Oracle® Enterprise Manager Installation and Configuration Guide for CA Service Desk Connector
Release 12.1.0.2.0
Part Number E28577-02
Go to Documentation Home
Home		 Go to Book List
Book List		 Go to Table of Contents
Contents		 Go to Feedback page
Contact Us
Go to previous page
Previous		 Go to next page
Next
PDF · Mobi · ePub

2 Installing and Uninstalling the Connector

The CA Service Desk (CASD) ticketing connector is comprised of the CASD adapter and CASD connector components. The CASD adapter provides a web service interface for manipulating tickets in CA Service Desk.

This chapter provides the following information for installing or uninstalling the CASD Connector, as well as switching from one console to the other:

Prerequisites

Ensure that the following prerequisites have been met before continuing:

Installing the Connector

This section provides the procedure required to download and install (apply) the connector. The CASD connector is not included out-of-the-box, so you need to download it from the Oracle Enterprise Manager store. All connectors in the Enterprise Manager store are available on the Self Update page for downloading.

To install the connector:

  1. From the Enterprise Manager console Setup menu, select Setup, then select Extensibility.

  2. Click on the Management Connector link in the Type column.

    The CASD connectors appear in the list with a status of Available.

  3. Click on the appropriate CASD connector to select it, and then click Download.

    The Schedule Download window appears, where you can determine when the download should be performed.

  4. Click Select to download immediately.

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

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

  6. Click on the CASD connector to select it, and then click Apply.

    After you respond to the prompt to confirm the operation, a page appears that indicates the request has been submitted.

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

Exporting the Adapter Installation File

The adapter installation file is included in the Self Update archive that was installed in the previous section.

To extract the installation file:

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

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

    2. Click on the Management Connector link in the Type column.

    3. Click on the CASD connector to select it, then select Export from the Actions list.

      A pop-up window, like the example shown in Figure 2-2, appears with the command required to export the file.

      Figure 2-2 Export Command Example

      Surrounding text describes Figure 2-2 .

  2. Open a command window on the Management Server host system and navigate to a temporary directory where you can copy and unzip the file.

  3. Log into EM CLI using the following command. You will be asked to provide the password information for the sysman account.

    emcli login -username=sysman

    EM CLI must be executed from the OMS host. See the Oracle Enterprise Manager Command Line Interface for information about setting up EM CLI.

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

    This action creates a zip file. The file name is comprised of the id value you specify in the export_update command with a .zip extension. In the example command in Figure 2-2, the zip file name would be E9F684312AE7A18E98340715D079E58D.zip .

  5. Extract the adapter installation .jar file from the .zip file using the following command:

    unzip *.zip archives/casd_adapter.jar

Installing the Adapter

The CASD Adapter acts as a front end for all tickets flowing into and out of CASD. Oracle Enterprise Manager posts calls to the web service whenever it needs to create or update a ticket, or get a ticket ID from CASD.

You can install the CASD Adapter on a supported Unix or Windows system that has connectivity to the CASD server and the Oracle Enterprise Manager server.

Security Recommendations

Because the CASD Adapter stores sensitive information for accessing CA Service Desk, access to the adapter files should be limited. Oracle recommends setting up a separate group (hereafter referred to as "the adapter group") that has permission to configure and run the CASD Adapter. Access to the adapter should not be allowed for anyone that is not a member of the adapter group.

Installing and Running the CASD Adapter on Unix

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

Installing the Adapter on Unix

To install the adapter on a Unix platform:

  1. Log in as a user that is a member of the adapter group. See Security Recommendations for more information regarding the adapter group.

  2. Create a directory where you want to install the adapter.

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

  4. Obtain a copy of the casd_adapter.jar file from the Management Server host system as specified in Exporting the Adapter Installation File, and copy it to the installation directory.

  5. Make sure the JAVA_HOME environment variable is set to the directory where Java 1.6 is installed.

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

    $JAVA_HOME/bin/jar xvf casd_adapter.jar

    This creates the adapters directory that contains the installation files.

    Note:

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

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

    cd adapters/endpoints/ca-usd

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

    sh ./install.sh

  9. When the script prompts whether you want to use HTTPS, answer Y (yes) or N (no):

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

    • If you specify N, the adapter is set up to use HTTP port number 8082.

  10. When the script prompts for the user name of the web service, enter the user name that must be provided to access the CASD adapter web service.

    Note:

    This user name is not associated with any CASD or system account. It can be any value that you choose. This user name will be used to restrict access to the adapter web service interface.

  11. When the script prompts for the password of the web service, enter the password that must be provided to access the CASD adapter web service.

    Note:

    This password is not associated with any CASD or system account. It can be any value that you choose. This password will be used to restrict access to the adapter web service interface.

  12. When the script prompts for the hostname/IP address of the CASD server, enter the host name or IP address of the system where the CASD server is deployed. The host name defaults to localhost if no value is provided.

  13. When the script prompts for the port number of the CASD server, enter the port number the CASD web server uses (Tomcat or IIS). The port number defaults to 8080 if no value is provided.

  14. When the script prompts for the user name to use when accessing CASD, enter the user name of the CASD account referenced in Prerequisites.

  15. When the script prompts for the password to use when accessing CASD, enter the password of the CASD account referenced in Prerequisites.

  16. After the script displays the message CASD Adapter Install Complete, press Enter to complete the installation.

  17. Enter the following command to change the working directory to the conf directory.

    cd adapters/conf

  18. Change the permissions on the framework.properties file to allow read, write, and execute permissions for the owner and the adapter group and no access for any other users.

  19. If the adapter was configured to run using the HTTPS protocol, you must perform the following steps:

    1. Install an SSL certificate in the adapter keystore. You must either install a self-signed certificate, or install a certificate obtained from a Certificate Authority (CA).

    2. Import the SSL certificate from the adapter keystore into the Enterprise Manager keystore. Perform the steps specified in Importing the Adapter Certificate into Enterprise Manager.

The adapter framework is now installed and ready to start.

Running the Adapter on Unix

To run the CASD Adapter framework commands listed with the following tasks, first change the working directory in the installation directory to:

adapters/bin

The following commands are available for running the adapter:

  • Start - ./service.sh start

  • Shut Down - ./service.sh stop

  • Restart - ./service.sh restart

  • Check Status - ./service.sh status

Testing the Adapter on Unix

To verify that the CASD Adapter 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. The test script prompts for the password information. At the prompt, enter the password that was configured for accessing the Adapter web service in step 11 of Section 2.4.2.1, "Installing the Adapter on Unix".

    For information on setting the user name and password, see Changing Web Service Credentials.

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

Installing and Running the CASD Adapter on Windows

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

Installing the Adapter on Windows

To install the adapter on a Windows platform:

  1. Log in as a user that is a member of the adapter group. See Security Recommendations for more information regarding the adapter group.

  2. Create a directory where you want to install the adapter.

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

  4. Obtain a copy of the casd_adapter.jar file from the Management Server host system as specified in Exporting the Adapter Installation File, and copy it to the installation directory.

  5. Make sure the JAVA_HOME environment variable is set to the directory where Java 1.6 is installed.

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

    "%JAVA_HOME%\bin\jar" xvf casd_adapter.jar

    This creates the adapters directory that contains the installation files.

    Note:

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

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

    cd adapters\endpoints\ca-usd

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

    .\install.bat

  9. When the script prompts whether you want to use HTTPS, choose Y (yes) or N (no):

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

    • If you specify N, the adapter is set up to use HTTP port number 8082.

  10. When the script prompts for the user name of the web service, enter the user name that must be provided to access the CASD adapter web service.

    Note:

    This user name is not associated with any CASD or system account. It can be any value that you choose. This user name is used to restrict access to the adapter web service interface.

  11. When the script prompts for the password of the web service, enter the password that must be provided to access the CASD adapter web service.

    Note:

    This password is not associated with any CASD or system account. It can be any value that you choose. This password is used to restrict access to the adapter web service interface.

  12. When the script prompts for the hostname/IP address of the CASD server, enter the host name or IP address of the system where the CASD server is deployed. The host name defaults to localhost if no value is provided.

  13. When the script prompts for the port number of the CASD server, enter the port number the CASD web server uses (Tomcat or IIS). The port number defaults to 8080 if no value is provided.

  14. When the script prompts for the user name to use when accessing CASD, enter the user name of the CASD account referenced in Prerequisites.

  15. When the script prompts for the password to use when accessing CASD, enter the password of the CASD account referenced in Prerequisites.

  16. Enter the following command to change the working directory to the conf directory.

    cd adapters\conf

  17. Change the permissions on the framework.properties file to allow read, write, and execute permissions for the adapter group and no access for any other users.

  18. After the script displays the message CASD Adapter Install Complete, press Enter to complete the installation.

  19. If the adapter was configured to run using the HTTPS protocol, you must perform the following steps:

    1. Install an SSL certificate in the adapter keystore. You must either install a self-signed certificate, or install a certificate obtained from a Certificate Authority (CA).

    2. Import the SSL certificate from the adapter keystore into the Enterprise Manager keystore. Perform the steps specified in Importing the Adapter Certificate into Enterprise Manager.

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

  1. Log into an account that has permission to add a Windows service.

    Note:

    On most systems, the account must be a member of the Administrators group to add a Windows service.

  2. Make sure the account has read and execute permissions for the adapters\bin directory.

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

  4. Enter the following command to install the adapter as a Windows service:

    service.bat install

  5. Make sure the designated login account for the Windows service has Full Control for the adapter directory and read and execute permissions on the conf\framework.properties file.

The adapter framework is now installed and ready to start.

Running the Adapter on Windows

There are two ways you can run the adapter on Windows: Standalone Service and Windows Service.

Standalone Service

To start the CASD adapter 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 CASD adapter framework, close the window where you started the adapter.

Windows Service

To start the CASD adapter framework when set up to run as a Windows service, run the following command:

net start iWaveAdapters

To shut down the CASD adapter framework, run the following command:

net stop iWaveAdapters

Testing the Adapter on Windows

To verify that the CASD Adapter 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. The test script prompts for the password information. At the prompt, enter the password that was configured for accessing the Adapter web service in step 11 of Section 2.4.3.1, "Installing the Adapter on Windows".

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

Uninstalling the Connector

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

To uninstall the connector:

  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.

    The confirmation window appears.

  9. Click OK.

Uninstalling the Adapter

This section describes the procedures for uninstalling the adapter on Unix and on Windows.

Uninstalling the Adapter on Unix

To uninstall the adapter on a Unix platform:

  1. Stop the adapter as specified in Running the Adapter on Unix.

  2. Delete the adapters folder from the adapter installation directory.

Uninstalling the Adapter on Windows

To uninstall the adapter on a Windows platform:

  1. Stop the adapter as specified in Running the Adapter on Windows.

  2. If the adapter is installed as a Window service, perform the following steps to uninstall the adapter as a service:

    • Open a command window and change the working directory to the adapters\bin directory in the adapter install directory.

    • Issue the command .\service uninstall

  3. Delete the adapters folder from the adapter installation directory.

Go to previous page
Previous		 Go to next page
Next
Go to Documentation Home
Home		 Go to Book List
Book List		 Go to Table of Contents
Contents		 Go to Feedback page
Contact Us