Importing
...
FinalBuilder Server into Continua
Continua comes packaged with an Import tool that allows you to import your Final Builder Server Projects, Users and Permissions into the Continua CI environment. As Continua CI runs as a continuous environmentand FinalBuilder Server are quite different, some elements of Final Builder server are either unable to be ported across or require additional information to complete the import.
The import itself is a the console app that is located <LOCATION>. This ImportFBS.exe which is located in <Continua install directory>/ContinuaCI/Server on your server. For most situations this app should be called through the command line. For more information please read the Parameters section. This application can be run at any stage after the initial install user has been created within Continua CI.
Required Parameters
/username: This must match an administrator user that has already been created in the Continua CI environment. This includes the intial install user that is created when you setup Continua CI.
/password: The password that matches the user specified in /username.
Optional Parameters
/fbsprojectfolder: This parameter specifies the path where your final builder server data is saved.
- By default, the Final Builder Server installer sets the project directory to "C:\ProgramData\VSoft\FBServer7" and this is the directory that is used if /fbsprojectfolder is not specified. This directory will need to be set if you modified the install path when installing Final Builder Server.
- No individual file needs to be specified, just the folder itself.
- When specifying the folder, do not use quotes.
- The project folder should contain the files as shown in the folder image below.
/logpath: While the import is running, a log will be generated that logs which aspects of Final Builder Server imported correctly into Continua CI and will also identify any errors that may have occurred during the import.
- By default, the log will be created in the /fbsprojectfolder however this can be overridden by setting /logpath.
- This parameter only takes the directory of where the log will be generated.
- No log file name needs to be specified as this log will automatically generate as "ContinuaProjectImportLog.txt".
/hostname: This parameter sets the name of the computer that is hosting the Continua CI server service.
- If no /hostname is specified then "localhost" will be used.
- Do not pass the port number through the /hostname parameter. Instead use the /port parameter.
/port: This parameter sets the port number that will be used to connect to the Continua CI server service.
- By default, Continua CI's server port is set to 9000.
- If the /port parameter is no specified then 9000 is passed to the Continua CI service.
/defaultPassword: For security reasons, Continua CI is unable to import passwords from Final Builder Server to Continua CI. This means that a default password needs to be used as a placeholder for all objects being created in Continua CI that require a password.
...
Once the import has completed, a report will be generated which tells you exactly what was imported. This report also explains any further actions that must be done before your FinalBuilder Server projects can successfully run builds. This report will open automatically in your browser once the import is completed and is also saved to <Program Data>/Vsoft/Continua/Import/FBSImportReport.html. (Note that the <ProgramData> folder differs depending on the version of windows. For Windows 7 users this folder is C:/ProgramData/).
Importing Passwords
FinalBuilder Server passwords cannot be imported into Continua CI. To get around this the FinalBuilder Server Import app has the parameter defaultpassword which acts as a temporary password until Continua CI is completely configured. All password fields imported into Continua CI will be set to this value. When setting this property, make sure it complex enough to pass your password policy. By default, passwords should contain at least 1 upper case and 1 lower case character, 1 number and be at least 6 characters long.
Once the import has completed, make sure you update all your password fields to the correct passwords. This includes password fields on repositories and all standard login users.
If the defaultpassword parameter is not set then the default password will be set to 'Temp123'
Below is an example of the FinalBuilder Server Import Report
...