Jump to: navigation, search

If you use a Genesys computer-telephony integration (CTI) installation, you must install Advisors Genesys Adapter with CCAdv and WA applications. For Cisco installations, no adapter is required.

Deploying Cisco Adapter

You run a .jar installation file to deploy Advisors Cisco Adapter (ACA).

You can deploy ACA on a Red Hat Linux or a Windows platform, and with Oracle or MS SQL databases.

All database passwords used by the Cisco Adapter application are encrypted and saved in the ..GCTI\Advisors\CiscoConnector\conf\ cisco_adapter.properties file.

To change the password, see Change Encrypted Passwords.

Roadmap


  1. [+] Install the databases that correspond to the Advisors products you will deploy.
  2. Create the Advisors User and the Object Configuration User in Configuration Server. (Note that ACA itself does not require these users.)
  3. [+] Install the Platform service (Geronimo) on all servers on which you will deploy one of the Advisors components. (Note that ACA itself does not require Advisors Platform, but components that ACA serves require it.)
  4. Pma you-are-here-arrow.png Install each adapter you will use (AGA and ACA). See additional information for CCAdv/WA installations.
  5. [+] Install the Advisors components for your enterprise.
  6. Make any required configuration changes.

1. If you are deploying Advisors Cisco Adapter on a Linux system, you must first place the aca-installer-<version>.jar file into the Advisors home directory.
[+] Show Additional Information
2. Launch the installation file.
[+] Show Step for Linux
[+] Show Step for Windows
3. On the Server Install Type screen, the Install the service checkbox is selected by default. You can choose to start the service automatically by also selecting the Start the service checkbox. This is applicable to installations on Windows only.
4. On the Installation details screen, enter the installation directory for this deployment of Advisors Cisco Adapter. The default directory is C:\Program Files\GCTI\Advisors\CiscoAdapter, but you can specify a directory of your choice.

On this screen, you also specify the directory in which log files will go. The default log directory is C:\Program Files\GCTI\Advisors\CiscoAdapter\Log.

5. On the Java Development Kit screen, specify the root directory for your JDK installation by either entering it or by browsing to it with the Select Folder button.
6. On the Cisco Database Configuration screen, enter the information required for connecting to the databases.

In the Database server field, enter either the host name or IP address of the server. When using numerical IPv6 addresses, enclose the literal in brackets.

7. On the Database Type screen, select either the SQL Server or the Oracle option – whichever you use for databases in your installation. The screens that follow are dependent on your selection.
[+] Show Step for SQL Server
[+] Show Steps for Oracle
[+] Show Steps for Oracle RAC
8. On the Adapter Port and Registration Option screen, specify the ACA port number, and indicate if you want to register the ACA in the platform database or not.

You can use the default port, 7000, if no other application is using that port.
If you leave the Skip Registration checkbox empty (unselected), you must enter additional information about the adapter and about your Advisors platform database.

[+] Show Steps
9. On the Installation Progress screen, click Show Details, and then Install.
10. Verify that there are no errors during installation.
11. In the Services Control Panel applet, verify that an Advisors Cisco Adapter service is installed. If the option to start the service was selected earlier, the service’s status should be Started (applicable to installations on Windows only).

If you use a Linux platform, manually configure ACA to run automatically as a system service:

[+] Show steps

It is possible to deploy multiple instances of Advisors Cisco Adapter on a single server. Multiple Cisco Adapters can be installed to provide metrics from separate HDS/AWDB source environments.

For each installation, you will:

  • Create the database.
  • Install and configure the ACA core service. On the the Server Install Type screen, the Install the service checkbox is preselected; ensure the Start the Service check box is unchecked.

Deploy the second, and subsequent ACA instances, using the same procedure you use to deploy a single instance, and follow these rules:

  • You must install each Cisco Adapter instance in a different directory. For example, the first instance could use the following location:
    C:\Program Files\GCTI\Advisors\CiscoAdapter
    and the second instance could be located at:
    C:\Program Files\GCTI\Advisors\CiscoAdapter2.
  • You must specify a unique log directory and a unique data directory for each Cisco Adapter instance.
  • You must specify a unique port number for each Cisco Adapter instance.

Ignore the following error if it occurs during installation of additional ACA instances. The missing service will be installed in Step 1.
[exec] wrapper | CreateService failed – the specified service already exists. (0x431)

You must also edit the configuration file for each additional ACA core service deployment. After the adapter is installed, navigate to the \conf folder and follow the procedure below.

1. Locate and edit the wrapper.conf file:

  1. Search for the # Name of service string.
  2. Edit the parameter below it (wrapper.ntservice.name=) so that the service name is different from the original instance. For example, Advisors Cisco Adapter 2.
  3. Edit the next parameter (wrapper.ntservice.displayname=) so that the display name differs from the original instance. This is the name that will appear in the NT Services dialog. It is not necessary for it to match the name above.
  4. Save and close the file.
