Sybase Technical Library - Product Manuals Home
[Search Forms] [Previous Section with Hits] [Next Section with Hits] [Clear Search] Expand Search

Chapter 10 Troubleshooting [Table of Contents]

Installation Guide Adaptive Server Enterprise for Windows NT

[-] Appendix A Alternative Installation Methods

Chapter 11

Alternative Installation Methods

Resource file installation

You can create an Adaptive Server or Backup Server, using values specified in a resource file that defines the attributes for the server.

Resource files are ASCII format template files that contain configuration variables. To use the template files, edit the resource file, replace variables with desired values, and execute the sybatch utility. The sybatch utility uses the variables to create servers.

Resource files allow you to create servers in batch mode. You can create servers on multiple systems from the same resource file by editing a few values in that file. Within a single resource file, you can create only one server at a time.

The server files must already exist on the computer before the servers can be created. Use procedures in Chapter 4, "Installing Sybase Servers ."

You cannot install Monitor Server, XP Server or the full-text search engine using resource files.

To install an Adaptive Server or Backup Server using resource files:

  1. Edit a resource file as described in "Installing from a resource file".

  2. Execute the sybatch utility, using the edited resource file as described in "Running the sybatch utility".

Installing from a resource file

You can install Sybase servers via a resource file. You can use either:

Editing a sample resource file

Sample resource files for creating Adaptive Server and Backup Server are included in your Adaptive Server distribution in:

%SYBASE%\%SYBASE_ASE\sample\server\sybatch_sample.res.

Edit the resource file using a text editor such as Windows Notepad. You might want to edit a copy of the file.

Note the following:

Resource file variables

Table A-1 lists the resource file variables. Before running the resource file, change all variables that start with "PUT-THE-*" with the corresponding value of the variable in Table A-1, or delete the value entirely.

Resource file variable values

Variable, "PUT-THE-"

Description

BOOT-DIRECTORY(sybinit)

The directory in which to install Adaptive Server, such as C:\sybase.

RELEASE-DIRECTORY(sybinit)

The Program folder for the screen icons.

PORT-NUMBER

The port number by which to identify Adaptive Server on the network, such as 5000.

NAME-OF-THE-SERVER

The Adaptive Server name. Example names include TEST, USE-DEFAULT, or any name up to 31 characters in length.

PATH-OF -YOUR-MASTER-DEVICE-HERE

The master device path name and file name, such as C:\sybase\data\master.dat.

SIZE-OF-YOUR-MASTER-DEVICE-HERE- MINIMUM-SHOULD-BE-30MB

The master device size, such as 30 for 30MB.

PATH-AND- NAME-OF-YOUR- SYBSYSTEMPROCS- DEVICE-HERE

The system procedures path name and file name, such as C:\sybase\data\sybprocs.dat.

SIZE-OF-YOUR-SYBSYSTEMPROCS- DEVICE-HERE-MINIMUM-SHOULD-BE-100MB

The size of the system procedures device, which stores the sybsystemprocs database, such as 100 for 100MB (default).

PATH-AND- NAME-OF-THE- ERRORLOG

The path in which Adaptive Server error logs are placed, such as C:\sybase\install\error.log.

CHARACTERSET (sqlsrv)

The character set used by Adaptive Server, such as CP 850.

CHARACTERSET (sybinit)

The character set used to install Sybase products, such as CP 850.

NAME-OF-THE-BACKUP-SERVER(default Backup Server)

The name of the default server to be used as a model to create the Backup Server. Example names include TEST_BS or USE-DEFAULT. If you specified a custom Adaptive Server name, add the extension "_BS" to the name.

NAME-OF-THE-BACKUP-SERVER(Backup Server)

The Backup Server name. Example names include TEST_BS or USE-DEFAULT. If you specified a custom Adaptive Server name, add the extension "_BS" to the name.

PATH-AND- NAME-OF-THE-BACKUP- ERRORLOG(Backup Server)

The path in which Backup Server error logs are placed, such as c:\sybase\install\backup.log.

PORT-NUMBER(Backup Server)

The port number by which to identify Backup Server on the network, such as 5001.

CHARACTERSET(Backup Server)

The character set used by Backup Server, such as CP 850.

PUT-THE-PATH-AND- NAME-OF-THE- MONITOR-ERRORLOG(Monitor Server)

