Available from
9.2.24.
To migrate computers between two data sources, start by enabling
computer reconciliation mode. Then, migrate a subset of computers to verify that the process works.
After you verify that the process works, complete it for the remaining computers. You can migrate
computers between two BigFix® data sources, from a
BigFix data source to a disconnected data source,
or the other way round.
Before you begin
If you are migrating computers to a BigFix data source, it must be at least in version 9.5
patch 5 for the reconciliation mode to work properly. If you are migrating computers from a BigFix data source, its version is irrelevant for
reconciliation to work.
Important: Ensure that you first check and enable computer
reconciliation mode if needed and then migrate computers between data sources. If you enable
computer reconciliation after you migrate some computers, the computers are duplicated in License Metric Tool as existing both in the old and new data source.
They have different IDs instead of being mapped as having the same ID. In this case, the
reconciliation mode is not able to map the computers. If computers are duplicated in License Metric Tool before you start the reconciliation, remove the
duplicates. Then, enable the reconciliation.
Note: Migrate computers with BigFix server client and the BigFix console only after you
migrate the entire environment and confirm that the new setup is working. Maintaining this order
ensures the connectivity to the old BigFix server during the entire migration process.
Procedure
- If duplicated computers exist in License Metric Tool, remove the duplicates.
- If you are migrating from a BigFix data
source, perform the following steps.
- Log in to the BigFix console.
- In the navigation tree, click Computers.
- Select computers that are duplicated in License Metric Tool, right-click the selected computers, and click Remove From Database.
- Log in to License Metric Tool and go to
.
Then, click Import Now.
- If you are migrating from a disconnected data source, decommission duplicated computers from
the License Metric Tool
user interface or by using REST API.
- Enable the computers reconciliation mode.
- In License Metric Tool, go to
.
- Change the value of the Enable computers reconciliation parameter
to true.
Tip: It is advisable to enable debug logging during data imports. For more information,
see:
Import logs.
- Migrate a subset of computers from the old data source to the new
one to verify that the process works.
- If you are migrating computers between two BigFix data sources, perform the following steps.
Important: Before you resubscribe endpoints between
BigFix data sources, ensure that they can communicate with
the new
BigFix server. For example, ensure that no
firewall blocks the communication.
If you have any custom relay settings, the settings need to be
re-created after the endpoints are resubscribed between BigFix data sources.
- Download the masthead file of the new BigFix
server from the following URL:
https://<New_BigFix_server_address>:52311/masthead/masthead.afxm.
- Save the downloaded masthead file on the file system of the old BigFix server. Place it in the following directory:
<BESServer_install_dir>/wwwrootbes/Uploads.
- Log in to the old BigFix console, and go to
and run the Switch BES
Client Action Site Masthead fixlet that is appropriate for your version of endpoints on the selected
computers.
Endpoints on which the action completes successfully, stop reporting to the old
BigFix server and start reporting to the new one.
Thus, the action might not be reported as completed in the old BigFix console.
- Go to Computers. Verify that the selected endpoints were resubscribed to
the new BigFix server.
- If you are migrating computers from a BigFix data source to a disconnected data source, perform the following steps.
Option 1: If you want to
install the disconnected scanner using task, perform the following steps.
- Log in to the BigFix console.
- In the navigation bar, click .
- In the upper right pane, select Install Disconnected Scanner on Windows
(version) or Install Disconnected Scanner on Unix
(version) depending on the operating system of the computer on which
you want to install the disconnected scanner.
- Specify the disconnected scanner installation path. Optionally, you can specify other essential
and advanced parameters. Then, run this task. To learn more about the disconnected scanner
installation parameters, see disconnected scanner configuration parameters in setup_config.ini
file.
Note: The task allows to specify only a subset of the available disconnected scanner
configuration parameters. For more information, see the task description.
- Uninstall the BigFix client from the
computers on which you installed the disconnected scanner to ensure that the computers do not report
to both the old and the new data source. For more information, see: Uninstalling the BigFix client.
Important: Do not remove
the computer from the BigFix console until you
make sure the computer correctly migrated to the new data source.
Option 2: If you want to install the disconnected scanner manually, perform the
following steps.
- Log in to the BigFix console.
- In the navigation bar, click .
- In the upper right pane, select Download the Disconnected Scanner Package
(version) or Download the Disconnected Scanner Package for
IBM i (version) depending on the operating system of the computer on
which you want to install the disconnected scanner.
- Uninstall the BigFix client from the
computers on which you want to install the disconnected scanner to ensure that the computers do not
report to both the old and the new data source. For more information, see: Uninstalling the BigFix client.
Important: Do not remove
the computer from the BigFix console until you
make sure the computer correctly migrated to the new data source.
- Install the disconnected scanner. For more information, see: Installing the disconnected scanner and gathering scan results (disconnected scenario).
- If you are migrating computers from a disconnected data source to a BigFix data source, perform the following steps.
- Install the BigFix client on a subset of
computers. For more information, see: Installing the BigFix clients (BigFix scenario).
Important: After you install the BigFix
client on a computer, do not send results of disconnected scan from this computer to License Metric Tool.
- Set up collection of data. For more information, see: Setting up data collection (BigFix scenario).
- Uninstall the disconnected scanner from the computers on which you installed the BigFix client. For more information, see: Uninstalling the disconnected scanner (disconnected scenario).
- Run the import.
- Log in to License Metric Tool and
go to .
- Click Import Now.
After the import, computers from the old data source are identified as
computers from the new data source if their computer names and IP addresses are
matched.
- Verify that data source migration finished successfully.
- Log in to License Metric Tool and
go to
.
- Hover over Configure, and click Configure
View. Select the Data Source Name and Data Source Computer ID columns, and click
Submit.
- Verify that all computers that you wanted to migrate have details of the new data
source in the Data Source Name and Data Source Computer ID columns. Only computers that you did not
want to migrate should have the values of the old data source.
- Repeat steps from 3 to
5 for the remaining computers.
- Optional: Disable the computers reconciliation mode.
Note: You might want to leave the computers reconciliation mode enabled to avoid creating computer
duplicates when the BigFix client is reinstalled
on some of the computers.
- Log in to License Metric Tool and go to
.
- Change the value of the Enable computers reconciliation parameter
to false.
What to do next
It might happen that the IP address (or addresses) or the name of a computer in the old
data source and the new data source differ. In such case, computer reconciliation does not work. The
computer is not matched as the same computer in both data sources and duplicate entries appear in
License Metric Tool. To solve the problem, perform the
following steps.
- Remove the duplicates the same way as in step 1.
- Check the DNS name of the computer that was not matched. The DNS name remains the same even if
the IP address or computer name changes. Thus, it can be used to properly identify the computer.
- Log in to License Metric Tool and go to
.
- Hover over Configure and click Configure
View.
- Select DNS Name and click Submit.
- Find the DNS name of the computer.
- Re-create the bundling.
- Assign the software manually. For more information, see: Assigning components to products and Cloud Paks.
- Migrate the assignments by using REST API.
- To retrieve information about software assignments that were defined for the
particular computer in the old data source, use the following REST API request. The
"is_present","=","0"
filter ensures that you retrieve information about software
assignments as they were defined for the particular computer in the old data source. https://hostname:port/api/sam/v2/software_instances?columns[]=product_name&
columns[]=component_name&columns[]=discovery_path&columns[]=is_charged&columns[]=is_confirmed&
columns[]=computer_dns_name&columns[]=discoverable_guid&columns[]=product_release_guid&columns[]=metric_id&
token=user_token&criteria={"and":[["is_present","=","0"],["computer_dns_name","=","dns_name"]]}
Where:
- user_token
- Token that is used to authenticate REST API requests. For information how to obtain it, see:
Authenticating REST API requests.
- dns_name
- DNS name of the computer that was not matched.
Sample output:{
"total":5,"rows":[
{
"product_name":"IBM Curam Provider Management",
"component_name":"IBM Curam Provider Management Authorized User",
"discovery_path":["/opt/readiness/tags/swTagsRepo"],
"is_charged":1,
"is_confirmed":0,
"computer_dns_name":"dns_name",
"discoverable_guid":"50061b64-e97e-4cb0-9235-349ba4e20aad",
"product_release_guid":"4d7fc123-e05f-46f7-a6c6-e4fafe96fb04",
"metric_id":-18783
},
{
"product_name":"IBM Cognos Enterprise User",
"component_name":"IBM Cognos Advanced Planner License",
"discovery_path":["/opt/readiness/tags/swTagsRepo"],
"is_charged":0,
"is_confirmed":0,
"computer_dns_name":"dns_name",
"discoverable_guid":"52ee8a52-02e4-4dd0-8ae9-b79e42e019c0",
"product_release_guid":"5a6c43b3-d36a-4b8e-a8dd-17ae590f6dc9",
"metric_id":-18783
},
...
]
}
- To migrate the software assignments, use the following PUT request. Use
Body
of
the request that you obtained in step 3.a. It
applies the software assignments to the computer in the new data source. The software assignments
specified in the computer in the old data source stay unmodified.
- Request
-
PUT https://hostname:port/api/sam/v2/software_instances
- Request header
-
Accept: application/json
Accept-Language: en-US
Token: <token>
- Request body
-
{
"rows":[
{
"product_name":"IBM Curam Provider Management",
"component_name":"IBM Curam Provider Management Authorized User",
"discovery_path":["/opt/readiness/tags/swTagsRepo"],
"is_charged":1,
"is_confirmed":0,
"computer_dns_name":"dns_name",
"discoverable_guid":"50061b64-e97e-4cb0-9235-349ba4e20aad",
"product_release_guid":"4d7fc123-e05f-46f7-a6c6-e4fafe96fb04",
"metric_id":-18783
},
{
"product_name":"IBM Cognos Enterprise User",
"component_name":"IBM Cognos Advanced Planner License",
"discovery_path":["/opt/readiness/tags/swTagsRepo"],
"is_charged":0,
"is_confirmed":0,
"computer_dns_name":"dns_name",
"discoverable_guid":"52ee8a52-02e4-4dd0-8ae9-b79e42e019c0",
"product_release_guid":"5a6c43b3-d36a-4b8e-a8dd-17ae590f6dc9",
"metric_id":-18783
},
...
]
}
Sample
output:{"valid_instances":{"Bundled":5},"invalid_instances":{},"unmodified_instances":5}