Connecting to Adaptive Server

The Connect dialog allows you to find the servers and connect to them.

Connecting to a server

1. Enter your User ID and Password in the appropriate fields.

2. Specify how you want to connect to the server. You can

   • Select a server from the server name dropdown list.

   • Enter the host name and port number separated by a colon.

   • (Optional) enter the character set and language you want to use to connect to this server by entering the values in the Character set and Language fields.

   The server name dropdown list contains server names from your interfaces file, including servers you configured to use an LDAP server from your interfaces file and the LDAP server you configured.

   Lightweight Directory Access Protocol (LDAP) is an industry standard for accessing directory services. Directory services allow components to look up information by a distinguished name (DN) from an LDAP server that stores and manages server, user, and software information that is used throughout the enterprise or over a network.The LDAP server can be located on a different platform from the one on which Adaptive Server or the clients are running. LDAP defines the communication protocol and the contents of messages exchanged between clients and servers.

   To retrieve server names using LDAP:

   1. Select the LDAP tab from the Settings button.

   2. Select Retrieve ASE entries.

3. Click Find to discover additional servers on the network.These servers are monitored by Unified Agents that support the JINI (the default) and UDP protocols.

   To configure the search for additional servers:

   1. Select Tools | Adaptive Server Enterprise | Preferences.

   2. Select the Server Discovery page.

   3. Select Add to add a new setting.

      Edit or remove existing settings using Edit and Remove buttons. The settings are used in the order they are listed. Rearrange the settings with the Up and Down buttons

4. Select the server to which you want to connect and then click OK.

5. Click OK in the Connect dialog box to connect to the server.

Using filters to limit the search scope

You can use filters to limit the scope of your server discovery search so that only certain Adaptive Servers that match a set of rules are displayed. For example, you can create a filter to show only Adaptive Servers built in the last 12 months.

The Plug-in shows what filters are enabled on the Server Discovery tab. To add or edit a filter, click the Filter button. The Plug-in displays the Server Discovery Filters dialog box, which lists the current filters. You can enable or disable filters, but Server Discovery only uses the enabled filters for its search. The Server Discovery Filter dialog box includes these buttons:

• Add – Add a new filter

• Remove – Remove a listed filter

• Edit – Edit a listed filter

• Enable All – Enable all listed filters

• Disable All – Disable all listed filters

Filters are comprised of a Target (a server attribute) and a Condition (a search condition). To add a new filter:

• Click Add. The Plug-in displays the Add Filter dialog box.

• If you want this filter enabled, select Enable this filter.

• Select the target you want filtered from this list (the Name target shows by default. The available targets are: Host, Name, OS, Platform, Port, Release type, Status, Version.

• Select the condition you want filtered from the list (the “does not contain” condition shows by default). This available conditions are: contains, does not contain, is, is not, starts with, ends with.

• Enter the condition string you want filtered.

• Select OK to configure this filter.

Using SSL

SSL (Secure Socket Layer) is the standard for securing the transmission of sensitive information. To connect to Adaptive Server with SSL, manually import Adaptive Server’s certificate using the Java keytool utility. keytool is part of the JRE, and is located in the JRE directory. For examples, on Windows platforms it is located under %SYBASE_JRE%\bin.

keytool output looks similar to:

> keytool -import -file trusted.txt
Owner: CN=sybase _ca, OU=DST, O=Sybase, L=Emeryville,
ST=California, C=US Issuer: CN=sybase _ca, OU=DST,
O=Sybase, L=Emeryville, ST=California, C=US
Serial Number: 0
Valid from: Tue Dec 12 10:13:09 GMT+08:00 2000 ?: 
Fri Dec 10 10:13:09
GMT+08:00 2010
Certificates Fingerprints:
      MD5:
ED:0E:D5:58:82:52:8B:03:D2:B3:82:A4:C6:F6:1E:2F
      SHA1:
B0:8B:F0:91:C6:75:57:A5:D0:28:9C:9D:90:49:48:A2:A5:AD:
35:0F 

The interfaces entry must contain an SSL filter if Adaptive Server is SSL-enabled. For example, if an Adaptive Server called HRDPT listens on port 6666 through SSL, the interfaces entry would look similar to:

[HRDPT]
master=TCP,hrhost,6666,ssl
query=TCP,hrhost,6666,ssl 

If you use host name and port number "hrhost:6666" to connect to Adaptive Server, click Details to view additional fields and check the SSL box before you connect.

Entering connection parameters

The Advanced tab of the Connect dialog allows you to enter additional connection parameters. Enter one connection parameter per line.

name=value 

The following connection parameters set connection host name information to “my_host.sybase.com” and limit the number of rows returned from the server to 50.

SQLINITSTRING=SET ROWCOUNT 50
HOSTNAME=my_host.sybase.com 

---

Copyright © 2008. Sybase Inc. All rights reserved.