GLPI Network AWS EC2 usage instruction === Amazon Web Services is a cloud services platform that offers a wide range of functionality to business, providing computing resources to host from simple web pages to more elaborated applications, data storage and more. To start using GLPI Network from the AWS, follow these steps to create your account and launch the instance. ## Create an account 1. Go to Amazon Web Services: https://aws.amazon.com 2. Click on **Sign Up**, it will redirect you to another page, click again on create a new account. !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_5a9fa1d94dfa71a9f12695177f79f677.png?private_token=rHs47x2zsv96DxyMUSa_) 3. Fill your information - Email, Password, AWS account name !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_37b9d776d1bfee3840416951aada4d10.png?private_token=rHs47x2zsv96DxyMUSa_) - Contact information !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_e2ea7c6cd3ecb0469e0c6c2e0e77f6b6.png?private_token=rHs47x2zsv96DxyMUSa_) - Payment information !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_c953099340c2c600201de502dc7de88c.png?private_token=rHs47x2zsv96DxyMUSa_) :::success If you create an account for the first time, you'll have 12 months of Free Tier Access :fireworks:. No AWS infrastructure charges will be made to your credit or debit cards as long as you don't pass the limits of the AWS free tier: https://aws.amazon.com/free/ ::: 4. Account verification, you'll receive a phone call asking you to introduce a code through your phone's keypad. 5. Choose a support plan. For more information, see the Compare AWS Plan Support: https://aws.amazon.com/premiumsupport/compare-plans/ 6. Once your account has been activated you'll receive a confirmation email, after this you'll have full access to the Amazon Web Services. :::warning Your payment information can sometimes take 24/48 hours to be verified before you can deploy an EC2 instance. Feel free to create your account in advance! :+1: ::: ## Create a Key pair (if needed) To access and launch EC2 instances, you’ll need a SSH key. :::warning :warning: Save it in a safe place! This key will be displayed to you only once, and it's required to connect to AWS servers and EC2 Linux instances, which means your GLPI. ::: 1. Sign in to your AWS account, go to **My account > AWS Management Console**. 2. After signing in, you'll be redirected to your AWS Management Console. 3. Display all services and select the EC2 service. !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_dd3df45877278c73d3ca8a22ffb84eaa.png?private_token=rHs47x2zsv96DxyMUSa_) 4. Under Network & Security, select Key pairs (1) 5. Click on Create Key Pair (2) !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_d95a394109f5b0b2f78fedc13f59d800.png?private_token=rHs47x2zsv96DxyMUSa_) 6. You'll be prompted for a name 7. A public and private key will be generated, download the private key, remember to **save it in a safe place**. ## Deploy GLPI Network 1. Sign in to your AWS Marketplace account (the same credentials of your AWS account), go to **AWS Marketplace**: https://aws.amazon.com/marketplace/ 2. Search [**GLPI Network Basic**](https://aws.amazon.com/marketplace/pp/B07HG3L944), provided by [**TECLIB**](https://aws.amazon.com/marketplace/seller-profile?id=bd9f7435-59fe-4fa3-9513-9223be41019c), there you'll be able to view the product overview, pricing, usage, support and reviews. 3. Click on **Continue to Subscribe**. !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_45be53f1cc8992bd239ac34ae16cf416.png?private_token=rHs47x2zsv96DxyMUSa_) 4. You’ll be able to review and accept the **Terms and conditions** along with the pricing information (**AWS fees + GLPI Network Basic subscription Support fees**). :::info **Save money by purchasing an annual subscription!** !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_dc35372e3b3eaeec0dcce7cd827fb67c.png?private_token=rHs47x2zsv96DxyMUSa_) ::: 5. After accepting the **Terms and subscribing**, click on **Continue to configuration**. 6. Review the configuration of the instance, make sure the SSH key pair is the same as the one you created previously. !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_01200dc3a7f300e0c44fcdcefa7e2df5.png?private_token=rHs47x2zsv96DxyMUSa_) Here are some metrics for the **EC2 Instance Type** to choose (to readapt according to the GLPI modules used): | Assets | Tickets | Users (no end-users) | EC2 Instance | |-----------|--------------|----------------------|-------------------| | up to 500 | ~2500 / year | up to 10 | t2.medium | | max 1500 | up to 5000 | up to 25 | m3.medium / large | | 2000+ | 10000+ | 50+ | m4.large | 7. When you are ready, click on **Launch**! :airplane: 8. After your GLPI instance has been launched on the server, it’ll have a public DNS. You can retrieve it from the EC2 Dashboard. !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_566e465f307db005ae067116138c8173.png?private_token=rHs47x2zsv96DxyMUSa_) 9. Connect through SSH ([AWS Documentation](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/AccessingInstances.html)), for this you’ll need the username “ubuntu” and the public DNS: ```shell=bash $ ssh ubuntu@ec2-XXX-XX-XXX-X.compute-1.amazonaws.com ``` 10. Use the following command to retrieve the **GLPI** login credentials (**randomly generated when starting your private instance**): ```shell=bash $ sudo cat /opt/teclib/glpi-network-scripts/.glpi-network-credentials ``` !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_a3e48c1e85839b4a4d449158a8c59d5c.png?private_token=rHs47x2zsv96DxyMUSa_) :::warning :warning: **We strongly recommend that retrieve and record this information outside the deployed instance and then delete the file.** ::: 11. Access the application via web browser at http://<EC2_Instance_Public_DNS> 12. Log in with the username "glpi" account and the password you retrieved in step 3 !(https://gitlab.teclib.com/glpi-network/aws_doc/raw/master//pics/upload_fe1f400e748cfe8552c2dc9129222c76.png?private_token=rHs47x2zsv96DxyMUSa_) :::info For more information you can also check the [AWS Documentation regarding EC2](https://docs.aws.amazon.com/ec2/index.html?id=docs_gateway#lang/en_us). ::: ## GLPI Network Support Included (corrective tiers 3) After the first month, send an email to **"edition AT teclib DOT com"** with your **"Customer AWS Account Number"** (like 9999-9999-9999), after checking your subscription agreement, we send you the information to connect to our customer support area.