If there's a managed version of the Caplin Platform Deployment Framework that's been added to a source control system, you can set it up on another machine, typically by following these steps:
dfwcommand of the Deployment Framework. Before entering any
./dfw <command-name>, make sure your current (working) directory is set to the Deployment Framework's topmost directory.
For a list of
dfwcommands, click here.
./dfw dump, and
./dfw start. Your source control system might detect such new files and ask you if they should be added to source control: always reply NO, since none of these files should ever be added in this way.
- Make sure you've installed Java on the target machine (see Installing Java in Installing the Deployment Framework).
- If the target machine runs Windows, make sure you've you've installed Cygwin (see Installing Cygwin).
- What to do when the target machine doesn't already have the Deployment Framework installed
- What to do when the target machine already has a version of the Deployment Framework installed
On the target machine, retrieve the Deployment Framework files from your source control system.On Windows, retrieve the files under Cygwin with the environment variable
This ensures that the links are created as Windows shortcuts.On Windows XP and Windows 7, always install the Deployment Framework at the highest directory level possible, preferably at the root (for example, at C:\<short_folder_name>). Windows XP has a 259 character limit on file path names (of which 3 characters are reserved for the drive letter and initial \ character), so if the Framework is deployed at a deeper level, some files may not be created when other kits are deployed to the Framework.
If no kits are included in the copy of the Framework that's under source control (for example, Liberator, Transformer, Caplin-supplied blades and locally developed blades), copy any kits you need into the Framework's kits directory.
Run the command
This deploys the Framework and any Liberator, Transformer and blade kits that are in the <Framework-root>/kits/ directory, and then moves the kits to the kits/archive/ directory.
- Update the configuration settings in <Framework-root>/global_config/overrides/ as required (for example, if you need to change the ports used by Liberator and/or Transformer). See:
- On the target machine, run the command
./dfw stopto stop the current copy of the Framework.
Retrieve the Deployment Framework files from your source control system.On Windows, retrieve the files under Cygwin with the environment variable
This ensures that the links are created as Windows shortcuts.
- Merge the contents of the files in the new Framework’s <Framework-root>/global_config/ directory with the equivalent files on the target machine, so that your existing local settings are preserved.
Run the command
This deploys the Framework and any Liberator, Transformer and blade kits that are in the <Framework-root>/kits/ directory, and then moves the kits to the kits/archive/ directory.Running
./dfw deploymoves any kits in the Framework's kits directory into the kits/archive/ directory.