Special instructions for 4.x to 5.x or 6.x offline updates

Hello everyone,

For those of you with offline environments where you cannot use our online updater, you probably already know we have a special process in place on how to update between builds.

To go from any of the openSUSE builds of vOPS 4.x (which is 4.2 through 4.7.1) to 5.0 or any subsequent release you'll need an extra step in addition to the normal manual-up.sh process (I will detail this process later on for those unfamiliar with it).

We refer to this process as "premigration" and the steps detailing it are as follows:

Download the following files:

http://ftp.vkernel.com/downloads/vkernel/bundles/premigration.zip

http://ftp.vkernel.com/downloads/vkernel/bundles/apache-ant-1.8.3-bin.tar.gz

http://ftp.vkernel.com/downloads/vkernel/bundles/rest-api-schemas.jar

http://ftp.vkernel.com/downloads/vkernel/bundles/vcloud-java-sdk.jar

http://ftp.vkernel.com/downloads/vkernel/bundles/httpcomponents-client-4.2.1-bin.tar.gz

http://ftp.vkernel.com/downloads/vkernel/bundles/commons-lang-2.6-bin.tar.gz

Extract premigration.zip. It contains only one file: premigration.xml

Upload the files to /usr/local/vkernel/tools/pre-migration.  An ls of the directory should now have the following:

premigration.xml

apache-ant-1.8.3-bin.tar.gz

rest-api-schemas.jar

vcloud-java-sdk.jar

httpcomponents-client-4.2.1-bin.tar.gz

commons-lang-2.6-bin.tar.gz

Now we need to copy the links to the build we're going to apply.

http://ftp.vkernel.com/downloads/vkernel/06a7238c-6ad9-42fd-b692-ce8277377824/updates/latest/VKernel.zip

http://ftp.vkernel.com/downloads/vkernel/06a7238c-6ad9-42fd-b692-ce8277377824/tools/latest/deploy.zip

Download both of these files. Extract deploy.zip, but do not extract VKernel.zip. Copy VKernel.zip & the contents of deploy.zip (4 files) over to this directory on the appliance (WinSCP will do this easily): /usr/local/vkernel/tools/ant

Open a VI client console or putty session to the appliance and execute these commands as the root user:

cd /usr/local/vkernel/tools/pre-migration
ant -f premigration.xml manual

After this is done, LOG OFF AND LOG BACK IN TO THE COMMAND LINE SESSION(not the GUI). Execute the logout command until you reach a prompt to log back in or your SSH session disconnects.

This is extremely important, it runs scripts that make critical changes.

Once you log back in, execute this command to verify the premigration made its changes successfully:

echo $ANT_HOME

If it returns the following value, it worked successfully*:

/usr/local/ant

Now we need to apply the build we downloaded earlier.

Perform the following commands in the console, in order:

cd /usr/local/vkernel/tools/ant/
chmod 755 manual-up.sh
./manual-up.sh

The script will at some point prompt for a backup. Default answer is yes, so either hit enter or, to skip, type no and then hit enter to continue. When the script is done, the update is complete.

*If it returns ANY OTHER VALUE, there was a problem with the script and you should make the following changes manually:

vi /etc/profile.d/ant.sh

Change the top line to read:

export ANT_HOME=/usr/local/ant/

Save and exit the file and log off and back on again. Re-run echo $ANT_HOME to test. It should be correct now.