Upgrading from 2.5 to 2.6


Starting the installer

To perform the initial installation you will require the Weave installer .jar file. This can be downloaded from Latest Downloads if you have a current support subscription.

To use the .jar file you will need to open a command prompt (sometimes double-clicking on the .jar file may start the installer, depending upon how the server is setup) and start the installer manually.

The Weave installer .jar file requires an existing version of Java to be available on the server. If the server already contains a Weave instance then you already have Java available, and you just need to specify that Java is used when starting the installer.

For example, assuming that we have Weave 2.5 installed on Windows at c:\weave-2.5\, and the installer .jar file is currently located at d:\temp\weave-installer-2.6.30.jar, then you can initiate the Weave 2.6 installer with the following command:

c:\weave-2.5\jre\bin\java -jar d:\temp\weave-installer-2.6.0.jar

Additionally, if you already know where you want to install the new Weave instance then you can also specify that on the command line, e.g.

c:\weave-2.5\jre\bin\java -jar d:\temp\weave-installer-2.6.0.jar c:\weave-2.6

On Linux the process will be similar, e.g.

/opt/weave-2.5/jre/bin/java -jar /tmp/weave-installer-2.6.0.jar /opt/weave-2.6

If you do not already have a Weave instance available on the server then you may need to install Java, which you can uninstall after you have finished the installation process.

In this case the java command you will have to run will be different because the java executable will be installed in a different location, e.g.

"c:\program files\java\jre1.8.0_45\bin\java" -jar d:\temp\weave-installer-2.6.0.jar

The installation process

Step 1

Installing Weave 2.6.0 is similar to the process required for a standard Weave upgrade, which starts with a Welcome screen.

Step 2

This is followed by the Licence screen, where you must accept the licence agreement before you can proceed.

Step 3

Next you need to choose the location (Target Path) where you want to install the new instance of Weave. If you specified an install location on the command line when starting the installer, then the Target Path should already be showing on the Target Path menu.

Step 4

At this step you are presented with the available installation options.

The installation options are presented in a tree where the individual components are grouped based on their purpose.

The first group of options are the main components. Since we are upgrading an existing Weave instance, select the same set of extensions that you had installed in the previous instance of Weave that you are upgrading.

Step 5

The next step is to choose the port numbers that Weave will be listening on. If you choose the same as those used for your existing Weave instance you can only run one instance of Weave on that server at the one time.

Step 6

The next step is to optionally enable the Telnet service and specify the port it will listen on. The same issues with this port number apply as those from Step 5.

Step 7

This step configures the information required to install the new instance as a service/daemon. It does not install Weave as a service/daemon. That must be done as a separate step after the installation process is completed.

Step 8

If your server needs to access the internet via a proxy you need to fill out the required settings.

Step 9

The next page is shown when the installation process is running and the files are being copied to the new Weave installation directory.

Step 10

The final page is presented once the installation is completed and provides an option to generate an installation script. This script can be used with the installer at a later time to perform the same installation without having to go through the whole process of making the choices via the install GUI. In this way the installer can be run entirely without presenting the GUI and perform the same installation (with the option of installing to a different directory).