The path in which Monitor Server error logs are placed, such as c:\sybase\install\ms.log.

PORT-NUMBER(Monitor Server)

The port number by which to identify Monitor Server on the network, such as 5002.

NAME-OF-THE-ADAPTIVE-SERVER(default Monitor Server)

The name of the default server to be used as a model to create Monitor Server. Example names include TEST-MS or USE-DEFAULT. If you specified a custom Adaptive Server name, add the extension "-MS" to the name.

NAME-OF-THE-MONITOR-SERVER(Monitor Server)

The Monitor Server name. Example names include TEST-MS or USE-DEFAULT. If you specified a custom Adaptive Server name, add the extension "-MS" to the name.

Running the sybatch utility

To run the sybatch utility using a resource file:

  1. Open a Command Prompt window.

  2. Enter:

    cd %SYBASE%\%SYBASE_ASE%\sample\server
    sybatch -r sybatch_sample.res

    where sybatch_sample.res is the name of the resource file.

When you have completed resource file installation, go to Chapter 5, "Post-Installation Tasks."

Installing files in NOGUI mode

To install components in a NOGUI environment, perform all pre-installation preparation steps as described; however, replace the window-based Studio Installer instructions (Chapter 4, "Installing Sybase Servers ") with these instructions.

There are several arguments you can use when you run Studio Installer from the command line. The syntax is:

setup.exe -argument

After you have installed the software, you can proceed with the installation of Adaptive Server in a noninteractive environment.

Complete the following steps:

  1. At the prompt, type:

    cd x:\
    .run.bat -nogui
    where x: is the letter of the CD-ROM drive.

  2. Select the type of install to perform.

  3. From the prompt, enter the installation directory (the default is c:\sybase ).

  4. Select one of the following:

  5. After installing the server components, restart the machine.

  6. The installer prompts: "Have you registered Sybase Software Asset Management Certificates at a central license host?"

    If Yes, enter the following information about the primary network node from which this machine will be checking out licenses:

For information on licensing features on the primary license host, see Chapter 3, "Sybase Software Asset Management (SySAM)."

Completing the installation process

  1. Follow the directions on the screen.

  2. The syconfig utility launches and the Configure Sybase Servers screen displays these options for Adaptive Server:

    For information about the syconfig utility, see the Adaptive Server Utility Guide for your platform.

  3. When you finish configuring the servers, exit syconfig and return to the Studio Installer.

    If you do not exit the utility, the Studio Installer is left in a suspended state.

  4. Check the installation log file to see a record of the installation process. The server log file is located in:

    %SYBASE%\Installer.log

    For the PC-client, the log file is in:

    %SYBASE%\Installer.log

Installing components in cmdfile

To install components by means of a cmdfile, you must begin in GUI mode. To begin the installation process:

  1. Verify that you are logged in with administrator privileges and that your environment is set up as described in the "Pre-installation tasks ".

  2. Insert the Server CD in the CD-ROM drive.

  3. The Studio Installer should start automatically. If it does not, select Start | Run, and enter:

        x:\setup.exe

    where x: is your CD-ROM drive.

    Do not use My Computer to locate and start the setup.exe file. Using this path may result in unexpected behavior.

  4. Select the type of installation to be performed. Backup Server, Monitor Server, and XP Server are installed, by default, with Adaptive Server.

  5. Select a new installation directory, or accept the default.

    If you select Customized Install, the next window is the Component Selection screen, which allows you to specify the components to install.

    Components that would be installed in a standard installation appear with a check in the check box to the left of the product name. You may select or deselect components from this list. Components with subcomponents have a More... button enabled. Click this button to select or deselect subcomponents.

  6. Click Save.

  7. Specify a directory. The component information is automatically generated when saving to the cmdfile. You may rename the cmdfile.

  8. After the information is written to the cmdfile, the installer returns you to the GUI. Click Cancel, then Yes, to exit the Studio Installer.

  9. To complete the installation using the cmdfile, go to a command-line prompt at the CD-ROM drive and enter:

    run.bat -f path/filename

    where path is the full path to the cmdfile, and filename is the name of the cmdfile.

  10. After the installation process, the system automatically restarts.

  11. Check the installation log file to see a record of the installation process. The server log file is located in:

    %SYBASE%\Installer.log

    The PC-client installation log file is in:

    %SYBASE%\Installer.log


Chapter 10 Troubleshooting [Table of Contents]