Install i@nseo - Revision history

Deligant: Marked this version for translation

2026-03-12T17:07:37Z

Marked this version for translation

← Older revision		Revision as of 17:07, 12 March 2026
Line 5:		Line 5:
	i@nseo runs as a web site, so a so-called AMP stack (Apache, Mysql, Php) needs to be installed first.		i@nseo runs as a web site, so a so-called AMP stack (Apache, Mysql, Php) needs to be installed first.

			<!--T:27-->
	<hr>		<hr>

Line 51:		Line 52:
	Verify the <code>C:\ianseo\htdocs</code> folder is world-writeable: right click on the folder, select properties and change the permissions so that everybody can have read and write access to the folder and subsequent files and folders.		Verify the <code>C:\ianseo\htdocs</code> folder is world-writeable: right click on the folder, select properties and change the permissions so that everybody can have read and write access to the folder and subsequent files and folders.

			<!--T:28-->
	<hr>		<hr>

Line 59:		Line 61:
	Download XAMPP ([https://www.apachefriends.org/]) or MAMP ([https://www.mamp.info/en/downloads/]) and follow the instructions to install. The following guide is for MAMP but are also valid for XAMPP.		Download XAMPP ([https://www.apachefriends.org/]) or MAMP ([https://www.mamp.info/en/downloads/]) and follow the instructions to install. The following guide is for MAMP but are also valid for XAMPP.

			<!--T:29-->
	Choose the appropriate version if you're running an Intel processor or Apple Silicon.		Choose the appropriate version if you're running an Intel processor or Apple Silicon.

			<!--T:30-->
	Run the installation program. This will install MAMP and a demo version of MAMP Pro. Ianseo only needs the functionality in MAMP so you do not need to purchase MAMP Pro unless you want to.		Run the installation program. This will install MAMP and a demo version of MAMP Pro. Ianseo only needs the functionality in MAMP so you do not need to purchase MAMP Pro unless you want to.

			<!--T:31-->
	After the installation, you will find a folder called MAMP in the Applications folder. Open this folder by double clicking on it and then start the MAMP application.		After the installation, you will find a folder called MAMP in the Applications folder. Open this folder by double clicking on it and then start the MAMP application.

			<!--T:32-->
	Most of the standard values are sufficient for Ianseo, but a couple of adjustments need to be done first. Choose Preferences and then the Ports tab. Click the button “80 & 3306” to set MAMP to the default ports for web and MySQL.		Most of the standard values are sufficient for Ianseo, but a couple of adjustments need to be done first. Choose Preferences and then the Ports tab. Click the button “80 & 3306” to set MAMP to the default ports for web and MySQL.

Line 70:		Line 76:
	From [https://ianseo.net/Releases.php ianseo.net] download the zip file and extract it in the folder <code>htdocs</code> of XAMPP/MAMP (under <code>/Application</code>)		From [https://ianseo.net/Releases.php ianseo.net] download the zip file and extract it in the folder <code>htdocs</code> of XAMPP/MAMP (under <code>/Application</code>)

			<!--T:33-->
	For the purpose of the guide Ianseo will be installed in its own folder, called ianseo and the URL to access ianseo will be <code>http://localhost/ianseo</code>.		For the purpose of the guide Ianseo will be installed in its own folder, called ianseo and the URL to access ianseo will be <code>http://localhost/ianseo</code>.

			<!--T:34-->
	* Open folder “/Applications/MAMP/htdocs”		* Open folder “/Applications/MAMP/htdocs”
	* Create a folder inside it and name it “ianseo” (all lower case, without quotes)		* Create a folder inside it and name it “ianseo” (all lower case, without quotes)
Line 84:		Line 92:
	sudo chmod -R a+rwX ianseo		sudo chmod -R a+rwX ianseo

	====Starting MAMP====		====Starting MAMP==== <!--T:35-->

			<!--T:36-->
	Start the MAMP application and then press the Start button. This will start the Apache web server and the MySQL database. You may be prompted to enter your password; enter it to continue.		Start the MAMP application and then press the Start button. This will start the Apache web server and the MySQL database. You may be prompted to enter your password; enter it to continue.

			<!--T:37-->
	Once MAMP starts, your browser should automatically open to a Welcome to MAMP page showing the current version number.		Once MAMP starts, your browser should automatically open to a Welcome to MAMP page showing the current version number.

			<!--T:38-->
	To start Ianseo, enter the address <code>http://localhost/ianseo</code> in a new tab. You will first need to agree to the License Agreement. Check the box and click on the I AGREE button.		To start Ianseo, enter the address <code>http://localhost/ianseo</code> in a new tab. You will first need to agree to the License Agreement. Check the box and click on the I AGREE button.

			<!--T:39-->
	If this is a new installation, follow the onscreen instructions.		If this is a new installation, follow the onscreen instructions.

			<!--T:40-->
	{{Note\|During installation, MAMP does not set the MySQL root password, so when the installer will ask for it, leave it blank. The other fields can be left with default values. Click the Create user and database button to proceed. }}		{{Note\|During installation, MAMP does not set the MySQL root password, so when the installer will ask for it, leave it blank. The other fields can be left with default values. Click the Create user and database button to proceed. }}

			<!--T:41-->
	{{Note\|If the installation program displays an error message indicating that it could not connect to the database, enter “root” in the ADMIN Password to create users and databases fields and click the Create user and database button to try again.}}		{{Note\|If the installation program displays an error message indicating that it could not connect to the database, enter “root” in the ADMIN Password to create users and databases fields and click the Create user and database button to try again.}}

			<!--T:42-->
	Once the database information is configured, you should see a message saying Ianseo is now installed on your system.		Once the database information is configured, you should see a message saying Ianseo is now installed on your system.

			<!--T:43-->
	Click on the link “Go to IANSEO!” to update your system to the latest version. This will automatically download the latest version of the software and update the language files. When this is finished you will see the message “The upgrade process is finished.”. Click the button to continue.		Click on the link “Go to IANSEO!” to update your system to the latest version. This will automatically download the latest version of the software and update the language files. When this is finished you will see the message “The upgrade process is finished.”. Click the button to continue.

			<!--T:44-->
	<hr>		<hr>

Deligant at 17:06, 12 March 2026

2026-03-12T17:06:32Z

@@ Line 4: / Line 4: @@
 == Preparation of the installation == <!--T:1-->
 i@nseo runs as a web site, so a so-called AMP stack (Apache, Mysql, Php) needs to be installed first.
 === Windows === <!--T:2-->
@@ Line 48: / Line 50: @@
 <!--T:12-->
 Verify the <code>C:\ianseo\htdocs</code> folder is world-writeable: right click on the folder, select properties and change the permissions so that everybody can have read and write access to the folder and subsequent files and folders.
 ===MacOs=== <!--T:13-->
@@ Line 53: / Line 57: @@
 ====Download of XAMPP/MAMP==== <!--T:14-->
-Download XAMPP ([https://www.apachefriends.org/]) or MAMP ([https://www.mamp.info/en/downloads/]) and follow the instructions to install.
+Download XAMPP ([https://www.apachefriends.org/]) or MAMP ([https://www.mamp.info/en/downloads/]) and follow the instructions to install. The following guide is for MAMP but are also valid for XAMPP.
 ====Download of i@nseo==== <!--T:15-->
 From [https://ianseo.net/Releases.php ianseo.net] download the zip file and extract it in the folder <code>htdocs</code> of XAMPP/MAMP (under <code>/Application</code>)
 ===Linux=== <!--T:16-->

Deligant at 08:35, 1 July 2025

2025-07-01T08:35:40Z

← Older revision		Revision as of 08:35, 1 July 2025
Line 106:		Line 106:
	{{Content}}		{{Content}}
	</translate>		</translate>

	== Credits ==
	<references />

Deligant: Marked this version for translation

2025-07-01T08:35:17Z

Marked this version for translation

← Older revision		Revision as of 08:35, 1 July 2025
Line 25:		Line 25:
	<div class="mw-collapsible-content">		<div class="mw-collapsible-content">

			<!--T:25-->
	{{Install_Post_Installation}}		{{Install_Post_Installation}}

			<!--T:26-->
	</div>		</div>
	</div>		</div>

Deligant at 08:34, 1 July 2025

2025-07-01T08:34:50Z

← Older revision		Revision as of 08:34, 1 July 2025
Line 24:		Line 24:
	<!--T:7-->		<!--T:7-->
	<div class="mw-collapsible-content">		<div class="mw-collapsible-content">

	{{Install_Post_Installation}}		{{Install_Post_Installation}}

	</div>		</div>
	</div>		</div>

Deligant at 07:35, 1 July 2025

2025-07-01T07:35:06Z

← Older revision		Revision as of 07:35, 1 July 2025
Line 100:		Line 100:
	<!--T:24-->		<!--T:24-->
	Follow the on-screen instructions given by the software.		Follow the on-screen instructions given by the software.
		⚫	{{Content}}
	</translate>		</translate>

	== Credits ==		== Credits ==
	<references />		<references />

⚫	{{Content}}

Deligant at 07:03, 1 July 2025

2025-07-01T07:03:11Z

← Older revision		Revision as of 07:03, 1 July 2025
Line 104:		Line 104:
	== Credits ==		== Credits ==
	<references />		<references />

			{{Content}}

Deligant: Marked this version for translation

2025-03-31T13:04:09Z

Marked this version for translation

← Older revision		Revision as of 13:04, 31 March 2025
Line 2:		Line 2:
	<languages />		<languages />
	<translate>		<translate>
	== Preparation of the installation ==		== Preparation of the installation == <!--T:1-->
	i@nseo runs as a web site, so a so-called AMP stack (Apache, Mysql, Php) needs to be installed first.		i@nseo runs as a web site, so a so-called AMP stack (Apache, Mysql, Php) needs to be installed first.

	=== Windows ===		=== Windows === <!--T:2-->
	To install i@nseo on a Windows operating system, follow these steps:		To install i@nseo on a Windows operating system, follow these steps:

			<!--T:3-->
	* Download the software from [https://ianseo.net/Releases.php ianseo.net]. The preferred method is to download the full installer that will install XAMPP.		* Download the software from [https://ianseo.net/Releases.php ianseo.net]. The preferred method is to download the full installer that will install XAMPP.

			<!--T:4-->
	*Extract the file in the wished folder. The preferred method is extracting the file in C:\ and ianseo will be found in C:\ianseo		*Extract the file in the wished folder. The preferred method is extracting the file in C:\ and ianseo will be found in C:\ianseo

			<!--T:5-->
	*Run the setup xampp.bat file, available in the folder. A terminal window will open: in case there is some setup to tweek the system will display 2 pre-compiled questions: just press "Enter"; otherwise a message saying "Nothing to do" will be displayed. Then close the terminal window.		*Run the setup xampp.bat file, available in the folder. A terminal window will open: in case there is some setup to tweek the system will display 2 pre-compiled questions: just press "Enter"; otherwise a message saying "Nothing to do" will be displayed. Then close the terminal window.

	<div class="ianseo-alert-info">		<div class="ianseo-alert-info">
	<div class="mw-collapsible mw-collapsed">		<div class="mw-collapsible mw-collapsed">
	==== Post Installation ====		==== Post Installation ==== <!--T:6-->
	<b>In Windows 11</b> Windows Defender apparently interferes with XAMPP and sometimes crashes i@nseo.		<b>In Windows 11</b> Windows Defender apparently interferes with XAMPP and sometimes crashes i@nseo.

			<!--T:7-->
	<div class="mw-collapsible-content">		<div class="mw-collapsible-content">
	{{Install_Post_Installation}}		{{Install_Post_Installation}}
Line 25:		Line 29:
	</div>		</div>

	====Run XAMPP====		====Run XAMPP==== <!--T:8-->
	After setting up the archives, activate XAMPP by clicking on the Xampp-control icon, then, in the new window, click on ‘Start’ to both Apache and MySql.		After setting up the archives, activate XAMPP by clicking on the Xampp-control icon, then, in the new window, click on ‘Start’ to both Apache and MySql.

	<div class="ianseo-alert-danger">		<div class="ianseo-alert-danger">
	=====WARNING=====		=====WARNING===== <!--T:9-->

			<!--T:10-->
	If a warning appears stating that VCRUNTIME140.dll was not found, please install the [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-microsoft-visual-c-redistributable-version Latest Microsoft Visual C++ Redistributable Version] We reccomend the x86 version. If in doubt install both!		If a warning appears stating that VCRUNTIME140.dll was not found, please install the [https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170#latest-microsoft-visual-c-redistributable-version Latest Microsoft Visual C++ Redistributable Version] We reccomend the x86 version. If in doubt install both!
	</div>		</div>

			<!--T:11-->
	N.B.: the XAMPP control panel can be closed (minimised) and the services will keep running.		N.B.: the XAMPP control panel can be closed (minimised) and the services will keep running.

			<!--T:12-->
	Verify the <code>C:\ianseo\htdocs</code> folder is world-writeable: right click on the folder, select properties and change the permissions so that everybody can have read and write access to the folder and subsequent files and folders.		Verify the <code>C:\ianseo\htdocs</code> folder is world-writeable: right click on the folder, select properties and change the permissions so that everybody can have read and write access to the folder and subsequent files and folders.

	===MacOs===		===MacOs=== <!--T:13-->
	We do not have an installer for Mac, so the AMP stack needs to be installed separately.		We do not have an installer for Mac, so the AMP stack needs to be installed separately.

	====Download of XAMPP/MAMP====		====Download of XAMPP/MAMP==== <!--T:14-->
	Download XAMPP ([https://www.apachefriends.org/]) or MAMP ([https://www.mamp.info/en/downloads/]) and follow the instructions to install.		Download XAMPP ([https://www.apachefriends.org/]) or MAMP ([https://www.mamp.info/en/downloads/]) and follow the instructions to install.

	====Download of i@nseo====		====Download of i@nseo==== <!--T:15-->
	From [https://ianseo.net/Releases.php ianseo.net] download the zip file and extract it in the folder <code>htdocs</code> of XAMPP/MAMP (under <code>/Application</code>)		From [https://ianseo.net/Releases.php ianseo.net] download the zip file and extract it in the folder <code>htdocs</code> of XAMPP/MAMP (under <code>/Application</code>)

	===Linux===		===Linux=== <!--T:16-->
	The native way of installing the AMP stack is called LAMP: be aware that i@nseo will run on php 8 or later. Install with your package manager (you will need administrative privileges):		The native way of installing the AMP stack is called LAMP: be aware that i@nseo will run on php 8 or later. Install with your package manager (you will need administrative privileges):

			<!--T:17-->
	*apache2		*apache2
	*mysql-server		*mysql-server
Line 64:		Line 72:
	*php-mbstring		*php-mbstring

			<!--T:18-->
	Create a user for ianseo in the mysql server. This can be done in modern debian derived distribution with (copy and paste the following line in a terminal):		Create a user for ianseo in the mysql server. This can be done in modern debian derived distribution with (copy and paste the following line in a terminal):
	sudo mysql -e "create user ianseo@localhost identified by 'ianseo';grant all privileges on ianseo.* to ianseo@localhost;create database ianseo;"		sudo mysql -e "create user ianseo@localhost identified by 'ianseo';grant all privileges on ianseo.* to ianseo@localhost;create database ianseo;"

			<!--T:19-->
	If you have an error of missing password, you need to add the password switch. Be aware that you will not see the password as you type, so don't forget to hit "enter" when done.		If you have an error of missing password, you need to add the password switch. Be aware that you will not see the password as you type, so don't forget to hit "enter" when done.

			<!--T:20-->
	sudo mysql -p -e "create user ianseo@localhost identified by 'ianseo';grant all privileges on ianseo.* to ianseo@localhost;create database ianseo;"		sudo mysql -p -e "create user ianseo@localhost identified by 'ianseo';grant all privileges on ianseo.* to ianseo@localhost;create database ianseo;"

			<!--T:21-->
	Create the folder <code>/opt/ianseo</code> and assign the folder to your user.		Create the folder <code>/opt/ianseo</code> and assign the folder to your user.
	Download the zip file from [https://ianseo.net/Releases.php ianseo.net] and extract in <code>/opt/ianseo.</code>		Download the zip file from [https://ianseo.net/Releases.php ianseo.net] and extract in <code>/opt/ianseo.</code>

			<!--T:22-->
	Assign world writeable permissions to the folder and files with the following command.		Assign world writeable permissions to the folder and files with the following command.
	sudo chmod -R a+rwX /opt/ianseo		sudo chmod -R a+rwX /opt/ianseo
Line 81:		Line 94:
	sudo service apache2 reload		sudo service apache2 reload

	==Final Setup of i@nseo==		==Final Setup of i@nseo== <!--T:23-->
	Check there is no file in <code>Common</code> called <code>config.inc.php</code>		Check there is no file in <code>Common</code> called <code>config.inc.php</code>
	Open an Internet browser and navigate to <code><nowiki>http://localhost/ianseo</nowiki></code>		Open an Internet browser and navigate to <code><nowiki>http://localhost/ianseo</nowiki></code>

			<!--T:24-->
	Follow the on-screen instructions given by the software.		Follow the on-screen instructions given by the software.
	</translate>		</translate>

Deligant at 13:03, 31 March 2025

2025-03-31T13:03:57Z

← Older revision		Revision as of 13:03, 31 March 2025
Line 1:		Line 1:
	{{Proofreading}}		{{Proofreading}}
			<languages />
			<translate>
	== Preparation of the installation ==		== Preparation of the installation ==
	i@nseo runs as a web site, so a so-called AMP stack (Apache, Mysql, Php) needs to be installed first.		i@nseo runs as a web site, so a so-called AMP stack (Apache, Mysql, Php) needs to be installed first.
Line 84:		Line 86:

	Follow the on-screen instructions given by the software.		Follow the on-screen instructions given by the software.
			</translate>

	== Credits ==		== Credits ==

Deligant at 14:23, 21 March 2025

2025-03-21T14:23:08Z

← Older revision		Revision as of 14:23, 21 March 2025
Line 1:		Line 1:
			{{Proofreading}}
	== Preparation of the installation ==		== Preparation of the installation ==
	i@nseo runs as a web site, so a so-called AMP stack (Apache, Mysql, Php) needs to be installed first.		i@nseo runs as a web site, so a so-called AMP stack (Apache, Mysql, Php) needs to be installed first.