ALERT: Some images may not load properly within the Knowledge Base Article. If you see a broken image, please right-click and select 'Open image in a new tab'. We apologize for this inconvenience.

What configuration changes are required for changing the IP address and Hostname of an existing TDM Server

book

Article ID: 238287

calendar_today

Updated On:

Products

CA Test Data Manager (Data Finder / Grid Tools)

Issue/Introduction

We are planning to migrate our current production TDM 4.8.1 Server to New Server hardware that is also running TDM 4.8.1 in a staging area. We have already validated the new TDM installation, and need to change the new server to use the old IP Address and possibly hostname, so the system migration is seamless for our users.  What will need to be changed in TDM once the hostname and IP are changed? 

 

 

Environment

Release : 4.8

Component : TDM Web Portal

Resolution

Engineering confirmed that changing the IP address of the TDM server is not a problem, and nothing will need to be done from a TDM perspective for changing the IP Address.

However, if the hostname needs to be changed, there will be updates that need to be done for some configurations. We recommend:

For TDM Portal:

  1. Stop the CA Test Data Manager Portal service
  2. Modify the E:\Program Files\CA\CA Test Data Manager Portal\conf\application.properties file, and replace the current hostname of the new server with the name of the old server. There will be serveral places where the hostname is referenced. Therefore, it may be best to run a Find/replace to ensure all references are updated.
  3. Save the changes to the application.properties file
  4. Navigate to %ProgramData%\CA\CA Test Data Manager Portal\logs, and clear out the old log files. This will give you a copy of fresh logs in case there are any problems with the Portal service.
  5. Start the CA Test Data Manager Portal Service
  6. Log into TDM Portal once all the microservices have started, and verify you can access Portal.

For TDoD (GTService): .

  1. Open a Windows File Explorer and navigate to where TDoD is installed. I think this would be E:\Grid-Tools\TDoD\TDoD_ConfigEditor
  2. Launch the TDoDConfigEditor.exe
  3. In the "Configure Service" tab. This tab is used to configure the connection to the gtrep database.
  4. In the "Connection Sting" tab, ensure the correct gtrep DB connection information is entered here. It should be correct, nothing should have changed here.
    https://api-broadcom-ca.wolkenservicedesk.com/attachment/get_attachment_content?uniqueFileId=qCB5Fzp00zgi2kA/wcD9wQ==
  5. If any changes were made, click the "Save" button. 
  6. Click the "Verify" button to verify the connection to the gtrep database.
    https://api-broadcom-ca.wolkenservicedesk.com/attachment/get_attachment_content?uniqueFileId=IjqV/B63LVD0N8bvB+bYrA==
  7. Click the "Get Service Status" to verify if the service is running or not. If changes were made, you will need to restart the service before the changes will take effect.  
  8. Select the "Configure Portal" tab
  9. Update the "Service URL" field to use the correct hostname. Note, the port will remain the same: 8090.
    https://api-broadcom-ca.wolkenservicedesk.com/attachment/get_attachment_content?uniqueFileId=7xys+OGIBW7XObps6BeUCQ==
  10. Click the "Save" button
  11. Click the "Verify" button 
    https://api-broadcom-ca.wolkenservicedesk.com/attachment/get_attachment_content?uniqueFileId=MY4FitVkEB6IpamCwoaKUw==
    Note: The error related to ALM Service is expected and can be ignored since we aren't configuring the ALM Service because it is not used/needed.

For GT Datamaker:

  1. Launch GT Datamaker
  2. Once logged in, go to the Security tab. You will be asked to log in again.
  3. Under "Users and Groups" select the "Service Layer" tab
  4. Modify the Primary Service URL to reflect the hostname or IP address change. This will be the same URL configured in the TDoD Configuration Editor - Configure Portal tab - Service URL field that we verified above.
  5. Click the Save button.
  6. You should see the Build Date and Build Version fields populated if successful
    https://api-broadcom-ca.wolkenservicedesk.com/attachment/get_attachment_content?uniqueFileId=ETZeiAudOtQd2sgPh5Y/bQ==