Performing a Custom Installation of Developer Edition

Perform a custom installation to install a custom configuration of Unwired Platform on a single server, or to add components to an existing installation of Unwired Platform. The existing installation can be a single server setup or any node in a cluster setup.

Prerequisites

Going through the appropriate task flow in Developer Edition Task Flows, you should have performed these tasks:

Download a license file. See Obtaining a License.
Verify the installation prerequisites. See System Requirements for Unwired Platform.
Verify that you are logged in with administrative rights.
Install Adobe Flash Player 9.0.124+ or FP10.x (recommended).
If you are planning to use an existing Eclipse 3.5 installation, follow the steps in Additional Steps to Use an Existing Eclipse Installation.
Shut down any Sybase products, Sybase processes, and associated third-party processes that are currently running on the server where you are now installing. This includes any database servers, OpenDS server, and Sybase Control Center.
Due to a NetBIOS limitation, make sure the host name is fewer than 15 characters. See the Microsoft Help and Support article Naming Conventions in Active Directory (909264).
If you need to use a Developer Edition via Remote Desktop Connection (RDC), Terminal Services, or similar remote access technology, you cannot use unserved licenses. You must generate served licenses and use a license server. Virtual machines (VMs) that are not locally hosted typically require RDC, so also require served licenses. If installing on a VM with an unserved license, you must use console 0 to access the VM to perform the installation.

Note: If the installer detects an existing installation of Unwired Platform, it takes you directly to the component selection screen after you complete the end user license agreement. There you can select additional components to install. To uninstall any components that are already installed, must completely uninstall Unwired Platform.

Start the Sybase Unwired Platform installer using one of these methods:
- Insert the Sybase Unwired Platform installation media.
- Install from a Web download. Extract the four archives to the same temporary directory on a local disk, not a shared drive.
- Install from an image on the network. You must access the installation image from a mapped drive, not a UNC path.
1. If installing from installation media, select Start > Run.
2. Browse to the location of the setup.exe file on the installation media or in the temporary directory, and click OK.
On the installer welcome page, click Next.

On the license type page, select your license type and click Next.

Option	Description
Evaluation	Allows you to evaluate Unwired Platform for 30 days. A license file is not required.
Unserved (local) license	A standalone license managed locally by your workstation. Be sure you know the location of the license file.
Served (remote) license	A standalone license managed by a license server. Be sure you know your license manager host name and TCP port.

On the end-user license agreement page, accept the terms of the license agreement.
1. Select the appropriate geographic location and read the license agreement.
2. Click I Do Agree to the Terms of the Sybase License, for the Install Location Specified, then click Next.

On the license details page, select the information for your product license. See Locating Information in a License File.

Field	Valid values
License product edition	ED: Enterprise Developer Edition PD: Personal Developer Edition
License type	If you selected ED for license product edition, license type must be DT: Development and Test License. If you selected PD for license product edition, then license type must be SS: Standalone Seat License.

Field

Valid values

License product edition

ED: Enterprise Developer Edition
PD: Personal Developer Edition

License type

If you selected ED for license product edition, license type must be DT: Development and Test License.

If you selected PD for license product edition, then license type must be SS: Standalone Seat License.

Note: If you enter a combination of values on this page that does not match your license file, the error is not detected until the installer attempts to check out your license on the next page.

Enter your license information.
If you selected "Unserved (local) license" as the license type, on the unserved license file page enter the full path to the license file. Click Browse to browse to the file location.

If you selected "Served (remote) license" as the license type, on the SySAM license manager server page enter the Host Name of License Server and, optionally, change the TCP Port of License Server entry.

