The following article provides step by step instructions on how to upgrade an iQCloud Appliance to version 665
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$ 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 replace server-4.5/build.properties? [y]es, [n]o, [A]ll, [N]one, [r]ename: A 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.
This article was published on
External links and targets for downloads (e.g. wget command above) are correct at the time of publishing.
Over time it is expected that these links will become outdated or changed. If the links above are no longer working, please contact support@iquate.com to confirm the latest version suitable for your environment.
Related articles
Filter by label
There are no items with the selected labels at this time.