Before upgrading a Filr deployment, you must ensure certain requirements are met. See Before You Upgrade! and then complete the instructions in the following sections in order:
Failure to comply with the following critical points could result in a non-functional Filr system.
Review the Release Notes:
Check Upgrade Filr
and Upgrading Filr
known issues in the Filr 5.0 Release Notes before you start the upgrade process.
Ensure that the VM host has enough unformatted disk space:
System Disk (/): A 50 GB disk is created automatically.
Disk 2 (/vastorage): You make a copy of the appliance’s Disk 2.
Each Disk 3 (/var): You create this disk. The recommended size is 4 GB plus 3 times the appliance’s RAM allocation.
Check the version: Make sure that the existing appliance is running version 4.3.x with the latest patches applied.
Remove VMware Snapshots: Before copying Disk 2, make sure to remove all VMware snapshots so that the /vastorage disk has the correct disk file and latest configuration settings.
Filr Database User Name Changed: If the earlier Filr database was configured with an user name other than ‘filr’, the upgrade fails. Ensure to reconfigure the earlier Filr appliance with Filr database user name as ‘filr’ before performing upgrade.
If the appliance has two network adapters: You should manually add them after upgrading the appliance.
After ensuring that you have met the prerequisites and cautions above, complete the instructions in the following sections in order.
If you have upgraded a small Filr deployment before, the following reminder might be all you need.
Figure 10-2 Overview of the Small Filr Appliance Upgrade Process
Download and prepare the software for your virtualization platform as described in the following sections:
Download the Filr appliance software to your management workstation.
IMPORTANT:Registration with Micro Focus is required to receive an email with a software-download link.
Extract the .ova.zip file on your management workstation until a Filr-version folder appears.
Launch VMware and navigate to the datastore where you plan to host the upgraded VM.
Create a folder for the new appliance with a name that is easily associated with (but not the same as) the VM name of the appliance being upgraded.
Log in to the Hyper-V host server either locally or from a remote workstation using Remote Desktop.
Download the Filr appliance software to the location where you plan to host your upgraded VMs.
IMPORTANT:Registration with Micro Focus is required to receive an email with a software-download link.
Extract the .vhdx.zip file in the directory where you downloaded it until an Filr-version.vhdx archive file appears.
Create a directory for the new appliance with a name that is easily associated with, but not the same as the VM name of the appliance being upgraded.
Move the Filr-version.vhdx archive file to the folder you just created.
Log in to the Xen VM host server either locally or from a remote workstation.
If you are connecting from a remote Linux workstation, use the following command:
ssh -X root@host_ip_address
The -X in the command in required for the GUI installation program upon which the steps in this section are based.
Download the Filr appliance software to the Xen VM host server in the location where you plan to host your upgraded VM.
IMPORTANT:Registration with Micro Focus is required to receive an email with a download link.
On a workstation with Citrix XenCenter installed, download the Filr appliance software.
IMPORTANT:Registration with Micro Focus is required to receive an email with a download link.
Extract .xvz file on your management workstation until a Filr-version folder appears.
IMPORTANT:
VMware requires shutting down an appliance before copying a disk.
This means that Filr services will be down while disk copying takes place.
On Citrix Xen you export
rather than copying Disk 2.
Using the tools provided by your hypervisor, copy the /vastorage (second disk) to its associated folder or directory that you created for your upgraded appliances in Downloading and Preparing Software.
Shut down the Filr appliance using the Port 9443 Appliance Console.
Continue with the instructions for your VM platform:
Complete the steps in Table 10-5.
Table 10-5 Upgrading the Filr VMware VM
Page, Dialog, or Option |
Do This |
---|---|
|
1 - Launching the Web browser.
|
2 - Deploying the OVA Template and naming the VM.
|
|
3 - Editing the VM settings. |
|
vSphere Client |
|
Virtual Machine Properties |
|
|
4 - Configuring Disk 2 (/vastorage) |
Virtual Machine Properties |
|
Add Hardware |
|
|
5 - Adding and Configuring Disk 3 (/var) |
Virtual Machine Properties |
|
Add Hardware |
|
|
6 - (Optional) Adding a Network Adapter You can add a network adapter if your Filr deployment accesses a separate network for one or more of the following reasons:
|
Virtual Machine Properties |
|
Add Hardware |
|
vSphere Client |
|
Complete the steps in Table 10-6.
Table 10-6 Upgrading a Filr Hyper-V VM
Page, Dialog, or Option |
Do This |
---|---|
1 - Open Hyper-V Manager. |
|
Hyper-V Host Server |
|
|
2 - Create a new VM. |
Hyper-V Manager |
|
Specify Name and Location |
|
Specify Generation |
|
|
3 - Specify memory |
Assign Memory |
|
4 - Assign network adapter |
|
Configure Networking |
|
|
6 - Identify the system disk |
Connect Virtual Hard Disk |
|
Summary |
|
|
7 - Specify processors |
Hyper-V Manager |
|
Processor |
|
|
8 - Use existing copy of hard Disk 2 (/vastorage). |
Settings for VM on Host Server |
|
|
9 - Add hard Disk 3 (/var). |
Hyper-V Manager |
|
Summary |
|
10 - (Optional) Add a Network Adapter
|
|
Hyper-V Manager |
11 - Deploy the upgraded appliance
|
Complete the steps in Table 10-7.
Table 10-7 Upgrading and Deploying a Filr Xen VM
Page, Dialog, or Option |
Do This |
---|---|
1 - Launch the installer. |
|
Terminal prompt on Xen VM Host Server |
|
Create a new virtual machine |
|
Storage path and Operating System |
|
Choose Memory and CPU settings |
|
|
2 - Name the VM. |
Name of Virtual Machine |
|
|
3 - Configure Disk 2 (/vastorage) |
Hardware |
|
|
4- Configure Disk 3 (/var) |
|
|
|
5 - (Optional) Add a Network Adapter You can add a network adapter if your Filr deployment accesses a separate network for one or more of the following reasons:
|
Summary |
|
Network Adapters |
|
Virtual Network Adapter |
|
Network Adapters |
|
Summary |
|
Console |
6 - Deploy the Appliance
|
Port 9443 Admin Console |
|
Complete the steps in Table 10-8.
Table 10-8 Upgrading a Citrix Xen VM
Page, Dialog, or Option |
Do This |
---|---|
|
1 - Launch XenCenter. |
Management Workstation |
|
XenCenter |
|
|
2 - Import the system disk |
Locate the File you want to import |
|
Select the location where the imported VM will be placed |
|
Select target storage |
|
|
3 - Select the network adapter |
Select network to connect VM |
|
Review the import settings |
|
|
4 - Specify Memory |
|
|
|
5 - Specify Processors |
|
|
|
6 - Link to Disk 2 (/vastorage) |
|
|
|
8 - Add Disk 3 (/var) |
Virtual Disks |
|
Add Virtual Disk |
|
9 - (Optional) Add a Network Adapter You can add a network adapter if your Filr deployment accesses a separate network for one or more of the following reasons:
|
|
|
|
XenCenter |
|
Power on the appliance.
Access the appliance’s console.
When prompted, enter the root and vaadmin passwords for the appliance.
The upgrade process proceeds automatically.
When the appliance displays the final screen in the console window, open your management browser and log in to the appliance on port 9443 as the vaadmin user.
Check the following:
PosgtgreSQL :
Click the phpPgAdmin icon.
Verify that the database is populated as expected.
Filr:
Click the Filr configuration icon.
Ensure that all of the settings are in place as expected.
If the configuration wizard displays, there was a problem with the configuration.
Resolve the configuration issues, then click Finish to reconfigure the system.
Common configuration issues include:
If your system is not using DNS, the most likely problem is unresolvable DNS names and missing /etc/hosts entries.
If the appliance doesn’t have access to the database, ensure that all of the settings are as expected.
When the appliance is running, continue with Performing Post-Upgrade Tasks.
After upgrading to a new version of Filr, you should perform the following tasks to ensure a fully functional Filr system:
Upgraded Filr appliances have a 60-day evaluation license installed. The evaluation license is expired in most of the cases because it considers the day of deployment as the day when it was installed with the earlier version.
To prevent a service interruption, you must install your new license by following the instructions in Installing/Updating the Filr License
in the Filr 5.0: Administrative UI Reference.
For optimal performance of Filr appliance, the minimum Java heap space should be 12 GB. After upgrading the appliance, the Java heap space is overwritten with the value that was set for the earlier Filr appliance. If new value is less, then ensure to update it to 12 GB or greater.