FileFlex Help Topics
Page tree

Versions Compared

Old Version 15

changes.mady.by.user Zafar Subzwari

Saved on

compared with

New Version Current

changes.mady.by.user Zafar Subzwari

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

6.2. If it returns Ubuntu 18.xx.xx you should manually upgrade OS through the terminal 

  • Run sudo mv /etc/apt/sources.list.d/ffs.list /etc/apt/sources.list.d/ffs.list.back to disable temporary fileflex repository 
  • Run sudo apt-get update
  • Run sudo apt dist-upgrade
    This will upgrade the OS system and all system packages to Ubuntu 18.04.6.
    Reboot the system when requested once the upgrade process completes.
  • If system reboot is not requested use the sudo reboot command
  • After system reboot, login to server console and type sudo do-release-upgrade --mode=server -f DistUpgradeViewNonInteractive 
    This command will upgrade system to new release 18.04. 
    During this step upgrade you might be asked to     keep sysctl.conf file
    Image Removed
    Type N or O
  • Run sudo reboot to restart the system
  •  Use the  lsb_release -a command to check the OS version. It should point to Release: 18.04.
  • Enable fileflex repository running sudo mv /etc/apt/sources.list.d/ffs.list.back /etc/apt/sources.list.d/ffs.list
  • Run  sudo apt-get update  
  • Load FileFlex Server Administration page
  • Press the Upgrade Machine button 

    • If you encounter any issues during the upgrade process refer to the troubleshooting list. 

    Troubleshooting 

    If you encounter any issues during the upgrade process refer to the current troubleshooting list. 

    1. If you see the following:

    This means that you have to retype again sudo /opt/ffs/os_upgrade.sh in a while. The lock of the resource will be self released.

    The lock message may be seen after rebooting when the upgrade script results as well, so be sure to look for it when the upgrade resumes post-restart.

    2. If for some reason the process is aborted, please do the following:

    1. If you host machine is running under Windows, install WinSCP program, if it is not already installed. If your host machine is OSX or some linux distribution, then skip this step
    2. Connect to the Virtual machine with WinSCP by creating a session with SCP protocol and supplying credentials of the sadmin user.
    3. Navigate to path "/var/log" and download the file syslog
    4. Make a capture of terminal reporting a problem as well
    5. Send email to support@fileflexcom with both the log and the capture

    3. If for some reason there are packages in apt cache marked as upgradable or system needs reboot during previous system update  do-release-upgrade part of script will not work but script will continue on update steps in os_upgrade.sh 

    The part of script with apt-get upgrade after do-release-upgrade will upgrade ffs packages on not upgraded OS 16. Unfortunately ffs packages are not compatible with Ubuntu 16 and python version < 3.6.9 and thus they left in broken state.  To fix such situation:

  • Disable fileflex repository.
    sudo mv /etc/apt/sources.list.d/ffs.list /etc/apt/sources.list.d/ffs.list.back
  • Do sudo apt-get update
  • sudo apt-get upgrade
  • sudo apt-get dist-upgrade
  • sudo reboot
  • sudo do-release-upgrade --mode=server -f DistUpgradeViewNonInteractive
  • sudo mv /etc/apt/sources.list.d/ffs.list.back /etc/apt/sources.list.d/ffs.list
  • reboot
    • Update server from serveradmin GUI

    Troubleshooting 

    If you encounter any issues during the upgrade process refer to the current troubleshooting list. 

    1. Connect to the Virtual machine with WinSCP by creating a session with SCP protocol and supplying credentials of the sadmin user.
    2. Navigate to path "/opt/ffs/log/" and download the file os_upgrade.log
    3. Send email to support@fileflexcom with the log file


    Sv translation
    languageen

    Table of Contents

    Problem

    How to upgrade the FileFlex server operating system from Ubuntu 18.04 to Ubuntu 20.04


    Take a snapshot (**IMPORTANT**)

    This is the most important step. Whatever platform you are using to manage the FileFlex Virtual Machine, please take a snapshot of the VM before continuing. 

    Solution 1 - upgrade from Server Admin


    Info
    titleCaution

    Caution & Note: OS upgrade is a very complicated process and we have tried to make it simpler to initiate a OS upgrade from Server Admin however if any process does not go as planned, you will need to revert to snapshot and try our manually prescribed method to upgrade the OS.

    Follow these steps. 

    1. Login into the Server Administration page
    2. Upgrade the FileFlex server to version 3.23.
    3. After this, you will see the icon in SA to upgrade the OS
    4. Take a snapshot of the VM at this step
    5. Stop all servers except Administration and Storage Server
    6. Perform Backup Now from Backup & Restore
    7. Download the newly-created backup to your local storage
    8. Navigate back to the Server Administration page and look for OS Upgrade icon on the right order of the screen
    9. Click on this icon to initiate the upgrade
    10. You will see a warning with instructions 
    12. Click Yes to proceed with the upgrade
    16. The VM will be rebooted multiple times for the upgrade to complete. 

    NOTE: The OS upgrade can take up to 30 to 40 minutes, so give it time to upgrade. 

    How long to wait?

    If anything goes wrong and the VM becomes inaccessible 

    Restore the VM snapshot and follow the manual upgrade process detailed below.

    Solution 2 - manual upgrade with os_upgrade script

    Follow these proposed steps:

    1. Login into Server Administration page
    2. Stop all servers except Administration and Storage Server
    3. Perform Backup Now from Backup & Restore
    4. Download the newly-created backup to your local storage
    5. Depending on where your VM is hosted (VMWare Workstation, VirtualBox, HyperV, etc), go to its terminal and login with the user sadmin

    6. Type lsb_release -a. If it returns Ubuntu 20, then everything is OK and there is no need to continue.

      Distributor ID: Ubuntu
      Description:    Ubuntu 20.04xx.5 x LTS
      Release:        20.04xx
      Codename:       focal


    7. Type sudo /opt/ffs/os_upgrade.sh
    8. The process of upgrading the operating system will start.
    9. It will perform an automatic reboot. Once done, you will be asked again to login
    10. The process will start automatically, no user-interaction is required from your side, just wait to reboot once again
    11. Once ready, you will see: Ubuntu 20.04xx.6x. LTS
    12. And that's it, now you can go back to Server Admin and start all servers in order to continue using our application.

    Solution 3 - manual OS upgrade prior FileFlex script

  • Login into FileFlex Enterprise Server Administration page
  • Stop all servers except Administration and Storage Server
  • Perform Backup Now from Backup & Restore
  • Download the newly-created backup to your local storage
  • Depending on where your VM is hosted (VMWare Workstation, VirtualBox, HyperV, etc), go to its terminal and login the user sadmin

    • Type lsb_release -a.
    6.1. If it returns Ubuntu 20.04.3, go back to Server Administration page and press the Upgrade Machine button

    Distributor ID: Ubuntu
    Description:    Ubuntu 20.04.5 LTS
    Release:        20.04
    Codename:       focal

    E: Could not get lock /var/lib/apt/lists/lock - open (11: Resource temporarily unavailable)
    E: Unable to lock directory /var/lib/apt/lists/
    sadmin@hostname:~#

    Sv translation
    languageja_JP

    問題

    FileFlex サーバーのオペレーティングシステムを Ubuntu16.04 から Ubuntu18.04 にアップグレードする方法

    ソリューション 1- os_upgrade スクリプトを使用してアップグレードする

    次の手順に従ってください。

    1. [サーバー管理] ページにログインします
    2. 管理サーバーと ストレージサーバーを除くすべてのサーバーを停止します
    3. バックアップと復元から今すぐバックアップを実行します
    4. 新しく作成したバックアップをローカルストレージにダウンロードします
    5. VM がホストされている場所 (VMWare Workstation、VirtualBox、HyperV など) に応じて、そのターミナルに移動し、ユーザーsadmin でログインします。

    6. 「lsb_release -a」と入力します。 Ubuntu 18 が返される場合は、問題は発生しておらず、続行する必要はありません。

      ディストリビューター ID: Ubuntu
      説明:    Ubuntu 18.04.3 LTS
      リリース:        18.04
      コードネーム: bionic


    7. 「 sudo /opt/ffs/os_upgrade.sh」と入力します
    8. オペレーティングシステムをアップグレードするプロセスが開始されます。
    9. 自動再起動を実行します。完了すると、再度ログインするように求められます
    10. プロセスは自動的に開始されます。ユーザーの操作は必要ありません。もう一度再起動するのを待つだけです。
    11. 準備ができたら、次のように表示されます。Ubuntu 18.04.3。LTS
    12. これで、サーバー管理に戻ってすべてのサーバーを起動し、アプリケーションを引き続き使用できます。

    ソリューション 2 - FileFlex スクリプトの前に手動で OS アップグレードを行う

    1. FileFlex Enterprise サーバー管理ページにログインします
    2. 管理サーバーとストレージサーバー以外のサーバーをすべて停止します
    3. バックアップと復元から今すぐバックアップを実行します
    4. 新しく作成したバックアップをローカルストレージにダウンロードします
    5. VM がホストされている場所 (VMWare Workstation、VirtualBox、HyperV など) に応じて、そのターミナルに移動し、ユーザー sadmin でログインします。

    6. 「 lsb_release -a.
      6.1.」と入力しますUbuntu 18.04.3 が返される場合は、[サーバー管理] ページに戻り、[マシンのアップグレード] ボタンをクリックします。

      ディストリビューター ID: Ubuntu
      説明:    Ubuntu 18.04.3 LTS
      リリース:        18.04
      コードネーム: bionic

      6.2.Ubuntu 16.xx.xx が返される場合は、ターミナルから手動で OS をアップグレードする必要があります 

    7. sudo mv/etc/apt/sources.list.d/ffs.list/etc/apt/sources.list.d/ffs.list.back を実行して、一時的な FileFlex リポジトリを無効にします 
    8. sudo apt-get update を実行します
    9. sudo apt dist-upgrade
       を実行します。これにより、OS システムとすべてのシステムパッケージが Ubuntu16.04.7 にアップグレードされます。
    10. 注: Oracle VirtualBox で Ubuntu OS をアップグレードする場合は、次のように表示される場合があります。 

      Choose Y or I : install the package maintainer's version  for tools.conf


      このステップのアップグレード中に、clamd パッケージ設定を保持するように求められる場合があります。
       
      [現在インストールされているローカルバージョンを保持する] を選択します
      アップグレードプロセスが完了したら、要求され次第システムを再起動します。
    11. システムの再起動がリクエストされない場合は、 sudo reboot コマンドを使用します
    12. システムの再起動後、サーバーコンソールにログインし、「sudo do-release-upgrade --mode=server -f DistUpgradeViewNonInteractive 
      」と入力します。このコマンドにより、システムは新しいリリース 18.04 にアップグレードされます。
      このステップのアップグレード中      、sysctl.conf ファイル

      TypeN または O を保持するように求められる場合があります
    13. sudo reboot を実行して、システムを再起動します
    14.  lsb_release -a コマンドを使用して、OSのバージョンを確認します。 それにより、次のリリースを指すはずです: 18.04.
    15. sudo mv /etc/apt/sources.list.d/ffs.list.back /etc/apt/sources.list.d/ffs.list を実行している FileFlex リポジトリを有効にします
    16. sudo apt-get 更新を実行します  
    17. [FileFlex サーバー管理]　ページを読み込みます
    18. [マシンのアップグレード] ボタンを押します 

    アップグレードプロセス中に問題が発生した場合は、トラブルシューティングリストを参照してください。 


    トラブルシューティング 

    アップグレードプロセス中に問題が発生した場合は、現行のトラブルシューティングリストを参照してください。 

    1. 以下が発生した場合:

    E: ロックできませんでした /var/lib/apt/lists/lock - open (11: リソースが一時的に利用できません)
    E: ディレクトリ /var/lib/apt/lists/
    sadmin@hostname:~# をロックできません

    その場合、しばらくしてから sudo /opt/ffs/os_upgrade.sh  を再入力する必要があります。リソースのロックは自ずと解放されます。

    再起動後、アップグレードスクリプトがそのようになったときにもロックメッセージが表示される場合があるため、再起動後にアップグレードが再開されたときに確認してください。


    2.何らかの理由でプロセスが中止された場合は、次の手順を実行してください。

    1. ホストマシンが Windows で実行されている場合、WinSCP プログラムがまだインストールされていないときは、インストールします。ホストマシンが OSX または一部の Linux ディストリビューションの場合は、この手順をスキップしてください
    2. SCP プロトコルでセッションを作成し、sadmin ユーザーの認証情報を指定して、WinSCP で仮想マシンに接続します。
    3. パス「/var/log」に移動し、syslog ファイルをダウンロードします
    4. 問題を報告している端末もキャプチャします
    5. ログとキャプチャの両方を記載した E メールを support @ FileFlexcom に送信します

    3.何らかの理由でアップグレード可能としてマークされたパッケージが apt キャッシュにある場合、または以前のシステム更新中にシステムを再起動する必要がある場合、スクリプトの do-release-upgrade の部分は機能しませんが、スクリプトは os_upgrade.sh の更新手順を続行します 

    do-release-upgrade の後に apt-getupgrade を使用するスクリプトの一部は、アップグレードされていない OS16 で ffs パッケージをアップグレードします。残念ながら、ffs パッケージは Ubuntu 16 および python バージョン 3.6.9 以降と互換性がないため、動作しない状態のままになります。  このような状況を修正するには、以下の手順に従ってください。

    1. FileFlex リポジトリを無効にします。
      sudo mv /etc/apt/sources.list.d/ffs.list /etc/apt/sources.list.d/ffs.list.back
    2. Do sudo apt-get update
    3. sudo apt-get upgrade
    4. sudo apt-get dist-upgrade
    5. sudo reboot
    6. sudo do-release-upgrade --mode=server -f DistUpgradeViewNonInteractive
    7. sudo mv /etc/apt/sources.list.d/ffs.list.back /etc/apt/sources.list.d/ffs.list
    8. reboot
    9. serveradmin GUI からサーバーを更新します


    ...