{"id":23655226,"url":"https://github.com/caplin/persistence-upgrade","last_synced_at":"2025-11-22T07:30:15.047Z","repository":{"id":66350345,"uuid":"69458996","full_name":"caplin/persistence-upgrade","owner":"caplin","description":"Java program to help migrate persisted data from Transformer 6.2 to Transformer 7.0","archived":false,"fork":false,"pushed_at":"2016-10-07T09:24:08.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-12-28T19:52:05.716Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","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/caplin.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-09-28T12:02:58.000Z","updated_at":"2016-09-28T12:03:49.000Z","dependencies_parsed_at":"2023-02-21T16:00:24.015Z","dependency_job_id":null,"html_url":"https://github.com/caplin/persistence-upgrade","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/caplin%2Fpersistence-upgrade","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caplin%2Fpersistence-upgrade/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caplin%2Fpersistence-upgrade/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/caplin%2Fpersistence-upgrade/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/caplin","download_url":"https://codeload.github.com/caplin/persistence-upgrade/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239627287,"owners_count":19670844,"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-12-28T19:51:58.970Z","updated_at":"2025-11-22T07:30:13.697Z","avatar_url":"https://github.com/caplin.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Persistence upgrade tool\n\nA tool that helps migrating data persisted with a Transformer 6.2 to a Transformer 7.0. It supports reading from either a file DB or a java DB (via jdbc) and generates insert statements for the different tables used in version 7. \n\n## Usage:\n - Clone the Repo\n - run `gradle jar` which produces an executable jar file\n - run the program by running `java -jar build/libs/upgradeTool-0.1.jar [options]`\n \n## Examples:\nThe following examples showcase how to run the tool for the different modes (file DB vs java DB)\n### FileDb\nTo run the upgrade tool on a persistence folder run \n```bash\njava -jar build/libs/upgradeTool-0.1.jar --filedb --folder \u003cpath_to_persistence_folder\u003e\n```\n\n### JavaDb\nTo run the upgrade tool with jdbc mode, a JDBC Driver needs to be supplied and made available on the classpath in addition to specifying the correct arguments. When command line arguments contain special characters they need to be quoted.\n```bash\n#Linux/OSX\njava -cp \u003cpath_to_jdbc_driver\u003e:build/libs/upgradeTool-0.1.jar com.caplin.upgradetool.UpgradeTool --driver \u003cdriverName\u003e --url \u003cjdbc url\u003e --user \u003cjdbc user\u003e --password \u003cjdbc password\u003e --table \u003ctable to upgrade data from\u003e --columns \u003cpers_key column name\u003e \u003cpers_val column name\u003e\n\n#Windows\njava -cp \u003cpath_to_jdbc_driver\u003e;build/libs/upgradeTool-0.1.jar com.caplin.upgradetool.UpgradeTool --driver \u003cdriverName\u003e --url \u003cjdbc url\u003e --user \u003cjdbc user\u003e --password \u003cjdbc password\u003e --table \u003ctable to upgrade data from\u003e --columns \u003cpers_key column name\u003e \u003cpers_val column name\u003e\n```\n\n## Notes\n- The command line option `--converters` can be used to override the default classes used in case other modules than the ones that have converters supplied for them need their data upgraded too. This option is a list of class names. The classes must mimplement the `Converter` interface\n- The command line option `--generator` can be used to override the default generator. The default generator prints INSERT statements for the upgraded data to stdout. It might be desirable to directly insert data into the new database tables, in which case a new generator can be supplied. The class must implement the `ConverterVisitor` interface\n- This tool is unsupported and provided as is\n- You're free to modify the code as you see fit\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaplin%2Fpersistence-upgrade","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcaplin%2Fpersistence-upgrade","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcaplin%2Fpersistence-upgrade/lists"}