Chapter 2: Installation Procedures

Setting up Answers Anywhere for SMS

Answers Anywhere uses CellularModemController (CMC) software to communicate with your SMS provider. CMC acts as an interface between the SMS service and Unwired Accelerator. The CMC software can be located on the same machine as Unwired Accelerator, or can be moved to a different machine.

To configure CMC, modify the CMCConfig.properties file, using command line options. To run the configuration file, use the run command, and to list available commands, use the run -help command.

The CMCConfig.properties file is located in:

%SYBASE%\UnwiredAccelerator70\cmc\classes\com\sybase\cellmodem

If you want to move the CMC software to another machine, copy the CMCConfig.properties file to the new location.

If you set up multiple resources (RIDs) in Unwired Accelerator, you must configure a different instance of CMC for each resource. See the Unwired Accelerator Administration Guide for information about setting up resources.

Configuring the CMC at the command line

This section describes how to configure the CMC at the command line.

Configure CMC by entering commands and the command line in the following format:

-optionName optionValue

For example:

-baudrate 9600

See Table 2-4 for a partial list of commands. Use the run -help command to see a complete list of properties. See the Unwired Accelerator Administration Guide for more information and additional commands.

**Table 2-4: CMCConfig.properties file settings**
Option name	Description	Default value
accessLog.File	Name of the file where access log data is kept.	None. If no file is specified, no access log is maintained.
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.
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
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 rid 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
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
logLevel	This determines the minimum severity level of messages that are placed in the logFile. Valid values are described in java.util.logging.Level.	WARNING
roleBasedAccess	This is a Boolean property. true – CMC attempts to match a sender’s phone number to a registered cell number in the user.cell_phone column of the portal database. 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.

Use the run.bat file, located in %SYBASE%\UnwiredAccelerator70\cmc\, to execute the program from a Command Prompt window.
Check your configuration to make sure everything is set up correctly using this command from a Command Prompt window:
```
run -logLevel FINEST
```
The FINEST flag ensures you get the most output.

You can also look in the CMC0.log file, located in %SYBASE%\UnwiredAccelerator70\cmc\, to see if the software is communicating with your cell modem properly.

Common configuration problems include:
- Not specifying the correct serial Port (if your modem is not hooked up to COM1.
- Not specifying the correct baudrate that your device supports.

Configuring the CMC from the Admin GUI

An unsupported administrative graphical interface is also available for configuring CMC.

To access the interface, open a Web Browser and enter this URL:
```
http://hostname.domain:port/dejima/admin/home.jsp
```
where:
- hostname – is the name of the machine where you installed Unwired Accelerator; for example, “lab2k.”
- domain – is the domain name where the installation is located; for example, “sybase.com.”
- port – is the Unwired Accelerator port number (the default for Tomcat is 4040 and the default for EAServer is 8080). Use the port number you configured for UA.
For example:
```
http://lab2k.sybase.com:4040/dejima/admin/home.jsp
```
Log in using masuper/m8super.
Configure the parameters, whitelist, and blacklist for your configuration. See Table 2-4 for values.
Save your configuration.

See the Unwired Accelerator Administration Guide for more information about the Admin GUI.

Setting up CMC as a Windows service

This section describes how to set up CMC as a Windows service, so it runs automatically.

Navigate to:

%SYBASE%\UnwiredAccelerator70\cmc\conf
Open the wrapper.conf file in a text editor.
Search for the wrapper.java.command property, and modify the path to point to your Java installation. For example, if you installed Unwired Accelerator in %SYBASE%\UnwiredAccelerator70, set the property to:
```
wrapper.java.command=%SYBASE%\UnwiredAccelerator\jdk1.4\jre\bin\
java
```
Save and close the wrapper.conf file.
Navigate to:

%SYBASE%\UnwiredAccelerator\cmc\bin
Execute the InstallCMC script. This creates a Windows service named SMSCellModemController that starts automatically when you reboot Windows.
Execute the command net start SMSCellModemController to start the service, or use the Services console from Windows Explorer.

Registering the SMS modem with Unwired Accelerator

Each user must register the SMS modem number with Unwired Accelerator, by sending an SMS text message that includes user name and password to the SMS modem number. To do so:

Obtain the SMS modem number.
Send an SMS text message with these three lines to the SMS modem number, substituting your Unwired Accelerator user name and password:
```
Register
<user name>
<password>
```
The user name and password values are entered in the portaldatabase table “users,” and the SMS modem number is entered in the “cell_phone_number” column.

If role-based access is used (see Table 2-4 for information about the roleBasedAccess property), the CMC software checks the request to see whether the phone number for the requesting user is registered. If the number is not registered, the user is prompted to register it.

View this book as PDF