IDOL 12.13

# Back Up and Restore Community

The Community component stores some of the data about users, agents, and profiles in IDOL Server. Other data is stored in the AgentStore component, which is a specially configured Content component.

TIP: You can back up and restore the AgentStore index in the same way as the main data index. See Back Up and Restore the Data Index.

## Export Community Data

The `Export` action creates an XML file, containing information about all the users in Community, including details, roles, agents, and profiles. User details include any passwords, PIN codes, and e-mail address and details given in user-defined fields. You can use this XML file to recreate a Community setup on a different server, or you can use it as a backup for the exporting server.

You specify the name of the export file in the `ExportFileName` parameter. Use an absolute file name to specify the location to write the file to. By default, it writes to the Community component working directory.

## Import Community Data

The `Import` action imports user details into Community from an export XML file. User details include any roles, agents, and profiles owned by the user. Passwords are automatically hashed and stored if the user data comes from an earlier version of Community. If a user exists in the importing server and the XML data, the user details in the importing server are retained.

The following `Import` action parameters allow you to control the import.

Parameter | Description
--- | ---
`ImportFileName` | The name of the XML file containing the exported user data that you want to import. This parameter is required.
`FastImport` | Whether to use a faster algorithm to process the XML file. This algorithm loads the entire XML file into memory and processes it. If the XML file is small, or your server has plenty of memory available, this improves performance. The default value is `False`.
`UserFields` | A comma-separated list of user fields that you want to import from the XML file. You can use wildcards. Your exported user data might contain setup-specific security fields that you want to discard for the new Community setup. This parameter makes this discard easy. If you do not set this parameter, all user fields are imported.

This action does not affect the contents of the AgentStore component, which is where user, agent, and profile details are kept for basic search. For example, the `Community` action uses the AgentStore for this purpose. Micro Focus recommends that you run an `Index` action after you restore data from an imported XML file. This action indexes the data in Community into the AgentStore component, and ensures that this data is synchronized.

TIP: As an alternative to running actions, you can back up and restore the server, and export and import Community information, by using the Backup/Restore and Community Export/Import tabs on the Console page in the Control section of IDOL Admin.

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.13 | Last updated October 2022

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL 12.13

Topic Title: Back Up and Restore Community