Error: Invalid spaceKey on retrieving a related space config.

Performing the BMC Service Request Management upgrade in phases

To minimize the scheduled outage window for an application upgrade, you can run the Remedy application upgrade installer in two phases:

  • Preparation phase – In the preparation phase, the installer captures the installation parameter values that you enter from the installation spreadsheet, runs the Remedy Configuration Checker utility to validate the environment, and deploys the required files in the installation directory. At the end of this phase, an options file is generated that contains the installation parameter values and the configuration details.

    In the preparation phase of the installation, no outage is required. However, an outage is required in the second phase of the upgrade. 
  • Upgrade phase – In this phase, the installer performs the installation and completes additional logging. Additionally, the hierarchical groups and escalations that are automatically disabled and enabled during an upgrade are now run simultaneously at the end of this phase.

    When the installer is running these background operations, you might choose end the outage period to start using your system or proceed with upgrading BMC Service Request Management and BMC Service Level Management. For information about hierarchical group improvements, see BMC Remedy ITSM Suite installation and upgrade enhancements in Service Pack 3.

The following topics are covered in this section: 

Before you begin

If you have not done so already, prepare the system to run the installers. If you want to run in nonadmin mode on Windows, see Preparing a Windows environment. If you want to run in nonroot mode on UNIX, see Preparing a UNIX environment.

Phase 1: Generating the options file and resolving configuration check issues

Perform the following steps to capture your installations parameter values in an options file and perform the upgrade configuration checks. The input values are auto-populated in the installer based on your previous installation. However, you might modify these values if required. After the installer validates the parameters, the installer deploys the application installation files on your system.

At the end of the first phase, the installer saves the input values and parameters in a text file,which is then used during the Phase 2 of the upgrade. During phase 1 of the upgrade, no outage or downtime is required.

To generate the options file and run configuration checks

  1. Open the command prompt and navigate to the <installation_directory>/Disk 1 folder.
  2. Depending on your platform, launch the installer by using one of the following commands:
    • (Windows) setup.exe -SRM_phase1  
    • (Linux) ./setup.bin -SRM_phase1

      Tip

      If you want to install the product silently, use the following command:
      setup.exe -ITSM_phase1 -i silent DOPTIONS_FILE=<full path for silent property file>.
      For more information about how to generate the silent.txt file for silent installation, see Creating a silent.txt file for BMC Service Request Management installation.

      Carefully specify the product name for the setup.exe installation command. If you are performing the phased BMC Service Request Management installation, specify setup.exe -SRM for the product to install.command.

       

    After a few seconds, the installer is initiated in GUI mode and the Welcome panel appears.
  3. In the lower right corner of the Welcome panel, click Next.
  4. Review the license agreement, click I agree to the terms of the license agreement, and then click Next.
  5. In the BMC Remedy AR System User Inputs panel, perform the following steps:
    1. Enter the administrator name and password.
    2. Review the default installation directory.
      Navigate to the directory in which you want to install BMC Service Level Management.
      The default locations are as follows:
      • (Windows) C:\Program Files\BMC Software\BMCServiceRequestManagement
      • (UNIX) /opt/bmc/BMCServiceRequestManagement
        The installer performs an environment validation and displays an appropriate message, indicating whether an error occurred.
  6. n the Overlay Information panel, perform the following steps:
    1. Select the I understand and agree that proceeding from this point will overwrite any customizations that are not in overlays or in custom objects check box if you agree.
      The upgrade overwrites all customizations unless you create them in overlays or custom objects. For more information about overlay objects, see About overlays.
    2. Click Next.
      The installer validates the system resources of your computer and displays a list of BMC applications (such as BMC Asset Management, BMC Change Management, and so on).
  7. On the Localized Views and Data panel, choose any additional locales as required and click Next.

    The locale you chose during the installation is displayed by default.

  8. On the BMC Configuration check report panel, perform the following steps:

    1. Click the link to Open the BMC Configuration Check report.

    2. If any errors or warnings are generated in your configuration check report, resolve those issues. In the Detail tab, click Help to be directed to information on how to resolve the error or warning, or go to Reviewing and resolving preupgrade and configuration issues

    3. After you have resolved the errors, re-run Phase 1 of the upgrade.
    4. Check the I have reviewed the Configuration Check report, and any errors have been resolved box, and then click Next.

    5. To view informational messages later, see Viewing configuration check reports.

  9. On the Installation Preview panel, click Next.
    The installer starts to deploy the installation files.

  10. On the Installation Summary panel, click Done.
    The BMCServiceRequestManagement_Phase1_OptionsFile.txt file is created in the installation directory.

  11. Navigate to your BMC Remedy ITSM installation directory and review the file to verify if the installation completed without errors.
    For more information, see Troubleshooting an installation by using the log files.

 

Phase 2: Performing the upgrade during an outage window

After resolving any issues reported in by the configuration checker in Phase 1, you begin the second phase of the upgrade. In this phase the installer uses the options file, to perform the upgrade. During phase 2 of the upgrade, an outage or downtime is required.

To perform the upgrade

  1. Open the command prompt and navigate to the <EPD_downloads_directory>/Disk 1 folder.
  2. Depending on your platform, launch the installer by using one of the following commands:
    • (Windows) setup.exe -SRM_phase2 
    • (Linux) ./setup.bin -SRM_phase2

      Tip

      If you want to install the product silently, use the following command:
      setup.exe -ITSM_phase1 -i silent DOPTIONS_FILE=<full path for silent property file>.
      For more information about how to generate the silent.txt file for silent installation, see Creating a silent.txt file for BMC Service Request Management installation.

      Carefully specify the product name for the setup.exe installation command. If you are performing the phased BMC Service Request Management installation, specify setup.exe -SRM for the product to install command.

      After a few seconds, the installer is initiated in GUI mode and the Welcome panel appears.
  3. In the lower right corner of the Welcome panel, click Next.
  4. Review the license agreement, click I agree to the terms of the license agreement, and then click Next.
  5. In the BMC Remedy AR System User Inputs panel, perform the following steps if the auto-populated value does not match your credentials:
    1. Specify the Administrator user name and password, if the one auto-populated is not accurate.
    2. Review the default installation directory.
      Navigate to the directory in which you want to install BMC Service Request Management.
      The default locations are as follows:
      • (Windows) C:\Program Files\BMC Software\BMCServiceRequestManagement
      • (UNIX) /opt/bmc/BMCServiceRequestManagement
  6. Click Next.
    The Installation Preview screen appears.
  7. Click Install.
    A summary of the installation is displayed. 
  8. Click View Log to determine if any SEVERE error messages or warnings are generated in the log.
    The default location for the log files are:
    • (Windows) C:\Users\<installUser>\AppData\Local\Temp\bmcservicerequestmanagement_install_log.txt
    • (Linux) /tmp/bmcservicerequestmanagement_install_log.txt
  9. When you are done reviewing, close the log and click Done to exit the installer.

Where to go from here

Next task

Go to Completing the BMC Service Request Management upgrade.

If you do not intend to use BMC Service Level Management, after performing the post-upgrade procedures for BMC Service Request Management, apply the BMC Service Request Management deployment package. For more information, see Applying a hotfix or a patch.

Up to process

If you have finished upgrading the applications, return to the appropriate upgrade process:

Related topics

Configuring BMC Service Request Management in the BMC Service Request Management documentation

Was this page helpful? Yes No Submitting... Thank you

Comments