×
 
 
  •  
$helper.renderConfluenceMacro('{bmc-global-announcement:$space.key}')

This documentation supports the 20.02 version of Remedy Deployment.
To view an earlier version, select the version from the Product version menu.

Remedy Deployment 20.02 ... Installing Installing the platform components Installing BMC Remedy AR System Performing the BMC Remedy AR System installation

Installing BMC Remedy Smart Reporting

If you have not already done so, prepare to install Remedy Smart Reporting. To reduce installation time significantly, do not install the products over a WAN.

Before you begin

To install BMC Remedy Smart Reporting, ensure the following:

  • (Unix non-root mode) You must have write access to \etc, \opt\bmc folder, and the install location.
  • (Windows non-admin mode) You must have write access to the install location, and %windir% directory.
  • The AR System server host name and the BMC Remedy Smart Reporting server host name must be added to the /etc/hosts file. Any issues with IP host resolution will cause BMC Remedy Smart Reporting onboarding to fail.
  • For Smart Reporting to work correctly, make sure that Smart Reporting and AR System server are on the same version.
  • Before installing Smart Reporting, you must update the context.xml file. For the list of supported Tomcat versions, see  BMC SOLUTION AND PRODUCT AVAILABILITY AND COMPATIBILITY UTILITY (SPAC) Open link . Also check the default port numbers before you install Smart Reporting. For more information, see Network ports.


Best practices

Before you perform the installation, consider the following best practices:

  • BMC recommends that you install Remedy AR System server before you install Remedy Smart Reporting.
  • BMC recommends that you install BMC Remedy Smart Reporting and BMC Remedy AR System server on different machines.
  • To avoid configuration problems, accept the default values displayed in the installer unless you have a valid reason to modify them.

To install BMC Remedy Smart Reporting with SQL database using Windows authentication

When installing BMC Remedy Smart Reporting with SQL database using Windows authentication, you must fulfill the following prerequisites: 

When installing a service to run under a domain user account, the account must have the right to log on as a service on the local computer. This right strictly applies only to the local computer and it must be granted in the Local Security Policy.

To edit the Local Security Policy of the Windows computer on which you want to define the log on as a service permission:

  1. Log on to the computer with administrative privileges.
  2. In Control Panel, select System and Security > Administrative Tools > Local Security Policy.
    The Local Security Policy window is displayed.
  3. Under Security Settings, expand Local Policies and then click User Rights Assignment.
  4. In the right-pane, right-click Log on as a service and then click Properties.
    The Log on as a service Properties dialog box is displayed.
  5. Click Add User or Group.
    The Select Users, Computers, Service Accounts, or Groups dialog box is displayed.
  6. In the Enter the object names to select box, type an object name and then click OK.
  7. In the Log on as a service Properties dialog box, click OK.
    Your changes are saved.

Note

Ensure that the object name that you have added in the Enter the object names to select box is not listed in the Deny log on as a service policy under Local Security Policy.

Click the following video for a quick overview of the BMC Remedy Smart Reporting installation.

Note

The video displays the Database Instance Name field on the installer screen at 3.10 minutes. However, from BMC Remedy Smart Reporting 9.1.02, the Database Instance Name field is removed from the installer screen. You must enter the port number related to the required instance in the Database Server Port field for the installer to automatically find the instance name.

To update the context.xml file

Perform the following steps before installing Remedy Smart Reporting:

  1. Go to the <tomcat installation directory>\conf\ context.xml.

  2. Set the xmlBlockExternal to false in the Context parameter. For example:

    <Context xmlBlockExternal="false">

    Do not add a new Context xmlBlockExternal tag. You must update the existing tag as shown in the following table:

    Before updating

    Recommended

    To be avoided


  3. Save the file.
  4. If you have installed the external Tomcat as a service, you must use two servers with the following Java heap size for each server:
    • Minimum: 12 GB
    • Maximum: 16 GB

    You may need to increase this configuration based on the usage and the load on the server.

