{"id":18802158,"url":"https://github.com/oracle-quickstart/oci-essbase","last_synced_at":"2025-06-12T02:06:48.407Z","repository":{"id":43659172,"uuid":"215145214","full_name":"oracle-quickstart/oci-essbase","owner":"oracle-quickstart","description":"Terraform module to deploy Essbase on Oracle Cloud Infrastructure (OCI)","archived":false,"fork":false,"pushed_at":"2025-01-27T11:40:18.000Z","size":3830,"stargazers_count":8,"open_issues_count":0,"forks_count":9,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-20T18:40:50.366Z","etag":null,"topics":["cloud","essbase","oci","oracle","oracle-led","terraform"],"latest_commit_sha":null,"homepage":null,"language":"HCL","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"upl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle-quickstart.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-10-14T21:05:34.000Z","updated_at":"2025-01-24T08:00:10.000Z","dependencies_parsed_at":"2024-11-07T22:30:53.120Z","dependency_job_id":"4cae9b80-0f4b-4b41-b4f8-c425b16280d6","html_url":"https://github.com/oracle-quickstart/oci-essbase","commit_stats":null,"previous_names":[],"tags_count":16,"template":false,"template_full_name":null,"purl":"pkg:github/oracle-quickstart/oci-essbase","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-essbase","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-essbase/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-essbase/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-essbase/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle-quickstart","download_url":"https://codeload.github.com/oracle-quickstart/oci-essbase/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle-quickstart%2Foci-essbase/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259382299,"owners_count":22848836,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloud","essbase","oci","oracle","oracle-led","terraform"],"created_at":"2024-11-07T22:26:48.349Z","updated_at":"2025-06-12T02:06:48.363Z","avatar_url":"https://github.com/oracle-quickstart.png","language":"HCL","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp float=\"left\"\u003e\n  \u003cimg align=\"left\" width=\"130\" src=\"./images/oracle-Essbase.png\"\u003e \n  \u003cbr/\u003e\n  \u003ch1\u003eOracle Essbase on Oracle Cloud Infrastructure\u003c/h1\u003e\n  \u003cbr/\u003e\n\u003c/p\u003e\n\n![essbase-stack](https://github.com/oracle-quickstart/oci-essbase/workflows/essbase-stack/badge.svg)\n\n[![Deploy to Oracle Cloud](https://oci-resourcemanager-plugin.plugins.oci.oraclecloud.com/latest/deploy-to-oracle-cloud.svg)\n](https://console.us-phoenix-1.oraclecloud.com/resourcemanager/stacks/create?region=home\u0026zipUrl=https://github.com/oracle-quickstart/oci-essbase/releases/download/v21.1.0.0.1/essbase-stack-v21.1.0.0.1-byol.zip)\n\n[Oracle Essbase][essbase] is a business analytics solution that uses a proven, flexible, best-in-class architecture for analysis, reporting, and collaboration. It delivers instant value and greater productivity for your business users, analysts, modelers, and decision-makers, across all lines of business within your organization. You can interact with Essbase, through a web or Microsoft Office interface, to analyze, model, collaborate, and report.\n\nThis Quick Start automates the deployment of Oracle Essbase on [Oracle Cloud Infrastructure (OCI)][oci]. It can also deploy additional stack components required – Autonomous Database, Load Balancer, Storage, Virtual Cloud Network (VCN) as part of the deployment.\n\nFor more details on deploying the Essbase stack on Oracle Cloud Infrastructure, please visit the [Administering Oracle Essbase](https://docs.oracle.com/en/database/other-databases/essbase/21/essad/index.html) guide.\n\n### Default Topology\n\n![Default Topology Diagram](./images/image-default_topology.png)\n\nThe above digram shows the default topology supported by the terraform scripts.  In the basic topology, the Essbase compute instance is exposed on a public subnet, and configured using the target autonomous database for the RCU schema.\n\n### Full Topology\n\n![Full Topology Diagram](./images/image-full_topology.png)\n\nThe above diagram shows the full topology supported by the terraform scripts.  In this scenario, the application subnet is private. To access the Essbase user interface, an OCI load balancer is provisioned in either public or private regional subnet.  An OCI Bastion Service instance can be used from OCI to allow access through a public ip address.\n\n## Before You Begin with Oracle Essbase\n\nRefer to the [documentation](https://docs.oracle.com/en/database/other-databases/essbase/21/essad/you-begin-oracle-essbase.html) for the pre-requisite steps to using Essbase on OCI.\n\n### Create Secrets with OCI Vault\n\nOracle Cloud Infrastructure [Vault][vault] enables you to manage sensitive information when creating a stack. You are required to store your credentials in the vault prior to provisioning the Essbase stack. Passwords chosen for Essbase administrator and Database must meet their respective password requirements.\n\n### Create Dynamic Group\n\nYou create dynamic groups of Oracle Cloud Infrastructure compute instances, and associate them with policies. For more information on dynamic groups, see [Managing Dynamic Groups](https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingdynamicgroups.htm).\n\n### Setup Policies\n\nSet up policies that are appropriate for your organization's security setup. The following is an example of a policy template, with each row being a policy statement.\nPlease refer to the 21c Oracle documentation for the up-to-date list.\n\n```\nallow group group_name to manage virtual-network-family in compartment compartment_name\nallow group group_name to manage load-balancers in compartment compartment_name\nallow group group_name to manage app-catalog-listing in compartment compartment_name\nallow group group_name to manage instances in compartment compartment_name\nallow group group_name to manage volume-family in compartment compartment_name\nallow group group_name to use instance-family in compartment compartment_name\nallow group group_name to manage autonomous-database-family in compartment compartment_name\nallow group group_name to manage autonomous-backups in compartment compartment_name\nallow group group_name to manage buckets in compartment compartment_name\nallow group group_name to manage objects in compartment compartment_name\nallow group group_name to use vaults in compartment compartment_name\nallow group group_name to use keys in compartment compartment_name\nallow group group_name to use secrets in compartment compartment_name\n```\n\nSome policies may be optional, depending on expected use. For example, if you're not using a load balancer, you don't need a policy that allows management of load balancers.\n\nTo allow instances within the compartment to invoke functionality without requiring further authentication, you must have group policies for the instances in the compartment. To do this, create a dynamic group, and set the policies for that dynamic group, such as shown in the following example:\n\n```\nallow dynamic-group group_name to inspect volume-groups in compartment compartment_name\nallow dynamic-group group_name to manage volumes in compartment compartment_name\nallow dynamic-group group_name to manage volume-group-backups in compartment compartment_name\nallow dynamic-group group_name to manage volume-backups in compartment compartment_name\nallow dynamic-group group_name to use autonomous-database in compartment compartment_name\nallow dynamic-group group_name to manage autonomous-backups in compartment compartment_name\nallow dynamic-group group_name to read buckets in compartment compartment_name\nallow dynamic-group group_name to manage objects in compartment compartment_name\nallow dynamic-group group_name to use keys in compartment compartment_name\nallow dynamic-group group_name to use secrets in compartment compartment_name\n```\n\n## Using the Terraform command line tool\n\nYou'll want a local copy of this repo. You can make that with the commands:\n\n```\ngit clone https://github.com/oracle-quickstart/oci-essbase.git\ncd oci-essbase/terraform\nls\n```\n\n![clone repo](./images/00_clone_repo.png)\n\nWe now need to initialize the directory with the module in it. This makes the module aware of the OCI provider. You can do this by running:\n\n```\nterraform init\n```\n\n![terraform init](./images/01_terraform_init.png)\n\n### Configure\n\nBy default, the Essbase image selected is the BYOL [license](#License). To use the UCM [license](#License), replace the `essbase.auto.tfvars` file with `essbase.auto.tfvars.ucm`. Set the remaining [variables](./VARIABLES.md) needed to drive the stack creation.  This can be done by creating the terraform.tfvars from the [template file](./terraform/terraform.tfvars.template), or using environment variables as described here.\n\nLet's make sure the plan looks good:\n\n```\nterraform plan\n```\n\n![terraform plan](./images/02_terraform_plan.png)\n\n### Deploy\n\nIf that's good, we can go ahead and apply the deploy:\n\n```\nterraform apply\n```\n\nYou'll need to enter yes when prompted. The apply can take up to twenty minutes to run.\n\n![terraform apply](./images/03_terraform_apply.png)\n\nWhen the apply is complete, the infrastructure will be deployed and the Essbase product will be running, and can be accessed at the given `essbase_url` output variable.\n\n![access essbase](./images/04_access_essbase.png)\n\n### Destroy the Deployment\n\nWhen you no longer need the deployment, you can run this command to destroy it:\n\n```\nterraform destroy\n```\n\nYou'll need to enter yes when prompted.\n\n![terraform destroy](./images/05_terraform_destroy.png)\n\n## Using OCI Resource Manager\n\nOracle Cloud Infrastructure [Resource Manager (ORM)][orm] allows you to manage your terraform configurations and state.\nTo simplify getting started, the terraform stacks for use with ORM are created as part of each [release](https://github.com/oracle-quickstart/oci-essbase/releases).\n\nNote, you may need to update your policies for accessing the ORM service.\n\n```\nallow group group_name to manage orm-stacks in compartment compartment_name\nallow group group_name to manage orm-jobs in compartment compartment_name\n```\n\n## Post-Deployment Tasks\n\nRefer to the [documentation](https://docs.oracle.com/en/database/other-databases/essbase/21/essad/complete-deployment-tasks.html) for a list of post-deployment tasks.\n\n## License\n\nThese terraform scripts are licensed under the Universal Permissive License 1.0.  See [LICENSE](./LICENSE) for more details.\n\nThere are two licensing options available:\n\n### Universal Credits Model (UCM)\nThe listing in OCI Marketplace can be found here: https://cloudmarketplace.oracle.com/marketplace/en_US/listing/67812026\nWhen deploying using UCM, the Essbase license in governed by the following Licensing terms: https://cloudmarketplace.oracle.com/marketplace/content?contentId=70514770\u0026render=inline\n\n### Bring Your Own License (BYOL)\nThe listing in OCI Marketplace can be found here: https://cloudmarketplace.oracle.com/marketplace/en_US/listing/63497640\nWhen deploying using BYOL, the Essbase license is governed by the following Licensing terms: https://cloudmarketplace.oracle.com/marketplace/content?contentId=18088784\u0026render=inline\n\nThe Oracle Essbase product requires an on-premises purchased license and active support contract. This allows customers to leverage BYOL option for deploying Essbase on OCI.\n\n## Questions\n\nIf you have an issue or a question, please take a look at our [FAQs](./FAQs.md) or [open an issue](https://github.com/oracle-quickstart/oci-essbase/issues/new).\n\n[essbase]: https://docs.oracle.com/en/database/other-databases/essbase/21/index.html\n[oci]: https://cloud.oracle.com/cloud-infrastructure\n[orm]: https://docs.cloud.oracle.com/iaas/Content/ResourceManager/Concepts/resourcemanager.htm\n[vault]: https://docs.cloud.oracle.com/iaas/Content/KeyManagement/Concepts/keyoverview.htm\n[tf]: https://www.terraform.io\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-quickstart%2Foci-essbase","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle-quickstart%2Foci-essbase","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle-quickstart%2Foci-essbase/lists"}