{"id":29526409,"url":"https://github.com/ibm-wm-transition/sagdevops-cc-server","last_synced_at":"2025-07-16T20:07:18.273Z","repository":{"id":51897231,"uuid":"80265832","full_name":"ibm-wm-transition/sagdevops-cc-server","owner":"ibm-wm-transition","description":"Customized Software AG Command Central server setup","archived":false,"fork":false,"pushed_at":"2025-06-27T20:46:34.000Z","size":181,"stargazers_count":20,"open_issues_count":0,"forks_count":38,"subscribers_count":25,"default_branch":"release/105oct2019","last_synced_at":"2025-06-27T21:31:22.184Z","etag":null,"topics":["command-central","devops","docker-image","infrastucture-as-code","webmethods"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ibm-wm-transition.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2017-01-28T04:14:48.000Z","updated_at":"2025-06-27T20:46:37.000Z","dependencies_parsed_at":"2025-06-27T21:31:24.774Z","dependency_job_id":"6cb2f2e2-f167-4671-a505-7bbb1616b7e1","html_url":"https://github.com/ibm-wm-transition/sagdevops-cc-server","commit_stats":null,"previous_names":["ibm-wm-transition/sagdevops-cc-server"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/ibm-wm-transition/sagdevops-cc-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibm-wm-transition%2Fsagdevops-cc-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibm-wm-transition%2Fsagdevops-cc-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibm-wm-transition%2Fsagdevops-cc-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibm-wm-transition%2Fsagdevops-cc-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ibm-wm-transition","download_url":"https://codeload.github.com/ibm-wm-transition/sagdevops-cc-server/tar.gz/refs/heads/release/105oct2019","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ibm-wm-transition%2Fsagdevops-cc-server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265536400,"owners_count":23784245,"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":["command-central","devops","docker-image","infrastucture-as-code","webmethods"],"created_at":"2025-07-16T20:07:07.410Z","updated_at":"2025-07-16T20:07:18.264Z","avatar_url":"https://github.com/ibm-wm-transition.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Command Central server setup\n\nThis project automates Command Central setup:\n\n* Downloads latest fix level bootstrap installer for your platform\n* Runs bootstrap installer\n* Configures HTTP/S proxy\n* Registers master repositories\n* Registers license keys\n* Uploads product and fix images\n* Creates mirror repositories\n* Imports default templates library\n\nYou can also use this project to maintain your Command Central installation:\n\n* Pull the latest fixes and products into mirror repositories\n* Update Command Central to the latest patch level\n* Upgrade Command Central to a new release (from 9.x)\n* Start/stop/restart Command Central\n* Check jobs status and tail the logs\n* Apply default and custom templates\n\n## Build and Test status of default branches\n\n| AppVeyor (Windows)       | Travis CI (Linux / macOS) |\n|--------------------------|--------------------------|\n| [![Build status](https://ci.appveyor.com/api/projects/status/s8rcroq87awof16f/branch/release/103oct2018?svg=true)](https://ci.appveyor.com/project/sergeipogrebnyak/sagdevops-cc-server/branch/release/103oct2018) | [![Build Status](https://travis-ci.org/SoftwareAG/sagdevops-cc-server.svg?branch=release%2F103oct2018)](https://travis-ci.org/SoftwareAG/sagdevops-cc-server) |\n\n## Requirements\n\n* Git client\n* Internet access\n* Java 1.8\n* [Apache Ant 1.9+](https://ant.apache.org/)\n\nVerify Java and Ant installation by running:\n\n```bash\njava -version # MUST be 1.8+\nant -version  # MUST be 1.9+\n```\n\n## Quick Start\n\n\u003e IMPORTANT: make sure you clone the repository with submodules by using `--recursive` switch:\n\n```bash\ngit clone --recursive -b release/105oct2019 https://github.com/SoftwareAG/sagdevops-cc-server\ncd sagdevops-cc-server\n```\n\nPerform default setup:\n\n\u003e IMPORTANT: by setting ```accept.license=true``` property\nyou are accepting [End User License Agreement](http://documentation.softwareag.com/legal/general_license.txt)\n\n```bash\nant boot -Daccept.license=true\nant up test\n```\n\nWhen the process completes successfully open\n[Command Central Web UI](https://localhost:8091/cce/web/) and login as Administrator/manage.\n\nFor a customization process follow the steps below.\n\n## How to customize setup process\n\n### Fork the project\n\nFork the project and clone it locally:\n\n```bash\ngit clone --recursive -b release/105oct2019 https://github.com/YOURCCOUNT/sagdevops-cc-server\ncd sagdevops-cc-server\n```\n\n### Customizing version, installation directory, ports and Administrator password\n\nYou can customize configuration for the bootstrap process.\n\nCopy [bootstrap/default.properties](bootstrap/default.properties) into a new YOUR_BOOT_NAME.properties file.\nUncomment the following property to accept the license agreement:\n\n```bash\naccept.license=true\n```\n\nReview and modify any other properties as needed.\n\nRun bootstrap process using the customized properties file:\n\n```bash\nant boot -Dbootstrap=YOUR_BOOT_NAME\n```\n\nThe downloaded bootstrap installer file will be reused (not downloaded again).\n\n\u003e NOTE: most of the properties are applicable only for a new bootstrap session. If you previously bootstraped\nCommand Central they will NOT apply until you uninstall first\n\n```bash\nant uninstall boot\n```\n\n### Configuring Proxy\n\nIf you have direct connection to the Internet you can skip this step.\n\nIf you have a proxy server copy [environments/default/env.properties](environments/default/env.properties)\ninto a new environments/YOUR_ENV_NAME/env.properties file and update it with your HTTP/S proxy configuration:\n\n```\nproxy.http.host=YOURPROXYHOST\nproxy.http.port=8080\nproxy.http.nonproxyhosts=localhost|.my.domain\n```\n\nThen run:\n\n```bash\nant proxy -Denv=YOUR_ENV_NAME\n```\n\nor:\n\n```bash\nexport CC_ENV=YOUR_ENV_NAME\nant proxy\n```\n\n### Registering master repositories for products and fixes\n\nIf this Command Central does not have access to the Internet you can skip this step.\n\n\u003e IMPORTANT: Your _gateway_ or _development_ Command Central should have access to the Internet.\n\nTo register master repositories Command Central needs your [Empower](https://empower.softwareag.com/) credentials\nwith permissions to download products and fixes.\n\nRun this command to enter the credentials and store them in Command Central:\n\n```bash\nant credentials\n```\n\nRegister all Software AG master repositories in Command Central:\n\n```bash\nant masters\n```\n\nVerify successful master repositories setup:\n\n```bash\nant test\n```\n\n### Importing license keys\n\nIf you can skip this step if you plan on adding your license keys for each individual project,\nhowever it is recommended to add all your license keys now.\n\nReplace sample licenses/licenses.zip with your licenses.zip archive.\n\nYou can customize the location of the licenses archive in\nenvironments/YOUR_ENV_NAME/env.properties by setting this property:\n\n```bash\nlicenses.zip.url=http://url/to/licenses.zip\n```\n\n\u003e IMPORTANT: the structure of the licenses.zip is not important. Command Central will introspect\nthe archive and import found licences with auto generated aliases.\n\nRun this command to import license files:\n\n```bash\nant licenses -Denv=YOUR_ENV_NAME\n```\n\nYou can run this command again any time to add upload new license keys.\n\n### Adding product and fix images\n\nYou can skip this step if you're planning to use only master and mirror repositories.\n\nUse of image repositories is discouraged.\n\nIf you want to upload SAG Installer images to Command Central place the image\n.zip files under _./images_/products folder.\n\nIf you want to upload SAG Update Manager images place the image\n.zip files under _./images/fixes_ folder.\n\nYou can customize the location of the images folder in\nenvironments/YOUR_ENV_NAME/env.properties\nby setting this property:\n\n```bash\nimages.dir=/path/to/images/\n```\n\n\u003e IMPORTANT: the structure of the images.dir folder must be the following:\n\n```\nproducts\\\n    my-9.12-products-lnxamd64.zip\n    my-9.12-products-w64.zip\nfixes\\\n    my-9.12-fixes.zip\n    my-9.10-fixes.zip\n```\n\nRun this command to upload image files:\n\n```bash\nant images -Denv=YOUR_ENV_NAME\n```\n\nYou can run this command again any time to add upload new images.\n\n### Creating mirror repositories\n\nYou should create mirror repositories to improve provisioning performance.\n\n\u003e NOTE: this process may take a long time and requires up to 10GB of space on average per release\nif you mirror all products.\n\nYou can customize which release and which products/fixes to mirror using\nenvironments/YOUR_ENV_NAME/env.properties\nby setting these properties:\n\n```bash\nrelease=10.1\n# from\nmirror.repo.product=webMethods-${release}\nmirror.repo.fix=Empower\n# which products\nmirror.products=productId1,productId2,...\n# which platforms\nmirror.platforms=W64,LNXAMD64,OSX\n# hosting spm URL\nmirror.spm=http://CCHOST:8092\n```\n\n\u003e TIP: To find out product ids, open Command Central Web UI, webMethods-${release} repository content view\nand tick _Show ID Column_ checkbox in the gear menu.\n\nTo start mirrors create or update process run:\n\n```bash\nant mirrors -Denv=YOUR_ENV_NAME\n```\n\n\u003e NOTE: fix mirror will download fixes only for the products in your product mirror\nrepository.\n\nYou can run this command again any time to pull the latest products/fixes from the upstream repos.\n\n### Commit your changes to version control system\n\n\u003e IMPORTANT: To ensure your entire customized setup runs cleanly perform end-to-end run:\n\nAdjust 'up' target in [build.xml](build.xml) with the targets that are applicable to your setup and run:\n\n```bash\nexport CC_BOOT=YOUR_BOOT_NAME\nexport CC_ENV=YOUR_ENV_NAME\n\nant uninstall boot\nant up test\n```\n\n\u003e NOTE: `uninstall` target is currently NOT supported on Windows\n\nThe successful test run will end with something like this:\n\n```bash\n[au:antunit] Environment configuration: environments/test/env.properties\n[au:antunit] ------------- ---------------- ---------------\n[au:antunit] Target: test-repos-master-prods took 1.103 sec\n[au:antunit] Target: test-repos-master-fixes took 1.092 sec\n[au:antunit] Target: test-repos-master-fixes-listing took 10.117 sec\n[au:antunit] Target: test-repos-master-prods-listing took 48.337 sec\n\nBUILD SUCCESSFUL\nTotal time: 41 minutes 27 seconds\n```\n\nCommit your changes to your target version control system, e.g. forked project on GitHub or internal git repo.\n\n```bash\ngit commit -am 'customizations'\ngit push\n```\n\n## Setting up CI process\n\nClone default or forked project from GitHub and perform identical fully automated setup\nof your customized Command Central server:\n\n```bash\nexport CC_BOOT=YOUR_BOOT_NAME\nexport CC_ENV=YOUR_ENV_NAME\n\nexport EMPOWER_USR=you@company.com\nexport EMPOWER_PSW=*****\n\nant boot\nant up test\n```\n\nSee examples of CI configuration files:\n\n* [Jenkins](Jenkinsfile)\n* [Travis CI](.travis.yml)\n* [Appveyor CI](appveyor.yml)\n\n## Launching Command Central Docker container\n\nThe fastest way to get Command Central up and running is to launch Docker container from the Docker Store.\n\n\u003e IMPORTANT: Please see [sagdevops-hello-docker](https://github.com/SoftwareAG/sagdevops-hello-docker) for getting started instructions.\n\n```bash\nEMPOWER_USR=you@company.com \\\nEMPOWER_PSW=**** \\\ndocker-compose run --rm init\n```\n\nTo setup mirrors run:\n\n```bash\ndocker-compose run --rm init ant mirrors\n```\n\n## Creating staging environments on Software AG network\n\nYou can setup pre-released software staging environments\nif you have access to Software AG network.\n\nOn Linux and Mac OS:\n\n```bash\nexport CC_BOOT=staging\nexport CC_ENV=staging\nexport CC_VERSION=10.3-fix1\n\nexport EMPOWER_USR=you@softwareag.com\nexport EMPOWER_PSW=*****\n\nexport SAG_AQUARIUS=aquarius-dae.eur.ad.sag\nexport CC_INSTALLER_URL=http://aquarius-dae.eur.ad.sag/PDShare/cc\n\n# for clean boxes, bootstrap antcc\n# antcc/bootstrap/install.sh\n# . ~/.bash_profile || . ~/.profile\n\nant boot\nant up staging test\n```\n\nOn Windows:\n\n```powershell\nset CC_BOOT=staging\nset CC_ENV=staging\nset CC_VERSION=10.5-fix4\n\nset EMPOWER_USR=you@softwareag.com\nset EMPOWER_PSW=*****\n\nset SAG_AQUARIUS=aquarius-dae.eur.ad.sag\nset CC_INSTALLER_URL=http://aquarius-dae.eur.ad.sag/PDShare/cc\n\n# for clean boxes, bootstrap ant+antcc\n# .\\antcc\\bootstrap\\install.ps1\n\nant boot\nant up staging test\n```\n\nOn Docker:\n\n```bash\nCC_REG=daerepository03.eur.ad.sag:4443/ccdevops \\\nEMPOWER_USR=you@company.com \\\nEMPOWER_PSW=**** \\\nCC_ENV=staging \\\ndocker-compose run --rm init staging\n```\n\n## Cleanup\n\nUninstall Command Central.\n\nOn Linux run:\n\n```bash\nant uninstall -Dbootstrap=YOUR_BOOT_NAME\n```\n\n\u003e NOTE: `uninstall` target is currently NOT supported on Windows\n\nOn Docker:\n\n```bash\ndocker-compose down\n```\n\n_____________\nContact us at [TECHcommunity](mailto:technologycommunity@softwareag.com?subject=Github/SoftwareAG) if you have any questions.\n___________________\nFor more information you can Ask a Question in the [TECHcommunity Forums](https://tech.forums.softwareag.com/tags/c/forum/1/Command-Central).\n\nYou can find additional information in the [Software AG TECHcommunity](https://tech.forums.softwareag.com/tag/command-central).\n___________________\nThese tools are provided as-is and without warranty or support. They do not constitute part of the webMethods product suite. Users are free to use, fork and modify them, subject to the license agreement. While we welcome contributions, we cannot guarantee to include every contribution in the master project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibm-wm-transition%2Fsagdevops-cc-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fibm-wm-transition%2Fsagdevops-cc-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fibm-wm-transition%2Fsagdevops-cc-server/lists"}