resetService

Restarts the environment. You can, optionally, auto-tune the environment before restarting it to ensure that the Oracle Essbase index caches for Block Storage Option (BSO) cubes are optimized for your application.

By default, your environments are restarted right after the daily maintenance is completed. Auto-tuning your environment is important, for example, after importing a snapshot into an environment. Use this command only when you observe severe performance degradation or if you receive error messages indicating that the environment is unusable. Restarting an environment does not affect application customizations (for example, locale change, settings related to theme and currency, etc.). Restart takes up to 15 minutes.

Before using this command, ensure that business rules are not running in the environment.

Applies to

Planning, Planning Modules, FreeForm, Financial Consolidation and Close, Tax Reporting, Account Reconciliation, Profitability and Cost Management, Enterprise Profitability and Cost Management,Oracle Enterprise Data Management Cloud, Narrative Reporting, Sales Planning, and Strategic Workforce Planning.

Required Roles

Service Administrator

Usage

epmautomate resetService "comment" [AutoTune=true|false] [-f] where:
  • Comment is a description of the issue that caused you to reset the environment. Comments must be enclosed in quotation marks.

  • AutoTune, optionally, indicates whether to auto-tune the environment to optimize Essbase caches BSO cubes of your application. Default is false.

    Use this parameter only in environments that use Essbase BSO cubes: Planning (including Planning Modules), Financial Consolidation and Close, and Tax Reporting.

  • -f, optionally, specifies that you want to force the restart of the environment without additional user interaction. If you do not use this option, EPM Automate prompts you to confirm your action. This option is useful if you schedule a script that uses this command.

Examples

  • epmautomate resetService "Users experience slow connections; force restarting the environment" -f

  • epmautomate resetService "Users experience unacceptably slow connections"

  • epmautomate resetService "Optimizing the Essbase cache" AutoTune=true