Skip to content

Latest commit

 

History

History
158 lines (126 loc) · 4.64 KB

README(EN).md

File metadata and controls

158 lines (126 loc) · 4.64 KB
Raw

EMLauncher

Setup

This is the process to run EMLauncher in AmazonLinux of EC2.

1. Launch EC2 instance

Once the instance is established, permit HTTP(80) in the security group setting.

In the case of t1.micro, there are cases of lack of memory, it is necessary to prepare swap file.

sudo dd if=/dev/zero of=/swapfile bs=1M count=1024
sudo mkswap /swapfile
sudo swapon /swapfile
sudo sh -c "echo '/swapfile swap swap defaults 0 0' >> /etc/fstab"

2. Install required packages

sudo amazon-linux-extras install php8.2
sudo amazon-linux-extras install mariadb10.5
sudo amazon-linux-extras install memcached1.5
sudo yum groupinstall "Development Tools"
sudo yum install httpd php php-gd php-mbstring php-xml git php-devel php-pear zlib-devel libmemcached.x86_64 libmemcached-devel.x86_64 ImageMagick.x86_64 ImageMagick-devel.x86_64 libzip-devel.x86_64
sudo pecl install igbinary
sudo pecl install msgpack
sudo pecl install memcached
sudo pecl install imagick
sudo sh -c "echo 'extension=imagick.so' > /etc/php.d/40-imagick.ini"
sudo sh -c 'cat <<EOF > /etc/php.d/50-memcached.ini
extension=memcached.so

[memcached]
memcached.sess_locking = On
memcached.sess_lock_wait_min = 1000
memcached.sess_lock_wait_max = 2000
memcached.sess_lock_retries = 5
memcached.sess_lock_expire = 0
memcached.sess_prefix = "memc.sess.key."
memcached.sess_persistent = Off
memcached.sess_consistent_hash = On
memcached.sess_remove_failed_servers = Off
memcached.sess_number_of_replicas = 0
memcached.sess_binary_protocol = On
memcached.sess_randomize_replica_read = Off
memcached.sess_connect_timeout = 1000
memcached.sess_sasl_username = NULL
memcached.sess_sasl_password = NULL
memcached.compression_type = "fastlz"
memcached.compression_factor = "1.3"
memcached.compression_threshold = 2000
memcached.serializer = "igbinary"
memcached.store_retry_count = 2
memcached.default_consistent_hash = Off
memcached.default_binary_protocol = Off
memcached.default_connect_timeout = 0
EOF'
curl -sS https://getcomposer.org/installer | php
sudo cp composer.phar /usr/local/bin/composer

3. Deploy codes

git clone https://github.com/KLab/emlauncher.git
cd emlauncher
git submodule init
git submodule update
composer install

Please modify the permission so that Apache can access the file.

4. Apache setup

Edit /etc/httpd/conf/httpd.conf

DocumentRoot "/path/to/emlauncher/web"
SetEnv MFW_ENV 'ec2'
<Directory "/path/to/emlauncher/web">
  AllowOverride All
  ...abbreviated..
</Directory>
sudo systemctl start httpd
sudo systemctl enable httpd

5. Database setup

sudo systemctl start mariadb
sudo systemctl enable mariadb

Create file with username and password of DB.

Eg:

echo 'emlauncher:password' > $HOME/dbauth

Modify the passwords of data/sql/database.sql, and send to MySQL.

sudo mysql -uroot < /path/to/emlauncher/data/sql/database.sql
sudo mysql -uroot emlauncher < /path/to/emlauncher/data/sql/tables.sql

6. Memcache setup

sudo systemctl start memcached
sudo systemctl enable memcached

7. Setup bundletool for Android App Bundle

sudo yum install java-1.8.0-openjdk-headless
curl -sLO https://github.com/google/bundletool/releases/download/1.15.1/bundletool-all-1.15.1.jar

Here will also have a keystore for re-signing the generate APK. The password, keystore file name, and alias name to be set here will be described later in the configuration file emlauncher_config.php.

keytool -genkey -keystore {emlauncher-keystore.jks} -keyalg RSA -keysize 2048 -validity 10000 -alias {key-alias}

When Running on a platform with AARCH64(ARM64) architecture

When Running on the platform of AARCH64(ARM64) architecture, aapt2 included in bundletool is for AMD64(x86_64) architecture and does not work as it is, so download aapt2 for ARM64 architecture from github.

curl -sLO https://github.com/JonForShort/android-tools/raw/master/build/android-9.0.0_r33/aapt2/arm64-v8a/bin/aapt2

8. Configuration

mfw_serverevn_config.php

Copy config/mfw_serverenv_config_sample.php,and rewrite $serverenv_config['ec2']['database']['authfile'] to the path of dbauth file that was created at 5.

emlauncher_config.php

Copy config/emlauncher_config_sample.php, and rewrite to match your own environment.

Create bucket that will be assigned to bucket name of S3 in advance.

When running on a platform with AARCH64(ARM64) architecture

Specify the path of the aapt2 executable file for ARM64 downloaded at section (6.) in aapt2 of the APK file settings.

9. Complete

Access instance with HTTP in browser. When the login page of EMLauncher is displayed, it’s complete.