This section describes the Admin GUI available for configuring the CMC software modem, and for monitoring CMC processing. The Admin GUI is an unsupported tool. If you choose to not use the GUI, see the Unwired Accelerator Installation Guide for command line procedures.
Using the CMC Admin GUI
To access the interface, open a Web Browser and enter this URL:
http://hostname.domain:port/dejima/admin/home.jsp
For example:
http://lab2k.sybase.com:4040/dejima/admin/home.jsp
Log in using masuper/m8super.
The Home page displays. The Home page displays these options:
Configure – configure the parameters for the selected configuration. See Table 5-2 for values.
Access Log – view and manage access logs for the selected CMC configuration. See “Displaying access logs”.
Whitelist – identify telephone numbers that are allowed access. See “Configuring CMC to allow access (whitelist)”.
Blacklist – identify telephone numbers that are denied access. See “Configuring CMC to deny access (blacklist)”.
From the Current Configuration drop-down list, select an existing configuration to modify an existing CMC configuration file, or select “Create a new configuration” to establish a new CMC configuration file.
Configure the parameters for the selected configuration. See Table 5-2 for values.
Save your configuration changes. If you are creating a new CMC configuration, supply a name.
Option name |
Description |
Default value |
|---|---|---|
accessChecker |
Fully qualified class name that implements the interface: com.sybase.cellmodem.AccessChecker |
com.sybase.cellmodem.BlackWhite ListChecker |
accessLog.File |
Name of the file where access log data is kept. |
None. If no file is specified, no access log is maintained. |
accessLog.Request |
Boolean valued property (true or false). If true, the request body from each message received will be recorded in the access log. |
true |
accessLog.Response |
Boolean valued property (true or false). If true, the response body sent back to uses is included in the access log. |
true |
accessLogger |
Full qualified class name that implements the com.sybase.cellmodem.AccessLogger interface. |
com.sybase.cellmodem.AccessLogger Impl |
baudrate |
Integer valued property. Specifies the bits per second communication rate to use with the serial port to which the modem is connected. |
9600 |
blacklistFile |
List of telephone numbers that are excluded from SMS service. When this list is specified and contains values, each message received is checked against the list. If the number is on the list, the message is not processed. |
None. The file should have at least one telephone number if used. |
config |
Name of a ResourceBundle or a java.util.Properties formatted file containing any of the command line options defined in this table. Any options specified explicitly on the command line take precedence over values contained in this file. |
com.sybase.cellmodem.CMCConfig The default package includes com/sybase/cellmodem/CMCConfig.properties file with default command line options. This file is packaged in the sybcmc.jar from which this entire package comes. |
databaseDriver |
Fully qualified class name of a java.sql.Driver implementation for connecting to a database. |
com.sybase.jdbc2.jdbc.SybDriver |
databasePwd |
Password to use when connecting to the database. |
SQL |
databaseURL |
JDBC URL to the database containing tables used by CMC. |
None. If this option is not specified, CMC does not attempt to connect to, or use any database. |
databaseUser |
User name to use when connecting to the database. |
dba |
httpAuthenticationURL |
When roleBasedAccess is true, and a user is trying to register their cell phone, Unwired Accelerator tests the user name and password against this URL. |
http://localhost:4040/dejima/protected/protected.jsp if you are using Tomcat. http://localhost:8080/dejima/protected/protected.jsp if you are using EAServer. |
httpURL |
This is the HTTP URL that the HTTPClientMessageHandler class sends requests to with the request body message. This is the access point for Answers Anywhere processing. The sms.jsp page looks for an optional RID=<N> query parameter, where <N> is the resource ID number. For example, http://machine.sybase.com:4040/dejima/sms.jsp?rid=211. If this is not specified, the default RID configured in uadejima.properties is used. |
http://localhost:4040/dejima.sms.jsp if you are using Tomcat. http://localhost:8080/dejima.sms.jsp if you are using EAServer. |
initDatabase |
Boolean property (true or false). If set to true and the databaseURL is specified, CMC tries to create the tables it uses in the database. This command line option is generally used only once to initialize the database. |
false |
instanceName |
This is the name by which this instance of the CMC process and its modem are known. When you have more than one CMC, you must give each a distinct name, so the configuration data is kept separate and the respective access logs can be distinguished. When CMC is using a database, this name is used in searches and inserts. |
DefaultName |
interval |
Integer valued property. Specifies in milliseconds how frequently CMC checks for new messages from the modem, and processes responses to return to users. |
15000 (every 15 seconds) |
logFile |
Name of the error log for the CMC process. The name can have a pattern, as described in java.util.logging.FileHandler constructors. |
CMC%g.log |
logLevel |
This determines the minimum severity level of messages that are placed in the log file. Valid values are described in java.util.logging.Level. |
WARNING |
messageHandler |
Fully qualified class name that implements the com.sybase.cellmodem.MessageHandler interface. |
com.sybase.cellmodem.HTTPClient MessageHandler |
modemDriver |
Fully qualified class name that implements com.sybase.cellmodem.CellModem interface. |
com.sybase.cellmodem.CService Wrapper |
roleBasedAccess |
Boolean property (true or false). true – CMC attempts to match a sender’s phone number to a registered cell number in the user.cell_phone column of the portaldatabase. If a match is found, the login_name for that user is passed as a parameter to the httpURL for the Web application to use in applying access control. false – role-based access is not used. |
false |
serialPort |
The name of the serial port to which the modem is connected. |
com1 |
simPin |
If the Subscriber Information Module (SIM) card in the modem requires a PIN to unlock it for use, specify that PIN with this property |
none |
smscPhone |
Usually a SIM card stores its own telephone number for the SMS Service Center it contacts to send SMS messages. To override this telephone number, enter it here. |
none |
whitelistFile |
List of telephone numbers that are allowed to use this SMS service. When this list is specified and contains values, each message received is checked against the list. If the number is not on the list, the message is not processed. |
None. The file should have at least one telephone number per line if used. |
maxResponseMessages |
For SMS messages that need to be parsed into 160 character message packages, indicates the maximum number of messages to send when splitting the response. |
1 |
configInterval |
Number of millisecond periods that CMC should check for configuration changes. |
0 (never) |
Configuring CMC parameters
Select the Configure option. The properties described in Table 5-2, and their values display in alphabetical order.
Click on a property value to view its configuration window. The configuration window provides:
Property Name - display only.
Description – provides a brief description, and the default value.
Property value – displays the current value.
In Property Value, provide the new value, and select Save to save the change and return to the list of properties.
You can also select Delete to restore the default value, or select Cancel to exit the configuration window and return to the list of properties.
Displaying access logs
The access logs enable you to monitor CMC processing of the Answers Anywhere user requests, and are a good troubleshooting tool.
Select the Access logs option. The first page of log file records display, from oldest to newest. Log file data includes:
Request date (RqDate) – date
and time the CMC received a user request, in the format YYYY.MM.DDTHH:MM:SS.
Response date (RsDate) – date and time
the CMC sent a response to the user, in the format YYYY.MM.DDTHH:MM:SS.
User/phone – the user’s
telephone number, in the format +15555551212.
Status – request sent by the user; for
example, Get quote for SY.
Request – request processed by CMC; for
example, Phone number +15555551212 is
not registered. If you would like to register it, send a message
with 3 lines: Registration <your username>,
and so forth.
Reply – response returned by CMC; for example, Denied.
You can:
Next – displays the next records in the log file.
Purge Logs to last date shown – trim the access log up to the currently displayed access records.
# Records – TBS
Purge all Access Logs – clear the log file of all records.
Configuring CMC to allow access
(whitelist)
Enables you to enter a list of telephone numbers that are allowed to use this SMS service. If used, each message received is checked against the list. Phone numbers that are not on the list are not processed.
Select the Whitelist option.
In User/phone, enter the telephone number in
the format 5555551212 (no punctuation),
and click Add. The number is added to the User/phone list.
You can also select Delete to remove a specific phone number, or select Remove All Users to remove all phone numbers in the whitelist file.
If you want to use the list, you must include at least
one phone number in the list.
Configuring CMC to deny
access (blacklist)
Enables you to enter a list of telephone numbers that are denied access to SMS service. If used, each message received is checked against the list. Phone numbers that are on the list are not processed. These options enable this feature:
accessChecker
blacklistFile
Select the Blacklist option.
In User/phone, enter the telephone number in
the format 5555551212 (no punctuation),
and click Add. The number is added to the User/phone list.
You can also select Delete to remove a specific phone number, or select Remove All Users to remove all phone numbers in the blacklist file.
If you want to use the list, you must include at least
one phone number in the list.
| Copyright © 2005. Sybase Inc. All rights reserved. |
|
|
