Update CI/CD Dashboard Code Location for AIQ 5.x

UpdatingRecommended CICDguidance

Dashboard

This Codearticle Locationis forversion-specific to AIQ 5.x.x

Ifenvironments. yourUse CICDit only when maintaining an AIQ 5.x CI/CD dashboard wasor created with a CICD client downloaded frommigrating an Appvanceolder S3dashboard service.,configuration. youFor mustnewer followenvironments, confirm the updatecurrent processdashboard toand pointrepository yourstructure CICDbefore build.xmlapplying filethese tosteps.

your

Before changing code locations

• Confirm the exact AIQ controllerversion, CICDdashboard client.version,

  Therepository, Appvancebranch, S3and deployment path.

• Back up the current dashboard configuration and document the previous code location.
• Check pipeline variables, environment files, service accounts, and artifact paths.
• Confirm permissions for the CI/CD runner and any service that containsreads dashboard code.
• Test changes in a non-production environment first.

Validation checklist

1. Run the CI/CD job that publishes or refreshes the dashboard.
2. Confirm the dashboard reads from the new code location.
3. Verify links to AIQ executions, reports, and artifacts still resolve correctly.
4. Review logs for missing files, permission errors, or stale cache references.
5. Document the final path and rollback instructions.

Obsolescence note: If the AIQ 5.x dashboard is no longer in use, mark this codepage willas belegacy removedor inconsolidate the nearrelevant future.migration If you have not performed the update for your 5.0.0 release your CICD dashboard will not work.

Update build.xml Process

Follow the appropriate steps for your operating system:

Linux / Mac OS

Open a terminal and type the following commands. They will download a file updateGetURL.jar to the folder where you have your build.xml file. Do replace values between <> with your correct values.

cd <folder-with-build.xml-file>

wget http://<aiq controller domain>:8080/UI/container/updateGetURL.jar

java -jar updateGetURL.jar <controller-domain-or-ip> build.xml

Value for <controller-domain-or-ip> can be similar to any of the following:

java -jar updateGetURL.jar ec2-52-52-192-202.us-west-1.compute.amazonaws.com build.xml

java -jar updateGetURL.jar localhost build.xml

java -jar updateGetURL.jar 52.52.192.202 build.xml

java -jar updateGetURL.jar aiq-server.mydomain.com build.xml

Windows

Open a browser and download a file by copying the following URLnote into the browser:active CI/CD documentation.

http://<controller-domain-or-ip>:8080/UI/container/updateGetURL.jar

Copy the downloaded updateGetURL.jar file to the same folder where your build.xml file is located.

Execute the following command in a cmd prompt:

java -jar updateGetURL.jar <controller-domain-or-ip> build.xml

Value for <controller-domain-or-ip> can be similar to any of the following:

java -jar updateGetURL.jar ec2-52-52-192-202.us-west-1.compute.amazonaws.com build.xml

java -jar updateGetURL.jar localhost build.xml

java -jar updateGetURL.jar 52.52.192.202 build.xml

java -jar updateGetURL.jar aiq-server.mydomain.com build.xml

After executing the above commands, open your build.xml file in a text editor and verify that a line similar to the following exists:

<get dest="${lib}/RestClient.jar" src="http://<controller-domain>:8080/UI/container/AppvanceCIClientWithDeps.jar"/>

The text <controller-domain> should be replaced by your controller domain/ip as shown in the controller.json file.

Push the changes to the build.xml file in your repository.

Troubleshooting

In case of any issues running the java updateGetURL.jar, you can manually edit the build.xml file to have the get line to have the src property use your controller to download the client such as :

<get dest="${lib}/RestClient.jar" src="http://<controller-domain>:8080/UI/container/AppvanceCIClientWithDeps.jar"/>