Menu
Forums
All threads
Latest threads
New posts
Trending threads
New posts
Search forums
Trending
What's new
New posts
New profile posts
Latest activity
Members
Current visitors
New profile posts
Search profile posts
Upgrades
Log in
Register
What's new
Search
Search
Search titles only
By:
All threads
Latest threads
New posts
Trending threads
New posts
Search forums
Menu
Log in
Register
Navigation
Install the app
Install
More options
Contact us
Close Menu
Forums
Server Development
Habbo Retros
Habbo Tutorials
How to set up a retro in 2023 (IIS) (Nitro HTML5) - (Part 2)
JavaScript is disabled. For a better experience, please enable JavaScript in your browser before proceeding.
You are using an out of date browser. It may not display this or other websites correctly.
You should upgrade or use an
alternative browser
.
Reply to thread
Message
<blockquote data-quote="Object" data-source="post: 471815" data-attributes="member: 78351"><p>Welcome to the part 2 of the "how to set up a retro with IIS" series! In this part we'll make a A LOT of progress towards making your new hotel playable <img class="smilie smilie--emoji" loading="lazy" alt="🚀" title="Rocket :rocket:" src="https://cdn.jsdelivr.net/joypixels/assets/6.6/png/unicode/64/1f680.png" data-shortname=":rocket:" /></p><p></p><p><strong>What will we cover in part 2:</strong></p><p>[SPOILER="What will be set up in part 2?"]</p><p>Atom CMS setup</p><p>Atom HK setup</p><p>Volta (multi-node installations)</p><p>Nitro Converter setup</p><p>[/SPOILER]</p><p></p><p>[SPOILER="Volta installation"]</p><p>We'll need multiple versions of Node in-order to setup everything needed to play your new hotel, so to do that, we'll install a tool called "Volta" - Volta is a tool that lets us install & manage multiple versions of node hassle-free <img class="smilie smilie--emoji" loading="lazy" alt="✨" title="Sparkles :sparkles:" src="https://cdn.jsdelivr.net/joypixels/assets/6.6/png/unicode/64/2728.png" data-shortname=":sparkles:" /></p><p></p><p>Head to <a href="https://docs.volta.sh/guide/getting-started" target="_blank">https://docs.volta.sh/guide/getting-started</a> and click on the "<a href="https://github.com/volta-cli/volta/releases/download/v1.0.8/volta-1.0.8-windows-x86_64.msi" target="_blank">download and run the Windows installer</a>" - Go through the installation process. Once volta has been installed re-open your CMD (command prompt) and enter:</p><p>[CODE]</p><p>volta install node@16.18.1</p><p>And</p><p>volta install node</p><p>[/CODE]</p><p></p><p>Install yarn</p><p>[CODE]</p><p>volta install yarn@latest</p><p>[/CODE]</p><p>[/SPOILER]</p><p></p><p>[SPOILER="Atom CMS setup"]</p><p>It's finally time to set up Atom CMS! this is the part where things start to get a little exciting, as we will get to see our website start functioning.</p><p></p><p>The first step of our road to set up Atom CMS will be to enable the PHP extensions required by Atom CMS to function properly, to do that head to C:\Program Files\PHP and scroll down until you find a file named "php" which is of file type "INI"</p><p>[ATTACH=full]12922[/ATTACH]</p><p></p><p>Open the file in your preferred editor (Mine will be Visual Studio Code)</p><p></p><p>Find the extensions list (You can find the list quickly by searching for "Dynamic Extensions") Once you've found the list, replace it with the extension list below.</p><p></p><p>[SPOILER="Extensions list"]</p><p>[CODE]</p><p>;extension=bz2</p><p>extension=curl</p><p>;extension=ffi</p><p>;extension=ftp</p><p>extension=fileinfo</p><p>extension=gd</p><p>;extension=gettext</p><p>;extension=gmp</p><p>;extension=intl</p><p>;extension=imap</p><p>;extension=ldap</p><p>extension=mbstring</p><p>;extension=exif ; Must be after mbstring as it depends on it</p><p>;extension=mysqli</p><p>;extension=oci8_12c ; Use with Oracle Database 12c Instant Client</p><p>;extension=oci8_19 ; Use with Oracle Database 19 Instant Client</p><p>;extension=odbc</p><p>extension=openssl</p><p>;extension=pdo_firebird</p><p>extension=pdo_mysql</p><p>;extension=pdo_oci</p><p>;extension=pdo_odbc</p><p>;extension=pdo_pgsql</p><p>;extension=pdo_sqlite</p><p>;extension=pgsql</p><p>;extension=shmop</p><p>; The MIBS data available in the PHP distribution must be installed.</p><p>; See https://www.php.net/manual/en/snmp.installation.php</p><p>;extension=snmp</p><p>;extension=soap</p><p>extension=sockets</p><p>;extension=sodium</p><p>;extension=sqlite3</p><p>;extension=tidy</p><p>;extension=xsl</p><p>[/CODE]</p><p>[/SPOILER]</p><p></p><p><strong>The next step</strong></p><p>* If you have the URL Rewrite extension installed already, skip to the "Install Atom CMS" step below.</p><p></p><p>If you didn't install the URL Rewrite extension in part one, you'll have to install it now - <a href="https://www.iis.net/downloads/microsoft/url-rewrite" target="_blank">You can download the module here</a>. Simply click "Install this extension" and go through the setup process</p><p></p><p><strong>Install Atom CMS:</strong></p><p>Start by heading into your Atom CMS folder by opening command prompt (CMD) and enter</p><p>[CODE]cd C:/inetpub/wwwroot/atomcms[/CODE]</p><p></p><p>Next up enter the following your CMD</p><p>[CODE]copy .env.example .env[/CODE]</p><p></p><p>* Leave your terminal open and continue to "Connect Atom CMS to your database & then Dependencies installation" below.</p><p></p><p><strong>Connect Atom CMS to your database:</strong></p><p>To make Atom CMS able to communicate with our database, we'll have to set the correct credentials, to do that open the<strong> .env</strong> file that is now located in the root of the Atom CMS folder, and fill in your database credentials as well as the correct database name - The variables you'll have to edit can be found below:</p><p></p><p>[SPOILER="Database variables to edit"]</p><p>DB_DATABASE=your-database-name</p><p>DB_USERNAME=root</p><p>DB_PASSWORD=your-database-password</p><p>[/SPOILER]</p><p></p><p><strong>Dependencies installation:</strong></p><p>Atom CMS relies on multiple different dependencies which we will have to install - To install those dependencies write the following commands</p><p>[CODE]</p><p>composer install && npm i && npm run build:atom</p><p>[/CODE]</p><p></p><p>This will install all the required dependencies & compile the necessary assets for you.</p><p></p><p>[SPOILER="Compiled assets"]</p><p>[ATTACH=full]13617[/ATTACH]</p><p>[/SPOILER]</p><p></p><p>For Atom CMS to function we'll also have to generate an application key - luckily this is a simple process as well! All you have to do is to enter the following command in your CMD (command prompt)</p><p>[CODE]</p><p>php artisan key:generate</p><p>[/CODE]</p><p></p><p><strong>Connect Atom CMS with IIS:</strong></p><p>The time has come! We will now be connecting Atom CMS with IIS to make us able to browse our newly setup website <img class="smilie smilie--emoji" loading="lazy" alt="🚀" title="Rocket :rocket:" src="https://cdn.jsdelivr.net/joypixels/assets/6.6/png/unicode/64/1f680.png" data-shortname=":rocket:" /></p><p></p><p><strong>Step one:</strong></p><p>Open up your Internet Information Services application and expand the section just below "Start Page"</p><p></p><p>[ATTACH=full]13781[/ATTACH]</p><p></p><p>Expand the "sites" section and right-click on the "Default website" and then "remove".</p><p></p><p>You will then have to add a new site to IIS and to do that, right-click yet again on the "Sites" and click "Add Website..."</p><p>[ATTACH=full]13782[/ATTACH]</p><p></p><p>In the "Site name:" field enter whatever name you find appropriate. In my case, I will just enter my domain name.</p><p></p><p>Next click the 3 dots next to the "Physical path:" field and browse into the "public" folder inside the "atomcms" folder. Once you have clicked on the "public" folder, click the "OK" button.</p><p></p><p>[SPOILER="How it should look"]</p><p>Once you have done all of the above your "Add website" popup should look like this:</p><p>[ATTACH=full]13616[/ATTACH]</p><p></p><p>If that's the case simply click "OK".</p><p>[/SPOILER]</p><p></p><p>Next up we'll have to give full permission to the "atomcms" folder. To achieve this, browse yourself into the "C:\inetpub\wwwroot" folder and right-click on the "atomcms" folder select "Properties" then click the "Security" tab and click on "Edit..." and then "Add..." - A pop up should appear looking like the image below.</p><p></p><p>[ATTACH=full]13783[/ATTACH]</p><p></p><p>Enter "IIS_IUSRS" and then "OK". Click on "Add..." once more and add "IUSR" and then "OK".</p><p></p><p>Once both the "users" have been added, find both of them in the list and click them individually, once they have been selected toggle the "Full control" and then click "Apply" (Don't forget to do this on both the added users).</p><p></p><p>Check the images below, if you're unsure if you did it correctly<img class="smilie smilie--emoji" loading="lazy" alt="✨" title="Sparkles :sparkles:" src="https://cdn.jsdelivr.net/joypixels/assets/6.6/png/unicode/64/2728.png" data-shortname=":sparkles:" /></p><p>[SPOILER="Permissions"]</p><p>[ATTACH=full]13611[/ATTACH]</p><p>[ATTACH=full]13613[/ATTACH]</p><p>[ATTACH=full]13614[/ATTACH]</p><p>[/SPOILER]</p><p></p><p>Once Atom CMS has been linked through IIS, you will be able to visit it through your domain name. The first time you visit it, you'll be prompted with an installation screen, which required you to paste in an installation code. This code can be found inside your database manager (DBeaver) within the table "website_installation" copy this code and paste it in, then go through the installation steps.</p><p></p><p><strong>Important: </strong>Once you've finished the installation steps, open your .env files within your preferred editor once more, and set the APP_ENV to:</p><p>[CODE]APP_ENV=production[/CODE]</p><p>and the APP_DEBUG to:</p><p>[CODE]APP_DEBUG=false[/CODE]</p><p>[/SPOILER]</p><p></p><p>[SPOILER="Set up Arcturus MS Emulator"]</p><p>Before we can enter our hotel, we'll need to set up our emulator and to do that, the first thing we need to do is to install Java.</p><p></p><p>To install Java all you have to do is to download it - <a href="https://www.java.com/en/download/" target="_blank">Download Java by clicking here</a></p><p></p><p>Once Java has been downloaded, go through the setup process, by leaving everything to their default preset (Simply click "Install" and let Java install itself).</p><p></p><p><strong>Java has been installed:</strong></p><p>[SPOILER="Java installed successfully"]</p><p>When Java has been installed, it should look like the image below:</p><p>[ATTACH=full]12941[/ATTACH]</p><p>[/SPOILER]</p><p></p><p>[SPOILER="Arcturus MS Emulator setup"]</p><p>Start by heading into your File explorer and navigate int othe following: "C:/ -> inetpub -> wwwroot -> atomcms -> public -> client" Here you'll find yourself with a folder called "emulator" simply drag it out to your desktop.</p><p></p><p>Open the "emulator" folder now located on your desktop and then edit the database credentials inside the <strong>config.ini </strong>file, so that they match the ones you made when setting up MariaDB - If you don't remember your credentials, simply open the .env file located in the root folder for Atom CMS and take them from there.</p><p></p><p>Once you've edited the config.ini so that the database credential matches you can safely save and close the config.ini file again.</p><p></p><p>Lastly click on the "start.bat" file so that your emulator fully boots up, once it's booted up, you can simply close it it back down.</p><p></p><p>There you go! Your emulator should now run smoothly for the future.</p><p>[/SPOILER]</p><p>[/SPOILER]</p><p></p><p>You're doing an amazing job so far <img class="smilie smilie--emoji" loading="lazy" alt="🎉" title="Party popper :tada:" src="https://cdn.jsdelivr.net/joypixels/assets/6.6/png/unicode/64/1f389.png" data-shortname=":tada:" /> In the next part we will go through the process of setting up:</p><p>Nitro v2 & connect it's assets (latest as of July 2023)</p><p></p><p>To learn how to do all of the above, head to part 3 of this series, which will be the last and final part<img class="smilie smilie--emoji" loading="lazy" alt="🥳" title="Partying face :partying_face:" src="https://cdn.jsdelivr.net/joypixels/assets/6.6/png/unicode/64/1f973.png" data-shortname=":partying_face:" /></p><p><a href="https://devbest.com/threads/how-to-set-up-a-retro-iis-part-3.92543/" target="_blank">Click here to go to part 3 of the "How to set up a retro (IIS) series</a></p><p></p><p><strong><span style="font-size: 15px">Did I miss anything?</span></strong></p><p><span style="font-size: 12px">Please let me know if I missed anything, as the guide contains a lot of information.</span></p></blockquote><p></p>
[QUOTE="Object, post: 471815, member: 78351"] Welcome to the part 2 of the "how to set up a retro with IIS" series! In this part we'll make a A LOT of progress towards making your new hotel playable 🚀 [B]What will we cover in part 2:[/B] [SPOILER="What will be set up in part 2?"] Atom CMS setup Atom HK setup Volta (multi-node installations) Nitro Converter setup [/SPOILER] [SPOILER="Volta installation"] We'll need multiple versions of Node in-order to setup everything needed to play your new hotel, so to do that, we'll install a tool called "Volta" - Volta is a tool that lets us install & manage multiple versions of node hassle-free ✨ Head to [URL]https://docs.volta.sh/guide/getting-started[/URL] and click on the "[URL='https://github.com/volta-cli/volta/releases/download/v1.0.8/volta-1.0.8-windows-x86_64.msi']download and run the Windows installer[/URL]" - Go through the installation process. Once volta has been installed re-open your CMD (command prompt) and enter: [CODE] volta install node@16.18.1 And volta install node [/CODE] Install yarn [CODE] volta install yarn@latest [/CODE] [/SPOILER] [SPOILER="Atom CMS setup"] It's finally time to set up Atom CMS! this is the part where things start to get a little exciting, as we will get to see our website start functioning. The first step of our road to set up Atom CMS will be to enable the PHP extensions required by Atom CMS to function properly, to do that head to C:\Program Files\PHP and scroll down until you find a file named "php" which is of file type "INI" [ATTACH type="full" width="532px" alt="1638740921064.png"]12922[/ATTACH] Open the file in your preferred editor (Mine will be Visual Studio Code) Find the extensions list (You can find the list quickly by searching for "Dynamic Extensions") Once you've found the list, replace it with the extension list below. [SPOILER="Extensions list"] [CODE] ;extension=bz2 extension=curl ;extension=ffi ;extension=ftp extension=fileinfo extension=gd ;extension=gettext ;extension=gmp ;extension=intl ;extension=imap ;extension=ldap extension=mbstring ;extension=exif ; Must be after mbstring as it depends on it ;extension=mysqli ;extension=oci8_12c ; Use with Oracle Database 12c Instant Client ;extension=oci8_19 ; Use with Oracle Database 19 Instant Client ;extension=odbc extension=openssl ;extension=pdo_firebird extension=pdo_mysql ;extension=pdo_oci ;extension=pdo_odbc ;extension=pdo_pgsql ;extension=pdo_sqlite ;extension=pgsql ;extension=shmop ; The MIBS data available in the PHP distribution must be installed. ; See https://www.php.net/manual/en/snmp.installation.php ;extension=snmp ;extension=soap extension=sockets ;extension=sodium ;extension=sqlite3 ;extension=tidy ;extension=xsl [/CODE] [/SPOILER] [B]The next step[/B] * If you have the URL Rewrite extension installed already, skip to the "Install Atom CMS" step below. If you didn't install the URL Rewrite extension in part one, you'll have to install it now - [URL='https://www.iis.net/downloads/microsoft/url-rewrite']You can download the module here[/URL]. Simply click "Install this extension" and go through the setup process [B]Install Atom CMS:[/B] Start by heading into your Atom CMS folder by opening command prompt (CMD) and enter [CODE]cd C:/inetpub/wwwroot/atomcms[/CODE] Next up enter the following your CMD [CODE]copy .env.example .env[/CODE] * Leave your terminal open and continue to "Connect Atom CMS to your database & then Dependencies installation" below. [B]Connect Atom CMS to your database:[/B] To make Atom CMS able to communicate with our database, we'll have to set the correct credentials, to do that open the[B] .env[/B] file that is now located in the root of the Atom CMS folder, and fill in your database credentials as well as the correct database name - The variables you'll have to edit can be found below: [SPOILER="Database variables to edit"] DB_DATABASE=your-database-name DB_USERNAME=root DB_PASSWORD=your-database-password [/SPOILER] [B]Dependencies installation:[/B] Atom CMS relies on multiple different dependencies which we will have to install - To install those dependencies write the following commands [CODE] composer install && npm i && npm run build:atom [/CODE] This will install all the required dependencies & compile the necessary assets for you. [SPOILER="Compiled assets"] [ATTACH type="full" width="554px" alt="1661007556834.png"]13617[/ATTACH] [/SPOILER] For Atom CMS to function we'll also have to generate an application key - luckily this is a simple process as well! All you have to do is to enter the following command in your CMD (command prompt) [CODE] php artisan key:generate [/CODE] [B]Connect Atom CMS with IIS:[/B] The time has come! We will now be connecting Atom CMS with IIS to make us able to browse our newly setup website 🚀 [B]Step one:[/B] Open up your Internet Information Services application and expand the section just below "Start Page" [ATTACH type="full" alt="1665606065519.png"]13781[/ATTACH] Expand the "sites" section and right-click on the "Default website" and then "remove". You will then have to add a new site to IIS and to do that, right-click yet again on the "Sites" and click "Add Website..." [ATTACH type="full" alt="1665606152484.png"]13782[/ATTACH] In the "Site name:" field enter whatever name you find appropriate. In my case, I will just enter my domain name. Next click the 3 dots next to the "Physical path:" field and browse into the "public" folder inside the "atomcms" folder. Once you have clicked on the "public" folder, click the "OK" button. [SPOILER="How it should look"] Once you have done all of the above your "Add website" popup should look like this: [ATTACH type="full" alt="1661006333941.png"]13616[/ATTACH] If that's the case simply click "OK". [/SPOILER] Next up we'll have to give full permission to the "atomcms" folder. To achieve this, browse yourself into the "C:\inetpub\wwwroot" folder and right-click on the "atomcms" folder select "Properties" then click the "Security" tab and click on "Edit..." and then "Add..." - A pop up should appear looking like the image below. [ATTACH type="full" width="341px" alt="1665606552476.png"]13783[/ATTACH] Enter "IIS_IUSRS" and then "OK". Click on "Add..." once more and add "IUSR" and then "OK". Once both the "users" have been added, find both of them in the list and click them individually, once they have been selected toggle the "Full control" and then click "Apply" (Don't forget to do this on both the added users). Check the images below, if you're unsure if you did it correctly✨ [SPOILER="Permissions"] [ATTACH type="full" alt="1661005854098.png"]13611[/ATTACH] [ATTACH type="full" alt="1661006136540.png"]13613[/ATTACH] [ATTACH type="full" alt="1661006202108.png"]13614[/ATTACH] [/SPOILER] Once Atom CMS has been linked through IIS, you will be able to visit it through your domain name. The first time you visit it, you'll be prompted with an installation screen, which required you to paste in an installation code. This code can be found inside your database manager (DBeaver) within the table "website_installation" copy this code and paste it in, then go through the installation steps. [B]Important: [/B]Once you've finished the installation steps, open your .env files within your preferred editor once more, and set the APP_ENV to: [CODE]APP_ENV=production[/CODE] and the APP_DEBUG to: [CODE]APP_DEBUG=false[/CODE] [/SPOILER] [SPOILER="Set up Arcturus MS Emulator"] Before we can enter our hotel, we'll need to set up our emulator and to do that, the first thing we need to do is to install Java. To install Java all you have to do is to download it - [URL='https://www.java.com/en/download/']Download Java by clicking here[/URL] Once Java has been downloaded, go through the setup process, by leaving everything to their default preset (Simply click "Install" and let Java install itself). [B]Java has been installed:[/B] [SPOILER="Java installed successfully"] When Java has been installed, it should look like the image below: [ATTACH=full]12941[/ATTACH] [/SPOILER] [SPOILER="Arcturus MS Emulator setup"] Start by heading into your File explorer and navigate int othe following: "C:/ -> inetpub -> wwwroot -> atomcms -> public -> client" Here you'll find yourself with a folder called "emulator" simply drag it out to your desktop. Open the "emulator" folder now located on your desktop and then edit the database credentials inside the [B]config.ini [/B]file, so that they match the ones you made when setting up MariaDB - If you don't remember your credentials, simply open the .env file located in the root folder for Atom CMS and take them from there. Once you've edited the config.ini so that the database credential matches you can safely save and close the config.ini file again. Lastly click on the "start.bat" file so that your emulator fully boots up, once it's booted up, you can simply close it it back down. There you go! Your emulator should now run smoothly for the future. [/SPOILER] [/SPOILER] You're doing an amazing job so far 🎉 In the next part we will go through the process of setting up: Nitro v2 & connect it's assets (latest as of July 2023) To learn how to do all of the above, head to part 3 of this series, which will be the last and final part🥳 [URL='https://devbest.com/threads/how-to-set-up-a-retro-iis-part-3.92543/']Click here to go to part 3 of the "How to set up a retro (IIS) series[/URL] [B][SIZE=4]Did I miss anything?[/SIZE][/B] [SIZE=3]Please let me know if I missed anything, as the guide contains a lot of information.[/SIZE] [/QUOTE]
Insert quotes…
Verification
Post reply
Forums
Server Development
Habbo Retros
Habbo Tutorials
How to set up a retro in 2023 (IIS) (Nitro HTML5) - (Part 2)
Top