![]() | ![]() |
Home |
|
|
Installation Guide Adaptive Server Enterprise for Windows NT |
|
| Appendix A Alternative Installation Methods |
Chapter 11
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:
Edit a resource file as described in "Installing from a resource file".
Execute the sybatch utility, using the edited resource file as described in "Running the sybatch utility".
You can install Sybase servers via a resource file. You can use either:
The sample resource file provided with the software, or
The resource file the created by the sybatch utility.
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:
If you use USE-DEFAULT as the Adaptive Server name, the utility substitutes the name of the computer on which it is running for the server name. If you use USE-DEFAULT, do not create Backup Server entries in the resource file. They are created automatically using the default name.
To create a server with a different name, change the Adaptive Server name and use the new name with the "_BK" extensions for Backup Server. For example, the Backup Server for PIANO should be PIANO_BK.
The master device size must be at least 30MB.
The system procedure device and sybsystemprocs database sizes must be at least 100MB.
The auditing entries in the resource file are not supported and will not be processed by the utility. To enable auditing, see Configuring Adaptive Server Enterprise.
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.
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. |
To run the sybatch utility using a resource file:
Open a Command Prompt window.
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."
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
-debug:
Use this argument to display output normally sent to the Installer.log.
-f filename
Use this argument to provide the file name of the file that contains all the input you want to use for a silent installation.
Before using this argument, you must create a file containing all the installation inputs (target directory, components to be installed, and so on).
-c
Use this argument run the installer without the graphical user interface. The Studio Installer prompts the user for the required user input.
-trace
Use this argument to print more detailed information to the Installer.log, which is useful for tracking abnormal executions of installations.
-version
Use this argument to obtain version information for the installer. Do not use any other arguments when using this argument.
After you have installed the software, you can proceed with the installation of Adaptive Server in a noninteractive environment.
Complete the following steps:
At the prompt, type:
cd x:\ .run.bat -noguiwhere x: is the letter of the CD-ROM drive.
Select the type of install to perform.
Full Install
Standard Install
Cancel
From the prompt, enter the installation directory (the default is c:\sybase ).
Select one of the following:
Continue - to continue.
Previous Menu - to return to the previous screen.
Cancel - to terminate the installation procedure.
After installing the server components, restart the machine.
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:
License Manager Host is the host name of the primary network node on which you installed the asset management software.
License Manager Port is an unused port number on the primary network node. The local Adaptive Server uses this port number to contact the primary network node when checking out licenses.
For information on licensing features on the primary license host, see Chapter 3, "Sybase Software Asset Management (SySAM)."
Follow the directions on the screen.
The syconfig utility launches and the Configure Sybase Servers screen displays these options for Adaptive Server:
Create Adaptive Server (see Chapter 4, "Installing Sybase Servers ").
Configure Adaptive Server (see Chapter 4, "Installing Sybase Servers ").
Remove Adaptive Server (see Chapter 5, "Post-Installation Tasks").
Upgrade Adaptive Server (see Chapter 8, "Upgrading Sybase Servers ").
For information about the syconfig utility, see the Adaptive Server Utility Guide for your platform.
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.
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
To install components by means of a cmdfile, you must begin in GUI mode. To begin the installation process:
Verify that you are logged in with administrator privileges and that your environment is set up as described in the "Pre-installation tasks ".
Insert the Server CD in the CD-ROM drive.
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.
Select the type of installation to be performed. Backup Server, Monitor Server, and XP Server are installed, by default, with Adaptive Server.
Standard Install - a standard install installs all the components necessary for most users.
Full Install - a full install installs every component on the CD.
Customized Install - a customized install allows you to select which components to install. Certain components are automatically installed if they are required to run other selected components.
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.
Click Save.
Specify a directory. The component information is automatically generated when saving to the cmdfile. You may rename the cmdfile.
After the information is written to the cmdfile, the installer returns you to the GUI. Click Cancel, then Yes, to exit the Studio Installer.
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.
After the installation process, the system automatically restarts.
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
|
|