This documentation applies to the 8.1 version of BMC Atrium Core, which is in "End of Version Support." You will not be able to leave comments.

To view the latest version, select the version from the Product version menu.

Preparing Sybase before you upgrade the AR System server

This section describes the steps you should perform with your Sybase database before you install BMC Remedy AR System or any application in the BMC Remedy IT Service Management Suite.

These steps are usually performed by a user who has database administrator privileges.


If you try to install the BMC Remedy AR System server on top of Sybase 15.0.2/EBF 14328, the installation might fail. You will receive this error message:
Failure during SQL operation to the database : Incorrect syntax near the keyword 'path'.
For troubleshooting information, see Sybase error 156 in your Sybase documentation and BMC Remedy AR System error message 552.

To prepare your Sybase database

  1. Install the Sybase database.
    You can install the Sybase database on the same computer where the BMC Remedy AR System is installed, or on a remote server that is networked to the computer where you plan to install BMC Remedy AR System.


    A warning message with the names and paths of the dummy devices is displayed during the installation procedure (after the Database File Input Panel is displayed). You must manually delete these dummy devices after the installation procedure is complete.

  2. Install Sybase clients.
    For remote installations, install the Sybase clients on the same computer as the BMC Remedy AR System server.
  3. From the directory where the 64-bit Sybase client is installed, source the database.
  4. Make sure that the TCP/IP Protocol for the database is enabled.
  5. Verify or set the DSQUERY and SYBASE environment variables as follows:
    DSQUERY=SybaseServer; export DSQUERY
    SYBASE=SybaseInstallDirectory; export SYBASE
    These examples use the syntax for Bourne shell.
  6. (UNIX only) Verify or set the LANG environment variable.
  7. If you are upgrading from BMC Remedy AR System 7.1.00 to 8.1, set the Select into database option for the database that you are upgrading.
  8. Make sure that your database can accept network communication with the parameters entered in the installation.


    Refer to the planning spreadsheet for AR System installation parameters.

    The network communication will use ODBC and be able to recognize your ODBC data source.
  9. Change the minimum page size to 8 KB. For information about increasing the page size, see your Sybase documentation.
  10. Increase the default tempdb size to 600 MB.
  11. If you created a device in addition to a master device, designate the database device as a default database device. This is required because BMC Remedy AR System is always created on the default device. 
  12. If the database is configured to extend automatically, specify the following values:
    1. Set the BMC Remedy AR System data file size = 3 GB or larger.


      If the database is not configured to extend automatically, set the BMC Remedy AR System data file size to at least 2 GB for one BMC Remedy ITSM application, or to at least 8 GB if you are also installing all BMC Remedy ITSM applications.

    2. Set the log file size to 2 GB or larger.
    3. Change the Sybase configuration file to the following recommended minimal values, and restart the Sybase server:
      \[Meta-Data Caches\]
      number of open objects = 1310072
      number of open indexes = 512000
      number of open partitions = 6000
      \[Physical Memory\]
      max memory = 128000
      \[SQL Server Administration\]
      procedure cache size = 7000
      \[Lock Manager\]
      lock scheme=datarows
      \[User Connections\]
      number of user connections=50
  13. Set the following Sybase database configuration parameters:
    • Max Memory = 128000
    • Number of Locks = 15000
    • Number of Open Partitions = 15000
      The BMC Remedy AR System 8.1 suite installer optimizes SQL calls for installation on Sybase. Therefore, a larger number of LOCKS must be configured for the database.
  14. To prevent the transaction log from filling up during installation, set the trunc log on chkpt database option on the following databases:
    • BMC Remedy AR System database
    • tempdb
      Use the following commands: sp_dboption databaseName, 'trunc log on chkpt', true


      Disable the trunc log on chkpt option for all databases after the successful installation and before any production activity.

  15. If you are using Sybase 15, make sure that the number of open partitions parameter is set appropriately.
    For more information, see your Sybase documentation.
  16. If you plan to install the BMC Atrium CMDB Product Catalog or any ITSM application, make the following changes:
    • Set the Number of Open Objects to 30000.
    • Set the Number of Open Indexes to 15000.
    • Increase the size of tempdb. (You might have to create another device to increase the size of tempdb.)
      For more information about the LOCKS setting, see your Sybase documentation.

Pre-creating a database

If you do not have DBA privileges, your database administrator must create an empty database so that you are not asked for database information during the installation.

To pre-create a Sybase database

  1. Create a device.
    For example:
    use master
    disk init name='ARSystem_data', physname='/data1/ardata/ ARSys', size='1024M'
    disk init name=' ARSystem_log', physname='/data1/ardata/ARSysLog', size='500M'
  2. Create the database.
    For example:
    create database ARSystem on  ARSystem_data=1024 log on ARSystem_log=500 with override
    use master
  3. Create the login with a password.
    For example:
    sp_addlogin 'ARAdmin', 'AR#Admin#'
  4. Create the db_owner group.
    For example:
    sp_addgroup db_owner
    grant all to db_owner
  5. Create the user pointing to the created login and group.
    For example:
    sp_adduser 'ARAdmin', 'ARAdmin', db_owner
    use master
  6. Modify the login to make its default database, the earlier created database.
    For example:
    sp_modifylogin ARAdmin, defdb, ' ARSystem'
    use ARSystem
  7. Change the owner of the database to be the created user.
    For example:
    sp_changedbowner 'ARAdmin'
    use master
  8. Add the select into option to the created database.
    For example:
    sp_dboption 'ARSystem','select into',true
  9. Use the created database.
    use ARSystem

Forms with more than 254 fields

By default, Sybase does not work with forms that have more than 254 fields. This topic describes how to respond to error messages that might result from forms with more than 254 fields.

Because some forms have more than 254 fields at installation time, or can be expanded to have more than 254 fields during an integration with another application, you might receive an error message similar to the following example when installing the application on Sybase:

552 Failure during SQL operation to the database Number of variable length columns
exceeds limit of 254 forallpage locked tables. ALTER TABLE for 'T566' failed

If this happens during an integration, you might also receive a message similar to the following example:

303 Form does not exist on server SIT:Site Group

This occurs when the integration process adds fields to a form (using the ALTER TABLE command) that increase the number of fields to more than 254. When this happens, Sybase rolls back the change and drops the original table.

This generates further installation errors because additional dependencies fail to import.


Form:NTE:SYS-Group NT Control
Clause: lock datarowsForm:NTE:SYS-NTUnProcessedRecords
Clause: lock datarowsForm:NTE:SYS-NT Process Control
Clause: lock datarowsForm:CHG:Infrastructure Change
Clause: lock datarowsForm:SRM:Request
Clause: lock datarowsForm:SRM:RequestApDetailsSignature
Clause: lock datarowsForm:SRM:RequestInterface
Clause: lock datarowsForm:HPD:Help Desk
Clause: lock datarows

Related topics

error message 552
Preparing to install on a Unicode database
Preparing to upgrade on a Unicode database
Completing the planning spreadsheet

Where to go from here

Obtaining licenses for an upgrade

This version of the documentation is no longer supported. However, the documentation is available for your convenience. You will not be able to leave comments.