Before you create a Flare connection, complete these prerequisites. The Flare connector uses a Secure File Transfer Protocol (SFTP) staging area to transfer your content to Data 360 and requires Secure Shell (SSH) key authentication. Create a staging area, generate an SSH key pair, and gather your connection details. For instructions, see Working with a Staging Area
Find Your Username and Hostname
After you create the staging area, Data 360 provides a username and hostname. Madcap Flare requires this information when you create your Flare Destination.
- In Data 360, click Setup, and select Data Cloud Setup.
- From the left navigation menu, click Staging Area.
- From the staging area details page, locate the Username and Host Name.
- Copy and save these values in a secure location. You need them when configuring your Flare destination.
Configure Your Flare Target
Decide what content you want to upload to Data 360. Prepare the Flare content and note:
- You will be publishing from an HTML5 target. Other target types are currently not supported.
- Any topic not in the TOC associated with the HTML5 target is not included.
- Any content not saved prior to publishing the target is not included.
- Data 360 expects to receive a ZIP file containing the output of your HTML5 target. As Flare doesn't create this ZIP file as part of the target transformation, you need to add a Post Build Event to the HTML5 Target definition to create this ZIP file. Refer to MadCap's documentation for details.
Configure Your Flare Destination
In Flare, configure a destination to publish content to the Data 360 staging area.
- In Flare, open the Project Organizer and create a destination.
- Set the Type to SFTP.
- Enter the Host Name that you copied from the staging area.
- Set the Port to 22.
- Set the Connection Mode to Active.
- For Directory, enter public_html.
- Set Server Validation to No.
- For Authentication, select Private Key File and provide the path to the SSH Private Key file on your computer (see Generate an SSH Key Pair).
- In the Login Credentials section:
- For Server, enter the Host Name from your Staging Area.
- For Username, enter the Username from your Staging Area.
- You can add a password. There is no requirement for it.