To install BMC Remedy Smart Reporting

  1. If you have not already done so, download the BMC Remedy AR System installer from the Electronic Product Download (EPD) site, or navigate to the installation directory on the DVD.
  2. Unzip the suite installer (for example, ARSuiteKitWindows.zip or ARSuiteKitLinux.zip).
  3. Navigate to the Disk 1 folder.
  4. Start the installer:
    • For Windows, run setup.exe.
    • For UNIX, run setup.bin.
  5. In the lower-right corner of the Welcome panel, click Next.
  6. Review the license agreement, click I agree to the terms of license agreement, and then click Next.
  7. On the Products selection panel, perform the following actions:
    1. Select Install.
    2. Select BMC Remedy Smart Reporting and clear the other options.
      The installer validates the system resources of your computer and displays a list of available features.
    3. Navigate to the directory in which you want to install the BMC Remedy AR System application.
      The default locations are C:\Program Files\BMC Software\ARSystem\SmartReporting (Windows) and/opt/bmc/ARSystem/SmartReporting (UNIX or Linux).
    4. Click Next.

  8. On the User Inputs panel, enter the Reporting Admin User ID and password.

  9. On the Tomcat Deployment Directory Information panel, navigate to the folder where you have installed Apache Tomcat. For a Windows machine, wait for the Tomcat Service Name to get populated automatically, and click Next.

    Note

    If the Tomcat Service Name is not automatically detected, ensure that the Tomcat service is created and running. Tomcat must be registered as a service for the installer to detect it.

    For more information about installing the Tomcat services, see   https://tomcat.apache.org/tomcat-8.5-doc/windows-service-howto.html Open link  in the Apache Tomcat documentation.

  10. Enter the values from the installation spreadsheet for the features that you want to install.

    After you have entered the required information, the installer validates your input. The Installation Preview panel then appears, listing the product and features that will be installed.

    Note

    • If you are using the SQL database for BMC Remedy Smart Reporting, make sure you complete the Microsoft SQL database configuration as described in the Configuring the Microsoft SQL Server topic. The database validation fails if the database is configured incorrectly.
    • Ensure that you drop all the tables from the existing Smart Reporting database. This will clear all the duplicate entries and the installation is completed without any errors. For example, in the Configuration table, the DEFAULTENTRYPAGE entry occurs multiple times.
    • Do not use comma (,) or double quotes (") while setting a new password for the super admin user at the time of installation. However, you can use comma (,) or double quotes (") if you are changing the password of the super admin user after installation.
  11. Click Next.
    The installer installs the feature. After post-installation cleanup, a summary of the installation appears.
  12. Click View Log to review any SEVERE error messages or warnings in the product installer log.
    See whether errors are due to network, host, or other environment-related issues. You can view a log file of the installation: 
    • C:\Users\Administrator\AppData\Local\Temp\arsystem_install_log.txt
    • <install_directory>\SmartReporting\smartreporting-<yy/mm/dd>.log 
  13. When you are finished reviewing the log, close it.
  14. Click Done to exit the AR System installer.

Note

After the installation is complete, a BMC Remedy Smart Reporting super Administrator user is created. The default user name and password is set to siadmin. We recommend that you change the default password. For information on changing the super admin password, see Changing the Remedy Smart Reporting super admin password after installation Open link .

(Optional) Installing BMC Remedy Smart Reporting in silent mode

To install BMC Remedy Smart Reporting in silent you have to run the AR installer in silent mode. For instructions, see Running the installer in silent mode and Example options.txt file.

Connecting AR System data source with a replicated read-only AR database 

If you want to keep the AR production database unaffected and yet allow BMC Remedy Smart Reporting users to continue with the reporting operations, you must connect your AR System data source with a read-only replicated AR database.

To avoid license update related issues, you must complete the user onboarding process by connecting with a read/write AR production database. After completing the user onboarding process, perform the following steps to connect your AR System data source with a read-only replicated AR database.

Note

BMC Remedy Smart Reporting database must always be in read/write mode.

  1. Log in to Remedy Mid Tier as BMC Remedy Smart Reporting administrator.
  2. Navigate to Applications > BMC Remedy Smart Reporting > BMC Smart Reporting console.
  3. On the BMC Remedy Smart Reporting console, navigate to Administration > Admin console > Data sources.
  4. Click AR System connection.
  5. Under the Connection section, in the Host field, enter the AR Server host name which is connected to the read-only replicated AR database.
  6. Under the Test Connection section, click Click here to test connection to check if the connection works. 
  7. Click Save to complete the connection setup.

