{"id":19639042,"url":"https://github.com/timsutton/jss-vagrant","last_synced_at":"2025-04-28T18:50:21.036Z","repository":{"id":21366477,"uuid":"24683741","full_name":"timsutton/jss-vagrant","owner":"timsutton","description":"Simple Vagrant environment for bootstrapping a Casper JSS.","archived":false,"fork":false,"pushed_at":"2014-10-01T18:38:36.000Z","size":112,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-11T07:07:05.860Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/timsutton.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-10-01T15:29:30.000Z","updated_at":"2020-12-02T06:43:31.000Z","dependencies_parsed_at":"2022-07-30T03:37:53.364Z","dependency_job_id":null,"html_url":"https://github.com/timsutton/jss-vagrant","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timsutton%2Fjss-vagrant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timsutton%2Fjss-vagrant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timsutton%2Fjss-vagrant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timsutton%2Fjss-vagrant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timsutton","download_url":"https://codeload.github.com/timsutton/jss-vagrant/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234300371,"owners_count":18810607,"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":[],"created_at":"2024-11-11T12:43:54.075Z","updated_at":"2025-01-17T01:47:02.575Z","avatar_url":"https://github.com/timsutton.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"jss-vagrant\n===========\n\nThis is a very basic Vagrant environment that helps you stand up an Ubuntu-based JSS server for test use with the Casper Suite. I built this for the purposes of being able to quickly set up and tear down a local JSS VM for an [AutoPkg](https://autopkg.github.io/autopkg) demo I did at the [MacSysAdmin 2014 Conference](http://macsysadmin.se/2014/Wednesday.html). I had a need for being able to take a test setup around with me and wanted to be able to easily get it back to a known state, and didn't find the JSS Linux installer satisfactory.\n\nIt has been tested with the following Vagrant providers:\n\n* virtualbox (default provider that ships with Vagrant)\n* vmware_fusion (paid VMware provider from Hashicorp)\n* [digital_ocean](https://github.com/smdahlen/vagrant-digitalocean)\n\nAnd has been tested with JSS versions 9.32 and 9.4. As I don't actually use the Casper Suite, I have no intention to continue testing later versions (see below, \"Support\").\n\nThe configuration is done with a single script, `bootstrap.sh`, which configures MySQL and Tomcat using the JSS webapp. The JSS is configured with a self-signed certificate, a more UNIX-like logging directory at `/var/log/jss`, at the default 8443 port.\n\nThe script has support for setting the JSS URL configuration, either manually via the script (which you would typically combine with an `/etc/hosts` entry), or automatically based on the IP address of the first network interface.\n\nSetup\n-----\n\nThe only required steps are to copy a `ROOT.war` file extracted from the \"JSS Manual Installation\" package into the `jss-app` directory of this repo. Leave the name as-is.\n\nOptionally:\n\n* Copy a backup of a preconfigured JSS MySQL database to a file at `data/jss_data.sql` (see guidelines in `bootstrap.sh` for how to do this).\n* Tweak any additional Tomcat and Java settings in the provided `tomcat7-default` and `server.xml` environment files.\n\nShould you need it, the MySQL root user password is `JAMF`, and the credentials for the `jamfsoftware` database are the defaults: user `jamfsoftware`, password `jamfsw03`.\n\nTypically for testing, your backup would contain enough configuration that you can immediately enroll test clients, have distribution point(s) configured, etc. You may wish to start a clean instance from this setup and then make backups as you build up a test environment. You can store different backups wherever you wish, but the only one that gets automatically restored to the server is the one named `jss_data.sql`.\n\n\nProvisioning\n------------\n\nTypically you would provision the instance only once (on initial `up`), or otherwise just destroy and rebuild the VM. The `bootstrap.sh` script was not written to be idempotent, but of course this could all be re-written with a proper configuration management provisioner.\n\n\nSupport\n-------\n\nI don't have plans to continue any development for this setup, as I am not using Casper in production. Hopefully, some others who administrate and test the Casper Suite might find this repo helpful.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimsutton%2Fjss-vagrant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimsutton%2Fjss-vagrant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimsutton%2Fjss-vagrant/lists"}