Problem: After installation, Listener could not be started, or Service could not be started messages appear.
Explanation: This may indicate your Sybase Unwired Platform configuration includes duplicate port numbers. This can happen for a variety of reasons; for example, if an application or service is offline during the installation process, the installer does not detect the reserved port number.
Solution: Change the Sybase Unwired Platform component port numbers as needed post-installation, using information in Port Number Reference.
Sybase Control Center Could Not be Started
Problem: After installation, Sybase Control Center could not be started. The agent bootstrap thread logs error messages in agent.log such as the ones below. In case of a port conflict on the RMI agent port (default 9999) or the Repository DB port (default 3638), the Sybase Control Center service startup fails.
RMI Agent:
[Agent Bootstrap Thread] - Failed to start rmi registry.
Messaging:
[Agent Bootstrap Thread] - Messaging provider failed to fully start.
Web Container:
[Agent Bootstrap Thread] - failed....java.net.BindException: Address already in use: JVM_Bind
Repository DB:
[Agent Bootstrap Thread] - Failed to connect to dataserver engine.
Explanation: This error can occur for a variety of reasons; for example, if an application or service is offline during the installation process, the installer does not detect the port number is in use.
Solution: Change the Sybase Control Center component port number as needed post-installation, using information in Port Number Reference.
Troubleshoot the System
Port Number Reference
Change Sybase Unwired Platform component port numbers after installation, if necessary.
Proceed with caution when changing port numbers because the change might impact other configuration files that point to that port. You need to be aware of the default Sybase Control Center port numbers so you do not accidentally use these ports when you change Unwired Platform ports. You can change some Sybase Control Center default ports, but, in some cases, you should not.
Note: To make Unwired Server port number changes, temporarily stop the other service consuming those ports. Use Sybase Control Center to make the changes, then restart Unwired Server.
Note: Port numbers 5701, 5702, and 5011 should be reserved ports.
Port Description Default
Port
Instructions for Changing
Data tier (CDB) server
Port number for the da-ta tier that manages transactions between the enterprise informa-tion system and mobile devices.
5200 Do not change the CDB port.
Management
Default is recommended. No change is required.
HTTP ports HTTP port number on which Unwired Server
Configure in Sybase Control Center by selecting Configuration, clicking the Web Container tab and entering a new DCN port or secure DCN port, as re-quired.
See Configuring Security Profiles in Syb-ase Control Center for SybSyb-ase Unwired Platform online help.
Troubleshoot the System
Port Description Default
Configure in Sybase Control Center by selecting Configuration. In the Compo-nents tab, select Replication or Messag-ing, click Properties and enter a new synchronization port, as required.
Note: If there is a conflict for port 2480 or 2481, Unwired Server will not start, and you cannot use Sybase Control Center to modify them. To correct the problem, you must temporarily stop the service that uses the conflicting port, then start Un-wired Server.
For replication payloads, see Configuring Replication Subscription Properties in Sybase Control Center for Sybase Un-wired Platform online help.
For messaging payloads, see Configuring Messaging Properties in Sybase Control Center for Sybase Unwired Platform on-line help.
Cannot be changed in Sybase Control Center.
Use the SUP_HOME\Servers
\Messaging Server\Bin
\AdminWebServices-Tool.exe command line tool to change the messaging service Web serv-ice port. This tool has built in online help describing how to use the tool. From the command prompt run:
Port Description Default numbers of which to be aware, when
• 9999 – default RMI agent port. The port is set in:
SCC_HOME\services\RMI
\service-config.xml
• 2100 – default JMS messaging serv-ice port. The port is set in:
SCC_HOME\services\Mes- saging\service-con-fig.xml
• 3638 – default Sybase Control Center repository database port. The default port is set in:
SCC_HOME\services
\SccSADataserver\serv-ice-config.xml
• 8282, 8283 – default Web container ports. The default ports are set in:
SCC_HOME\services\Em-beddedWebContainer
\service-config.xml Before you make any changes to these files, stop Sybase Control Center X.X service. Start the service after you com-plete the changes. If any of the subsys-tems fail to start, check the Sybase Con-trol Center agent.log for error mes-sages.
Relay server Port numbers on which Relay Server listens for
Change the value for the cluster in Sybase Control Center for Unwired Platform.
You can then generate the file and transfer it to the corresponding Unwired Server host.
See Setting Relay Server General Prop-erties in Sybase Control Center for Syb-ase Unwired Platform.
Troubleshoot the System
Port Description Default for internal use by Un-wired Platform
Do not use these special port numbers for any purpose. These ports differ from Windows reserved ports (1-1023).
Note: Even if the installer does not detect a conflict at install time, Windows may later use ports in the 1024-64K range for other purposes. Read Microsoft docu-mentation to determine how to reserve Unwired Platform ports. Otherwise, you may experience intermittent problems when starting up platform services due to Windows using these ports for some other purpose at the same time.