Installing in GUI mode

Use the instructions in this section to perform a new installation of OpenSwitch in GUI mode.

Mount and install the CD.

On HP-UX:
1. Log in as “root.”
2. Mount the CD:
```
/etc/mount -F cdfs -o ro, rr device_name /cdrom
```
  where:
  - device_name – is the CD drive.
  - /cdrom – is the directory where the CD is to be mounted.
3. Start the installer:
```
cd /cdrom
./setup
```
On IBM AIX:
1. Mount the CD:
```
/usr/sbin/mount -v 'cdrfs' -r device_name /cdrom
```
  where:
  - device_name – is the CD drive.
  - /cdrom – is the directory where the CD is to be mounted.
  The location of the mount command is site-specific, and might be different than what is shown in these instructions. If you cannot mount the CD drive using the path shown, consult your operating system documentation or contact your operating system administrator.
2. Start the installer:
```
cd /device_lname/cdrom
./setup
```
On Linux and Linux on POWER:
1. The CD mounts automatically if the automounter is running. Otherwise, enter:
```
$mount/dev/cdrom/mnt/cdrom
```
2. Start the installer:
```
/cdrom/setup
```
On Sun Solaris:
- The operating system automatically starts the installer.
  
  If the installer does not start automatically:
  - Enter the following commands to access the CD drive and start the installer:
```
cd /cdrom/cdrom0
./setup
```
  - If a window appears after you insert the CD, go to /cdrom/cdrom0 and double-click setup to start the installer.
If you get CD-reading errors, check your operating system kernel to make sure the ISO 9660 option is turned on.

If you downloaded the product from SPDC, go to the directory where you extracted the install image and start the installer:

./setup

On HP-UX, log out as “root” and log back on as “sybase” before starting the installer.

Click Next and choose your geographic location in the license and copyright agreement windows.

Select the geographical location where the software is being installed. The license agreement for that region displays.
Read the license agreement and select “I agree to the terms of the Sybase license for the install location specified.” You must agree to the license and copyright before you can continue.
Click Next.

In the Destination window:

Enter or select the directory where you want to install the product.

You can:
- Accept the default installation directory; or
- Enter the name of the root directory where you want to install OpenSwitch; or
- Click the Browse button to select the installation location.
Click Next.
If you enter a directory that does not exist, click Yes at the prompt to create the directory.

If the installation directory you selected exists, and contains a prior installation, InstallShield prompts you with the following message:
```
You have chosen to install into an existing directory. Any older versions of the products you choose to install that are detected in this directory will be replaced. 

Do you want to continue with installation into this directory?
```
Click Yes to install on top of the previous installation.

Select the type of installation to perform.

If you are installing in a high availability environment, see “Compatibility with other Sybase products” before selecting the installation type.

If you choose Typical, InstallShield installs the default components. This is recommended for most users.

The default components to be installed are:

OpenSwitch components

Connectivity – Open Client and Common Connectivity Components

Language Modules

Sybase Software Asset Management – SySAM License Server and SySAM License Utilities

Shared

OpenSwitch Administration Tools – Sybase Central and OpenSwitch Manager

If you choose Custom, select the components to install. Select this option only if you have a good knowledge of the interdependencies of Sybase and OpenSwitch products.
Click Next.
The Summary window displays:
- The installation directory
- The features to be installed
- The total size of the installation
Click Next to continue with the installation, or click Back to change the feature selection.
A progress bar shows the progress of the installation. When the installation completes, a message indicating successful installation is displayed.

If you are installing into an existing Adaptive Server Enterprise 15.0 installation directory, you may be asked if you want to overwrite certain Open Client/Server files.

If an existing file is newer or has the same date, select No. If an existing file is older, select Yes.

On successful installation, InstallShield displays the following message:
```
“The InstallShield Wizard has successfully installed OpenSwitch suite. Choose Next to continue the wizard.”
```
Click Next. The SySAM License Server window opens.
The Sybase Software Asset Management License Server window allows you to specify where OpenSwitch will find its licenses. Where you choose to store your license depends upon whether you have selected a served or unserved license model.

For more information about served and unserved licenses, see “Choosing a license model,” in Chapter 2,“Understanding Licensing Concepts and Models” in the Sybase Software Asset Management Users Guide.

You must specify whether the licenses will be obtained from a license server.

If you answer Yes, enter the following information:
- Host name – the name of the machine where the license manager is running
- Port number – if you have used a non-default port number
If you answer No, you will be using unserved licenses. You will be reminded to download and install the license file after you have finished the installation.

When you download the license file, copy it to $SYBASE/SYSAM-2_0/licenses.
The Sybase Software Asset Management Notification window prompts you to configure your server for e-mail notification. When configuration is enabled, you will receive information about license management events requiring attention.

Provide the following information:
- SMTP server host name
- SMTP server port number
- E-mail Return Address
- Recipient e-mail addresses
- Message severity that triggers e-mail messages
When the installation is successful and you click Next, the configuration tool window opens.
- To configure OpenSwitch now, click Next. Proceed to Chapter 3, “Configuring OpenSwitch.”
- If you do not want to configure OpenSwitch now, click Cancel. A prompt asks you to confirm that you want to terminate the configuration. Click Yes. Both the installer and configuration tool windows close.
  
  To configure the product later, see Chapter 3, “Configuring OpenSwitch.”
  
  If the installation was unsuccessful, use a text editor to open the installation log file, oswInstall.log, in the $SYBASE directory and troubleshoot what may have gone wrong.
Perform any post-installation steps. See Chapter 4, “Post-Installation Tasks,” for instructions.

Verifying the installation

You can verify whether the installation and configuration processes were successful. This procedure, however, does not verify whether OpenSwitch is running with your Adaptive Server. See “Verifying client connections” for instructions.

You cannot start OpenSwitch until it has been both installed and configured.

At the command prompt:
```
ps | grep OSwitch
```

You are now ready to start OpenSwitch. See “Starting OpenSwitch”.