Upgrading Situate

The following section describes how to upgrade Situate server and agent components for version 1.8.x and later, including any LTS update.

    ## Upgrading Situate Server


### Step 1. Preparation

    - Make sure that the current Situate server is at least running version 1.7.x or later. Prior versions of Situate server are not guarantee to upgrade.
    - Situate agents can be upgraded from any version
    - Do a complete backup of the Situate server directory prior to any future steps


### Step 2. Downloading the Situate Server Packages

A Situate server requires four packages: The agent package, the Java package, the web package and the Server package. Download all of these packages from the downloads page and place them the same directory on the Situate server host.

### Step 3. Performing the Situate Server Upgrade

The upgrade is performed by running the server installation package. The installer will detect your current installation and strongly suggest you upgrade. As part of the upgrade process, the server installer will also install the agent, java and web packages. NOTE: If the installer does NOT find all required packages it will exit to prevent an incomplete upgrade.

EXAMPLE

```

$ su (become root) ./situate-1.8.4.16-server-linux-2.6-x86_64-64.shar

Simply respond "yes" the "Upgrade existing instance? [yes/no]".   The installer will then prompt to make sure you have backed up your server. Answer "yes"
    to the question, "Has /opt/situate been backed up? [yes/no], when you are confident a backup has been completed."


The script will take care of the rest. When it completes, your upgraded Situate server will be running.


        ## Performing the Agent Upgrade - Linux



As mentioned earlier, Situate agents, only persist tasks logs for those tasks which have run on
        these specific assets. The upgrade process lets you chose to move that data forward or just ignore it.
        ***WARNING:** If the data is not included as part of the upgrade then it will NOT be possible
        to get the historical task information.


The Situate agent installation process has not changed from the previous release, with one exception. It is now
        possible to specify the install with a -u switch to indicate upgrade the agent. This will tell the installation
        script to move over any existing task logs.

    ### Step 1. Perform the Situate Agent Install or Upgrade


 The Situate agent requires only the agent installation package. Download this package from
        the [downloads page](https://www.xonasoftware.com/page_downloads.php)


As "root" (or another privileged user) execute the installation package required for the core Situate agent.
    Refer to the [Situate-Unix-Install](page-help-v3.php?topic=unix-inst) for additional details.


EXAMPLE


Installing a new agent requires no switches, as seen in the following example

    ```
$ su     (become root)
./situate-1.8.4.16-agent-linux-2.6-x86_64-64.shar

EXAMPLE

Upgrading an existing agent and insuring task logs are maintained requires the -u switch

```

$ su (become root) ./situate-1.8.4.16-agent-linux-2.6-x86_64-64.shar

The script will take care of the rest. When it completes, your upgraded Situate agent will be running.




        ## Perform Agent Upgrade - Windows


    ### Step 1. Download Windows Agent MSI Package


 The Situate agent requires only the agent installation package. Download the appropriate MSI package from
        the [downloads page](https://www.xonasoftware.com/page_downloads.php)

    ### Step 2. Install MSI Package


As "Administrator" (or another user with Administrator rights) simply right-click on the MSI package downloaded in the previous step.
        The MSI should take care of the rest. *NOTE: Depending on the environment, it may require a reboot of the Windows machine*