Page Comparison

The following article provides step by step instructions on how to upgrade an iQCloud Appliance.

Instructions

1. Connect to the appliance via SSH with the appropriate  username and password

   Code Block
   language bash
   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

   
   

2. Stop the associated services and processes

   Code Block
   language bash
   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

   
   

3. Backup the configuration of the service and keychains that are stored on the Appliance

   Code Block
   language bash
   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

   
   

4. Download the version 665 1027 update for the appliance

   Code Block
   language bash
   USER@APPLIANCE:/opt/iqas$ wget https://iquate-apscout.s3.eu-west-2.amazonaws.com/iquate-apscout/Fishbowl/releases/reactivemain/server-4.5-appliance-6651027.zip --2019-02-05 11:47:54-- https://iquate-apscout.s3.eu-west-2.amazonaws.com/iquate-apscout/Fishbowl/releases/reactivemain/server-4.5-appliance-6651027.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-6651027.zip’ server-4.5-appliance-6651027.zip 100%[=================================================>] 117.46M 7.99MB/s in 14s 2019-02-05 11:48:17 (8.68 MB/s) - ‘server-4.5-appliance-6651027.zip’ saved [123162005/123162005]

   
   

   Note
   The targets and file versions will change as further releases are made available.

   
   

5. Unzip the archive

   Code Block
   language bash
   USER@APPLIANCE:/opt/iqas$ unzip server-4.5-appliance-6651027.zip Archive: server-4.5-appliance-6651027.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$

   
   

6. Copy the configuration from the backup to the newly extracted discovery service folder.

   Code Block
   language bash
   USER@APPLIANCE:/opt/iqas$ mkdir -p server-4.5/db/ server-4.5/conf/Appliance/ USER@APPLIANCE:/opt/iqas$ cp -fT server-4.5.old/conf/Appliance/config.properties server-4.5/conf/Appliance/config.properties USER@APPLIANCE:/opt/iqas$ cp -fT server-4.5.old/db/keychain.mv.db server-4.5/db/keychain.mv.db USER@APPLIANCE:/opt/iqas$ cp server-fT server-4.5.old/db/account.mv.db server-4.5/db/account.mv.db

   
   

7. Restart the Discovery Service

   Code Block
   language bash
   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

   
   

8. Allow the Discovery Service some time to reconnect & resynchronise with the Cloud platform.

9. 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.

Related articles

...

...