If you see a Failed to check out license error, and you think you may have entered license settings that do not match your license, click OK, then click Back to reenter the license settings.
On the installation directory page, accept the default installation directory or choose a different one.
- If the directory does not exist, click OK to create it.
- For best results, use English or Western European characters (cp1252/ISO-8859-1) for the installation directory path and directory names.
- You can use the underscore or hyphen character, but do not use symbols or spaces in the installation directory name.
Note: The directory path where Sybase Control Center is installed varies. If the SYBASE environment variable is defined and valid, Sybase Control Center installs in the directory path specified by the variable. Otherwise, Sybase Control Center installs in a sibling directory to the installation directory specified here. For example, if the installation directory is C:\Sybase\UnwiredPlatform, Sybase Control Center installs into C:\Sybase\SCC-3_0.
On the installation type page, select Custom and click Next.
On the component selection page, select the specific Sybase Unwired Platform components to install, then click Next.
A page that says, "One or more required components (prerequisites) are not installed on the system," indicates that the installer has detected missing third-party software.
Click:
- Next to have the installer install the required software.
- Back to select components to install that do not require the third party software.
- Cancel to cancel the current installation.
(Optional) Select additional installation options. The available options on the additional installation options page depend on the selections you made on the component selection page; you may not see all of the options listed below. Choose:
- Configure Unwired Platform communication ports to change default port numbers.
- Set Unwired Platform services to start automatically to start Unwired Platform services automatically when Windows starts. If Unwired Platform services are not set to start automatically, you must manually start these services from the Windows Start menu.
  Note: Set Unwired Platform services to start automatically if you plan to install products that work with Unwired Platform, such as Sybase SAP® DOE Connector and Sybase Mobile Sales for SAP® CRM. If Unwired Platform services do not start automatically, these product installations will encounter problems.
- Configure data tier to change default port numbers for the data tier or to install data tier into a high availability environment. This option appears only when you install the data tier without Unwired Server.
- Install Device Application Designer to install this developer component. This option is only available if Unwired WorkSpace is selected to install. If Unwired WorkSpace is already installed, this option is only available from the component selection page.
- Install Windows Mobile .NET Components to install this developer component. This option is only available if Unwired WorkSpace is selected to install. If Unwired WorkSpace is already installed, this option is only available from the component selection page.
- Use an existing JDK or Eclipse Installation for use with Sybase Unwired Platform to indicate the fully qualified path to an existing JDK or Eclipse installation directory. Sybase Unwired Platform requires JDK 1.6.0_16 and Eclipse 3.5.0. (Eclipse option available only if Unwired WorkSpace is selected.)
  Note: On 64-bit systems, specify the fully qualified path to an existing 32-bit JDK installation.

If you selected either Unwired Server or Data Tier, but not both, on the component selection page, on the cluster configuration information page enter the information necessary to access the data tier in a cluster.

Option	Description
Cluster Configuration Password	Enter the password used by the cluster administrator to configure the cluster.
Confirm Cluster Configuration Password	Reenter the cluster configuration password.
UNC path to shared data folder Note: This field appears only when you are installing Unwired Server without the data tier	Universal naming convention path to the shared data folder. This folder must already exist, with the data tier installed and be shared to your network with write privileges. If the data tier is installed in the default installation directory on its host, the local path would be C:\Sybase\UnwiredPlatform\Data. You would share this directory to your network. If you share this directory with the name `Data`, and the computer where you are installing is named `myserver`, the UNC path would be \\myserver\Data.

Option

Description

Cluster Configuration Password

Enter the password used by the cluster administrator to configure the cluster.

Confirm Cluster Configuration Password

Reenter the cluster configuration password.

UNC path to shared data folder

Note: This field appears only when you are installing Unwired Server without the data tier

Universal naming convention path to the shared data folder. This folder must already exist, with the data tier installed and be shared to your network with write privileges.

If the data tier is installed in the default installation directory on its host, the local path would be C:\Sybase\UnwiredPlatform\Data. You would share this directory to your network.

If you share this directory with the name Data, and the computer where you are installing is named myserver, the UNC path would be \\myserver\Data.

On the Windows account page, enter the information for the Windows account under which Sybase Unwired Platform will run.

Note: The user should be a domain user. If you are installing in a cluster, enter the exact same information on this page as you install on each node. A local account can also be used in installing in a cluster, as long as that account has read/write access to the shared data folder on the data tier machine.

Option	Description
Windows Account Name	Use the form, `<Windows_domain>`\`<login_id>` or `<login_id>`, for example, `sybase\jdoe`, or `jdoe`. Domain name is optional. The account must exist on the local machine and have administrator privileges.
Windows Account Password	Enter the password for the account.
Confirm Windows Account Password	Reenter the password for the account.

Option

Description

Windows Account Name

Use the form, <Windows_domain>\<login_id> or <login_id>, for example, sybase\jdoe, or jdoe. Domain name is optional.

The account must exist on the local machine and have administrator privileges.

Windows Account Password

Enter the password for the account.

Confirm Windows Account Password

Reenter the password for the account.