2. Navigate to the /bin folder of the second installation, and execute the Install-Adapter-NT.bat file to install the renamed service. You can then locate and start the service in the Services Control Panel applet.

The following Table shows parameter validation errors that you may encounter at the end of installation.

Installation Error Message Cause
[java] Failed to connect to the database using connection URL:

[java]
jdbc:sqlserver://192.168.xx.yy:nnn;DatabaseName=ys_cadb;user=sa;password=very_secure_pwd; selectMethod=cursor
[java] The following exception was thrown:
com.microsoft.sqlserver.jdbc.SQLServerException: The TCP/IP connection to the host 192.168.xx.yy, port nnn has failed. Error: "Connection refused. Verify the connection properties, check that an instance of SQL Server is running on the host and accepting TCP/IP connections at the port, and that no firewall is blocking TCP connections to the port.

Wrong database server name / IP address or port number
[java] Failed to connect to the database using connection URL:

[java]
jdbc:sqlserver://192.168.xx.yy:nnnn;DatabaseName=NotAPlatformDB;selectMethod=cursor;user=sa; password=very_secure_pwd
[java] The following exception was thrown:
com.microsoft.sqlserver.jdbc.SQLServerException: The TCP/IP connection to the host 192.168.xx.yy, port nnnn has failed. Error: "connect timed out. Verify the connection properties, check that an instance of SQL Server is running on the host and accepting TCP/IP connections at the port, and that no firewall is blocking TCP connections to the port."

Wrong database name
[java] Exception while connecting: Login failed for user 'badUserId'.

[java] url used:
jdbc:sqlserver://192.168.xx.yy:nnnn;DatabaseName=ys_cadb;selectMethod=cursor;user=badUserId; password=very_secure_password

Wrong database user name or password
[java] Exception in thread "main" java.security.InvalidParameterException: ERROR: Failed to verify validity of the JDK 1.6 located at /home/yevgeny/dev/java/j2sdk1.4.2_08.

[java] ERROR: Invalid JDK version found at /home/yevgeny/dev/java/j2sdk1.4.2_08, the version must be at least 1.6, but was 1.4
[java] at com.informiam.installer.jdk.JdkVersionChecker.checkJdk
(JdkVersionChecker.java:66)
[java] ERROR: Failed to verify validity of the JDK 1.6 located at /home/yevgeny/dev/java/j2sdk1.4.2_08.
[java] at com.informiam.installer.jdk.JdkVersionChecker.main
(JdkVersionChecker.java:81)

Wrong path to JDK or wrong version of the JDK specified.
Apr 11, 2011 3:53:46 PM oracle.jdbc.driver.OracleDriver registerMBeans

WARNING: Error while registering Oracle JDBC Diagnosability MBean.
java.security.AccessControlException: access denied (javax.management.MBeanTrustPermission register)
at java.security.AccessControlContext.checkPermission(Unknown Source)
at java.lang.SecurityManager.checkPermission(Unknown Source)
at com.sun.jmx.interceptor.DefaultMBeanServerInterceptor.checkMBeanTrustPermission(Unknown Source)
at com.sun.jmx.interceptor.DefaultMBeanServerInterceptor.registerMBean(Unknown Source)
at com.sun.jmx.mbeanserver.JmxMBeanServer.registerMBean(Unknown Source)
at oracle.jdbc.driver.OracleDriver.registerMBeans(OracleDriver.java:360)
at oracle.jdbc.driver.OracleDriver$1.run(OracleDriver.java:199)
at java.security.AccessController.doPrivileged(Native Method)
at oracle.jdbc.driver.OracleDriver.<clinit>(OracleDriver.java:195)

Produced in error and can be ignored.

Displays in the Errors tab when installing Cisco Adapter with Oracle JDBC driver ojdbc6-11.2.0.2.0, and accurately reports that installation was successful.

Exception in thread "AWT-EventQueue-0" java.lang.ArrayIndexOutOfBoundsException: 32

at sun.font.FontDesignMetrics.charsWidth(Unknown Source)
at javax.swing.text.Utilities.getTabbedTextOffset(Unknown Source)
at javax.swing.text.Utilities.getTabbedTextOffset(Unknown Source)
at javax.swing.text.Utilities.getTabbedTextOffset(Unknown Source)
at javax.swing.text.PlainView.viewToModel(Unknown Source)
at javax.swing.text.FieldView.viewToModel(Unknown Source)
at javax.swing.plaf.basic.BasicTextUI$RootView.viewToModel(Unknown Source)
at javax.swing.plaf.basic.BasicTextUI.viewToModel(Unknown Source)

Produced in error and can be ignored.
[loadfile] Unable to load file: java.io.FileNotFoundException: C:\ (The system cannot find the path specified) Produced in error and can be ignored.
This page was last modified on August 24, 2018, at 07:01.

Feedback

Comment on this article:

blog comments powered by Disqus