The following article provides step by step instructions on how to upgrade an iQCloud Appliance.
Instructions
Connect to the appliance via SSH with the appropriate username and password
USER@MYCOMPUTER:~$ ssh USER@HOSTNAME USER@HOSTNAME's password: Welcome to Ubuntu 16.04.5 LTS (GNU/Linux 4.4.0-103-generic x86_64) * Documentation: https://help.ubuntu.com * Management: https://landscape.canonical.com * Support: https://ubuntu.com/advantage Last login: Mon Feb 4 17:20:56 2019 from 192.168.0.61
Stop the associated services and processes
USER@APPLIANCE:~$ sudo service monit stop USER@APPLIANCE:~$ sudo /opt/communication/stop-communication-layer.sh Stopping communication_websocket-client_1 ... done Stopping communication_rabbitmq-appliance_1 ... done Removing communication_websocket-client_1 ... done Removing communication_rabbitmq-appliance_1 ... done Removing network communication_default USER@APPLIANCE:~$ sudo systemctl stop iqas.service
Backup the configuration of the service and keychains that are stored on the Appliance
USER@APPLIANCE:~$ cd /opt/iqas/ USER@APPLIANCE:/opt/iqas$ rm -rf server-4.5.old USER@APPLIANCE:/opt/iqas$ mv server-4.5 server-4.5.old
Download the version 665 update for the appliance
USER@APPLIANCE:/opt/iqas$ wget https://s3.eu-west-2.amazonaws.com/iquate-apscout/Fishbowl/releases/reactive/server-4.5-appliance-665.zip --2019-02-05 11:47:54-- https://s3.eu-west-2.amazonaws.com/iquate-apscout/Fishbowl/releases/reactive/server-4.5-appliance-665.zip Resolving s3.eu-west-2.amazonaws.com (s3.eu-west-2.amazonaws.com)... 52.95.149.4 Connecting to s3.eu-west-2.amazonaws.com (s3.eu-west-2.amazonaws.com)|52.95.149.4|:443... connected. HTTP request sent, awaiting response... 200 OK Length: 123162005 (117M) [application/zip] Saving to: ‘server-4.5-appliance-665.zip’ server-4.5-appliance-665.zip 100%[=================================================>] 117.46M 7.99MB/s in 14s 2019-02-05 11:48:17 (8.68 MB/s) - ‘server-4.5-appliance-665.zip’ saved [123162005/123162005]
The targets and file versions will change as further releases are made available.
Unzip the archive
USER@APPLIANCE:/opt/iqas$ unzip server-4.5-appliance-665.zip Archive: server-4.5-appliance-665.zip inflating: server-4.5/build.properties inflating: server-4.5/bundle/admin-console-4.5.jar inflating: server-4.5/bundle/appliance-service-catalog-4.5.jar inflating: server-4.5/bundle/appliance-service-discovery-4.5.jar inflating: server-4.5/bundle/appliance-service-dnscache-4.5.jar inflating: server-4.5/bundle/appliance-service-management-4.5.jar inflating: server-4.5/bundle/appliance-service-registration-4.5.jar inflating: server-4.5/bundle/common-4.5.jar inflating: server-4.5/bundle/config-service-4.5.jar inflating: server-4.5/bundle/configuration-manager-4.5.jar inflating: server-4.5/bundle/license-service-4.5.jar inflating: server-4.5/bundle/log-service-4.5.jar inflating: server-4.5/bundle/message-client-rabbitmq-4.5.jar inflating: server-4.5/bundle/message-service-jms-4.5.jar inflating: server-4.5/bundle/message-service-rabbitmq-4.5.jar inflating: server-4.5/bundle/process-manager-4.5.jar inflating: server-4.5/bundle/security-service-4.5.jar inflating: server-4.5/bundle/serialization-service-json-4.5.jar inflating: server-4.5/plugins/plugin-4.5-generic-finalization-ext.zip inflating: server-4.5/plugins/plugin-4.5-generic-initialization-ext.zip inflating: server-4.5/plugins/plugin-4.5-generic-probe-ext.zip inflating: server-4.5/plugins/plugin-4.5-generic-signature-drools.zip inflating: server-4.5/plugins/plugin-4.5-jdbc-oracle-feature.zip inflating: server-4.5/plugins/plugin-4.5-scan-amazon.zip inflating: server-4.5/plugins/plugin-4.5-scan-generic-system.zip inflating: server-4.5/plugins/plugin-4.5-signature-apache-tomcat-application-server-signature.zip inflating: server-4.5/plugins/plugin-4.5-signature-ibm-websphere-application-server-signature.zip inflating: server-4.5/plugins/plugin-4.5-signature-microsoft-iis-web-server-signature.zip inflating: server-4.5/plugins/plugin-4.5-signature-microsoft-sql-server-signature.zip inflating: server-4.5/plugins/plugin-4.5-signature-open-source-nginx-webserver-signature.zip inflating: server-4.5/plugins/plugin-4.5-signature-oracle-application-server-signature.zip inflating: server-4.5/plugins/plugin-4.5-signature-oracle-database-server-signature.zip inflating: server-4.5/plugins/plugin-4.5-signature-oracle-iPlanet-web-server-signature.zip inflating: server-4.5/plugins/plugin-4.5-signature-oracle-mysql-database-server-signature.zip inflating: server-4.5/plugins/plugin-4.5-signature-oracle-weblogic-server-signature.zip inflating: server-4.5/plugins/plugin-4.5-signature-vmware-virtualcenter-server-signature.zip inflating: server-4.5/plugins/plugin-4.5-unix-feature.zip inflating: server-4.5/plugins/plugin-4.5-unix-generic-communications-systemext.zip inflating: server-4.5/plugins/plugin-4.5-unix-generic-system.zip inflating: server-4.5/plugins/plugin-4.5-vmware-system.zip inflating: server-4.5/plugins/plugin-4.5-vmware-webservice-feature.zip inflating: server-4.5/plugins/plugin-4.5-windows-communications-systemext.zip inflating: server-4.5/plugins/plugin-4.5-windows-feature.zip inflating: server-4.5/plugins/plugin-4.5-windows-system.zip inflating: server-4.5/plugins/plugin-4.5-xml-extensions-signature.zip inflating: server-4.5/plugins/plugins.properties inflating: server-4.5/conf/.gitignore inflating: server-4.5/conf/json/output.msg inflating: server-4.5/conf/json/schema_core.json inflating: server-4.5/conf/json/schema_element.json inflating: server-4.5/conf/json/schema_jobexecution.json inflating: server-4.5/conf/json/schema_result.json inflating: server-4.5/conf/json/schema_scan.jsonx inflating: server-4.5/conf/json/schema_scaninfo.json inflating: server-4.5/conf/json/test-scan.msg inflating: server-4.5/conf/legacy/schema.xsd inflating: server-4.5/conf/README.md inflating: server-4.5/conf/schema/SCHEMA_catalog.xml inflating: server-4.5/conf/schema/SCHEMA_common.xml inflating: server-4.5/conf/schema/SCHEMA_config.xml inflating: server-4.5/conf/schema/SCHEMA_core.xml inflating: server-4.5/conf/schema/SCHEMA_logs.xml inflating: server-4.5/conf/schema/SCHEMA_metrics.xml inflating: server-4.5/conf/schema/SCHEMA_mngt.xml inflating: server-4.5/conf/schema.xsd inflating: server-4.5/conf/Appliance/config.properties inflating: server-4.5/conf/config.properties inflating: server-4.5/conf/DataSourceService/config.properties inflating: server-4.5/conf/DiscoveryAppliance/config.properties inflating: server-4.5/conf/DiscoveryAppliance/SkipFilter.xml inflating: server-4.5/conf/Keystore/appliance.properties inflating: server-4.5/conf/log4j.properties inflating: server-4.5/conf/log4j.xml inflating: server-4.5/conf/MessagingService/config.properties inflating: server-4.5/conf/pax-logging.properties inflating: server-4.5/conf/rules.ignore inflating: server-4.5/conf/Security/config.properties inflating: server-4.5/org.apache.felix.main-5.6.10.jar inflating: server-4.5/bundle/org.apache.felix.gogo.runtime-1.0.10.jar inflating: server-4.5/bundle/org.apache.felix.gogo.command-1.0.2.jar inflating: server-4.5/bundle/org.osgi.compendium-4.3.1.jar inflating: server-4.5/bundle/jline-3.5.1.jar inflating: server-4.5/bundle/jansi-1.16.jar inflating: server-4.5/bundle/org.apache.felix.gogo.jline-1.0.10.jar inflating: server-4.5/bundle/org.apache.felix.bundlerepository-2.0.10.jar inflating: server-4.5/bundle/org.apache.felix.http.api-2.2.0.jar inflating: server-4.5/bundle/org.apache.felix.http.jetty-2.2.0.jar inflating: server-4.5/bundle/org.apache.felix.http.base-2.2.0.jar inflating: server-4.5/bundle/org.apache.felix.http.whiteboard-2.2.0.jar inflating: server-4.5/bundle/jersey-common-2.26.jar inflating: server-4.5/bundle/javax.ws.rs-api-2.1.jar inflating: server-4.5/bundle/javax.annotation-api-1.2.jar inflating: server-4.5/bundle/javax.inject-1.6.36.jar inflating: server-4.5/bundle/osgi-resource-locator-1.0.1.jar inflating: server-4.5/bundle/jersey-hk2-2.26.jar inflating: server-4.5/bundle/hk2-locator-2.5.0-b42.jar inflating: server-4.5/bundle/aopalliance-repackaged-2.5.0-b42.jar inflating: server-4.5/bundle/hk2-api-2.5.0-b42.jar inflating: server-4.5/bundle/hk2-utils-2.5.0-b42.jar inflating: server-4.5/bundle/javassist-3.22.0-CR2.jar inflating: server-4.5/bundle/validation-api-1.1.0.Final.jar inflating: server-4.5/bundle/commons-csv-1.5.jar inflating: server-4.5/bundle/pax-logging-log4j2-1.10.1.jar inflating: server-4.5/bundle/pax-logging-api-1.10.1.jar inflating: server-4.5/bundle/javax.servlet-api-3.1.0.jar inflating: server-4.5/bundle/jersey-client-2.26.jar inflating: server-4.5/bundle/json-20171018.jar inflating: server-4.5/bundle/bcprov-jdk15on-1.60.jar inflating: server-4.5/felix.sh USER@APPLIANCE:/opt/iqas$
Copy the configuration from the backup to the newly extracted discovery service folder.
USER@APPLIANCE:/opt/iqas$ mkdir -p server-4.5/db/ server-4.5/conf/Appliance/ USER@APPLIANCE:/opt/iqas$ cp server-4.5.old/conf/Appliance/config.properties server-4.5/conf/Appliance/config.properties USER@APPLIANCE:/opt/iqas$ cp server-4.5.old/db/keychain.mv.db server-4.5/db/keychain.mv.db USER@APPLIANCE:/opt/iqas$ cp server-4.5.old/db/account.mv.db server-4.5/db/account.mv.db
Restart the Discovery Service
USER@APPLIANCE:~$ sudo service iqas restart USER@APPLIANCE:~$ sudo /opt/communication/start-communication-layer.sh Removing network communication_default WARNING: Network communication_default not found. Creating network "communication_default" with the default driver Creating communication_rabbitmq-appliance_1 ... Creating communication_rabbitmq-appliance_1 ... done Using the exported TENANT_ID: iquateohio Using the exported APPLIANCE_ID: vmdskohio Using the exported CLOUD_WS_HOST: api.iqcloud.iquate.org Using the exported CLOUD_WS_PORT: 443 Using the exported PROXY_ENABLED: false Using the exported PROXY_HOSTNAME: Using the exported PROXY_PORT: Using the exported PROXY_USERNAME: Using the exported PROXY_PASSWORD: communication_rabbitmq-appliance_1 is up-to-date Creating communication_websocket-client_1 ... Creating communication_websocket-client_1 ... done Rabbitmq Queues is ready websocket-client is ready:Connection to 127.0.0.1 9001 port [tcp/*] succeeded! USER@APPLIANCE:~$ sudo service monit start
- Allow the Discovery Service some time to reconnect & resynchronise with the Cloud platform.
Check the cloud UI under Settings → Appliances and verify that the appliance Last Status is recent, and confirm the appliance version is showing as you would expect.
