Skip to content

Commit

Permalink
Create separate page for setup packages instructions
Browse files Browse the repository at this point in the history
  • Loading branch information
arhimede committed Jul 1, 2024
1 parent ffae005 commit fe5af30
Show file tree
Hide file tree
Showing 3 changed files with 100 additions and 100 deletions.
100 changes: 0 additions & 100 deletions docs/book/v1/setup/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,103 +50,3 @@ passwd: all authentication tokens updated successfully.
Installation successful!
[dotkernel@hostname:~]$
```

## Setup the packages in AlmaLinux 9

Install requirements:

```shell
sudo dnf install epel-release dnf-utils http://rpms.remirepo.net/enterprise/remi-release-9.rpm -y
```

Update/Upgrade system packages:

```shell
sudo dnf upgrade -y
```

Now, install the latest version of **Ansible**:

```shell
sudo dnf install ansible -y
```

Clone `dotkernel/development` into your home directory:

```shell
git clone https://github.com/dotkernel/development.git
```

Move inside the directory `development/wsl`:

```shell
cd ~/development/wsl/
```

Using your preferred text editor, open `config.yml` where you must fill in the empty fields.

Save and close the file.

Install requirements and initialize systemd by running the below Ansible command:

```shell
ansible-playbook -i hosts install.yml --ask-become-pass
```

The installation process will ask for your password (set during the installation process) and will iterate over each
task in the playbook and will output a short summary with the results.

At this step, **AlmaLinux 9** needs to be restarted - quit it by pressing `Control` + `d`.

Open `Windows Terminal`.

Stop **AlmaLinux 9**:

```shell
wsl -t AlmaLinux9
```

Start **AlmaLinux 9**:

```shell
wsl -d AlmaLinux9
```

Move inside the directory `development/wsl`:

```shell
cd ~/development/wsl/
```

Continue installation by running the below Ansible command:

```shell
ansible-playbook -i hosts install.yml --ask-become-pass
```

The installation process will ask for your password (set during the installation process) and will iterate over each
task in the playbook and will output a short summary with the results.

Now check if everything works by opening in your browser:

- [http://localhost/](http://localhost/) - Apache's default home page
- [http://localhost/info.php](http://localhost/info.php) - PHP info page
- [http://localhost/phpmyadmin/](http://localhost/phpmyadmin/) - PhpMyAdmin (login with `root` + the root password you
configured in `config.yml` under `mariadb` -> `root_password`)

The installation is complete, your **AlmaLinux 9** development environment is ready to use.

## Running AlmaLinux 9

Open `Windows Terminal`.

Start **AlmaLinux 9**:

```shell
wsl -d AlmaLinux9
```

### Note

> In order to run your applications using WSL2, you always need to be connected to your AlmaLinux9 distribution.
> For this, all you need to do is to keep open an instance of Windows Terminal that is connected to it.
99 changes: 99 additions & 0 deletions docs/book/v1/setup/setup-packages.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,99 @@
# Setup the packages in AlmaLinux 9

Install requirements:

```shell
sudo dnf install epel-release dnf-utils https://rpms.remirepo.net/enterprise/remi-release-9.rpm -y
```

Update/Upgrade system packages:

```shell
sudo dnf upgrade -y
```

Now, install the latest version of **Ansible**:

```shell
sudo dnf install ansible -y
```

Clone `dotkernel/development` into your home directory:

```shell
git clone https://github.com/dotkernel/development.git
```

Move inside the directory `development/wsl`:

```shell
cd ~/development/wsl/
```

Using your preferred text editor, open `config.yml` where you must fill in the empty fields.

Save and close the file.

Install requirements and initialize systemd by running the below Ansible command:

```shell
ansible-playbook -i hosts install.yml --ask-become-pass
```

The installation process will ask for your password (set during the installation process) and will iterate over each
task in the playbook and will output a short summary with the results.

At this step, **AlmaLinux 9** needs to be restarted - quit it by pressing `Control` + `d`.

Open `Windows Terminal`.

Stop **AlmaLinux 9**:

```shell
wsl -t AlmaLinux9
```

Start **AlmaLinux 9**:

```shell
wsl -d AlmaLinux9
```

Move inside the directory `development/wsl`:

```shell
cd ~/development/wsl/
```

Continue installation by running the below Ansible command:

```shell
ansible-playbook -i hosts install.yml --ask-become-pass
```

The installation process will ask for your password (set during the installation process) and will iterate over each
task in the playbook and will output a short summary with the results.

Now check if everything works by opening in your browser:

- [http://localhost/](http://localhost/) - Apache's default home page
- [http://localhost/info.php](http://localhost/info.php) - PHP info page
- [http://localhost/phpmyadmin/](http://localhost/phpmyadmin/) - PhpMyAdmin (login with `root` + the root password you
configured in `config.yml` under `mariadb` -> `root_password`)

The installation is complete, your **AlmaLinux 9** development environment is ready to use.

## Running AlmaLinux 9

Open `Windows Terminal`.

Start **AlmaLinux 9**:

```shell
wsl -d AlmaLinux9
```

### Note

> In order to run your applications using WSL2, you always need to be connected to your AlmaLinux9 distribution.
> For this, all you need to do is to keep open an instance of Windows Terminal that is connected to it.
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,7 @@ nav:
- Setup:
- System Requirements: v1/setup/system-requirements.md
- Installation: v1/setup/installation.md
- Setup Packages: v1/setup/setup-packages.md
- Virtualhosts:
- Overview: v1/virtualhosts/overview.md
- Create virtualhost: v1/virtualhosts/create-virtualhost.md
Expand Down

0 comments on commit fe5af30

Please sign in to comment.