winsw/docs/migrate-to-3-x.md

Migrate to 3.x

Automatic migration

TODO

Manual migration

1. Remove <name> if you don't want it.
2. Remove <description> if you don't want it.
3. Merge <argument> into <arguments>.
4. Merge <startargument> into <startarguments>.
5. Merge <stopargument> into <stoparguments>.
6. Remove <stopparentprocessfirst>.
7. Merge <domain>DomainName</domain> and <user>UserName</user> into <username>DomainName\UserName</username>. If the user account belongs to the built-in domain, you can specify <username>.\UserName</username>.
   • Consider removing <username> and <password> from config file and using <prompt> in interactive context, or --username and --password command-line options in non-interactive context.
8. Remove <waithint>.
9. Remove <sleeptime>.
10. Replace <delayedAutoStart /> with <delayedAutoStart>true</delayedAutoStart>.
11. Replace <interactive /> with <interactive>true</interactive>.
12. Replace <beeponshutdown /> with <beeponshutdown>true</beeponshutdown>.
13. Remove the RunawayProcessKiller extension.
14. Move <mapping>.<map> to <service>.<sharedDirectoryMapping>.<map>. Remove the SharedDirectoryMapper extension.