Where to go from here

Next task
  • Installing the application components
  • Onboarding users and importing content in Remedy Smart Reporting Open link in the Remedy Smart Reporting documentation. Note: Onboard BMC Remedy Smart Reporting after you install BMC Remedy ITSM.
  • Setting up BMC Remedy Smart Reporting as a cluster and onboard tenant Open link in the BMC Remedy AR System documentation.
Up to process
 

Related topics

Troubleshooting Remedy Smart Reporting Installation and Upgrade issues

Changing the Remedy Smart Reporting super admin password after installation Open link

Was this page helpful? Yes No Submitting... Thank you
Last modified by Himanshu Raul on Aug 27, 2021
best_practices installing installing_platform

Comments

  1. Bharath Kumar

    Hello,

    In Step 9 which talks about Tomcat Deployment Directory, we observed that if tomcat is given a different service name other than TomcatX, then installer fails to identify the service name and results in failure. Can you please document this somewhere.

    May 04, 2020 01:06
    1. Himanshu Raul

      Hi Bharath,

      Thank you for your feedback on the documentation. We have documented this step in the topic "Preparing your web server".

      Regards,

      Himanshu

      May 19, 2020 12:58
  2. Jason Miller

    The link "Onboarding users and importing content in Remedy Smart Reporting" in the Next Task box is broken.

    Jun 09, 2020 04:47
    1. Maithili Deshpande

      Hi Jason, 

      Thank you for your feedback. I have fixed the links as suggested. 

      Regards,

      Maithili

      Jun 10, 2020 10:43
  3. Uday Joshi

    Like AR Server, is it possible to pre-create Smart reporting database?

    Jul 21, 2020 01:10
    1. Himanshu Raul

      Hi Uday,

      Thank you for your comment. Yes, it is possible to create a Smart Reporting database before you start installing Remedy Smart Reporting.

      The note in Step 10 mentions the use of the existing database. The existing database should be empty before you install Remedy Smart Reporting.

      Regards,

      Himanshu

      Jul 21, 2020 01:49
  4. Oliver Kelm

    It should be mentioned, that Tomcat has to be configured on Port 8080 without TLS and that the server needs an internet connection with the "normal" Installer (you are getting an offline installer from BMC via Service Request).

    May 25, 2021 02:19
    1. Himanshu Raul

      Hi Oliver,

      Thank you for your feedback on the documentation. If you are using an external Tomcat, you can configure Tomcat on any port. For information on default port numbers, see Network ports.

      After downloading the offline installers, you can install Remedy Smart Reporting even if you are not connected to the internet.

      Regards,

      Himanshu

      Jul 01, 2021 01:26
      1. Oliver Kelm

        Installation is only possible, when Tomcat runs von Port 8080, I've discussed this already the BMC Support and they've confirmed this.

        Jul 09, 2021 02:02
        1. Adam Lawson

          This is true, the installer will fail if Tomcat is running on a different port - but this is a defect with the installer and isn't intentional. There is no way around it other than correcting the Tomcat instance during the installation.

          The installer should work however with SSL assuming that you still have it working on 8080 and not 8443 or similar.

          Oct 28, 2021 03:35
  5. Rã³mulo Rafael

    Hi, BMC Remedy Smart Reporting option is not available on installer wizard (setup.exe) when following the steps above.

    Oct 13, 2022 07:46
    1. Himanshu Raul

      Hi Rã³mulo Rafael,

      Thank you for your comment. Please visit https://docs.bmc.com/docs/pages/viewpage.action?pageId=1041973782 for more information.

      Regards,

      Himanshu

      Dec 06, 2022 06:23

Log in or register to comment.

Installing the BMC Remedy AR System Server
Installing BMC Remedy Mid Tier
© Copyright 1991-2021 BMC Software, Inc. © Copyright 1991-2021 BladeLogic, Inc.
Legal notices

Powered by Atlassian Confluence and Scroll Viewport

© Copyright 2005-2024 BMC Software, Inc. Use of this site signifies your acceptance of BMC’s Terms of Use . BMC, the BMC logo, and other BMC marks are assets of BMC Software, Inc. These trademarks are registered and may be registered in the U.S. and in other countries.