If you selected Data Tier without Unwired Server on the component selection page, and you selected Configure Data Tier on the additional install options page, on the port numbers for data tier page enter port numbers and, optionally, specify a high availability environment:

Option	Description
Database Server	Port number for the data tier that manages transactions between the enterprise information system and mobile devices. The default is 5200.
Messaging Server	HTTP port for the messaging configuration Web service, used by Sybase Control Center to perform deployment and administration tasks related to the Unwired Server messaging server and devices, and workflow application. The default is 6262.
Afaria Database	The Afaria Server database port number. The default is 4343.
Install Data Tier into high availability environment	Select this option to install the data tier in a Microsoft cluster. The next two fields appear only when you select this option. For more information on using a Microsoft cluster with Unwired Platform, see System Administration for Sybase Unwired Platform > Systems Design > Clustered Environments > Implementing an N+2-node Cluster for Optimal Redundancy.
Enter a path to Microsoft cluster setup	Enter the location of the high availability Microsoft cluster, beginning with a drive letter. Note: This cannot be a UNC path. If the high availability data location is on a different server, map a path to that server as a network drive and use the mapped drive letter in the path you enter here.
Enter a name for database server	Enter the name to be used for the data tier server in the Microsoft cluster. Note: The data tier server is renamed to `<name_you_enter_here>`. The Afaria database server is renamed to AFDB_`<name_you_enter_here>`.

If you selected Unwired Server without Data tier on the component selection page, on the information for the data tier page, enter the information for your data tier installation.

Option	Description
SQL Anywhere 11.0.1 database
Host Name	The name of the machine on which the database server is running. Enter this name with capitalization exactly as it is defined in the Windows network environment.
Port Number	Port number that the database server uses on the host machine.
Login	The account login for database administrator for the data tier. Warning! Do not change the "dba" default unless you have changed the database administrator account.
Password	The account password for the database administrator for the data tier. Warning! Enter the "sql" default password, unless you have changed the password for the database administrator account.
Consolidated database
Database Name	The SQL Anywhere database name for the consolidated database. Warning! Do not change the default name from "default" unless you have changed the database name after you installed the data tier, or you are using a SQL Anywhere installation where this database has a different name.
Cluster database
Database Name	The SQL Anywhere database name for the cluster database. Warning! Do not change the default name from "clusterdb" unless you have changed the database name after you installed the data tier, or you are using a SQL Anywhere installation where this database has a different name.
Monitoring database
Database Name	The SQL Anywhere database name for the monitoring database. Warning! Do not change the default name from "monitordb" unless you have changed the database name after you installed the data tier, or you are using a SQL Anywhere installation where this database has a different name.

(Optional) If you selected "Configure Unwired Platform communication ports" on the additional installation options page, you can change port numbers as required, on the port numbers for Unwired Server page.

Option	Description
General
Server Administration	Standard Internet Inter-ORB Protocol (IIOP) port used by Eclipse and Sybase Control Center to connect to Unwired Server for deployment and administration tasks. The default is 2000. To change the port number after installation, use Sybase Control Center (administration console).
Data Change Notification	HTTP port used for data change notification (DCN). The default is 8000.
Synchronization
Messaging	The port used for messaging clients to communicate with Unwired Server's messaging server, to synchronizes data between the enterprise information system and messaging-based mobile devices. The default is 5001.
Replication	Port number on which Unwired Server synchronizes data between the enterprise information system and replication-based mobile devices. The default is 2480.

If you selected both Data Tier and Afaria Server on the Component Selection page, on the port numbers for device management page, enter the Afaria server port number (default is 4041).

If you selected Afaria Server on the component selection page, but did not select Data Tier on that page, enter server and port information on the port numbers for device management page.

Option	Description
Afaria Server	The Afaria server HTTP port number. The default is 4041.
Host Name	The host name of the machine on which the data tier is installed, where the Afaria database service is running.
Port Number	Port number the Afaria database service on the data tier host machine. The default is 4343.
Server Name	The name of the existing data tier server that the Afaria server is to use. The default is AFDB_`<datatier_hostname>`.
Login	The account name used to log in to the database. The default is dba.
Password	The password for the database login. The default is SQL.

On the summary information page, verify the installation features and click Install.
(Optional) Click View Release Bulletin.
Click Finish.

Next

Perform postinstallation tasks for your installation. See Postinstallation Tasks.