Installing Alfresco using setup wizards

This section includes instructions that describe the quickest way to install Alfresco using the setup wizards.

Installing Alfresco Enterprise on Linux

The setup wizard for Linux installs all the software and components that you require for running Alfresco. This setup wizard installs Alfresco and additional software, including a including a Tomcat application server, PostgreSQL database, SWFTools, LibreOffice, and ImageMagick.

Important: After installation, you must generate and install your own certificates to secure the installation. For more information, see Generating Secure Keys for Solr Communication [5].

Download the following installation file:
alfresco-enterprise-4.2.8-installer-linux-x64.bin

This Alfresco setup wizard is for 64-bit Linux systems.
Important: If you're using Ubuntu 10.04 or later, you must increase the SHMMAX value before starting the installer. Refer to PostgreSQL official documentation [6] (shared_buffers section) to evaluate the proper value for SHMMAX. Change the SHMMAX value (minimum value required is 40000):
```
sudo sysctl -w kernel.shmmax=newValueInBytes
```
and make the change reboot resistant:
```
sudo echo "kernel.shmmax=newValueInBytes" >> /etc/sysctl.conf
```
Execute the downloaded file using the following commands:
```
chmod 777 alfresco-enterprise-4.2.8-installer-linux-x64.bin 
./alfresco-enterprise-4.2.8-installer-linux-x64.bin
```
Note: You should avoid running applications as the root (Linux administrator) user where possible, however if you must install Alfresco as the root user, then run the alfresco-enterprise-4.2.8-installer-linux-x64.bin file with sudo specified:
```
chmod 777 alfresco-enterprise-4.2.8-installer-linux-x64.bin 
sudo ./alfresco-enterprise-4.2.8-installer-linux-x64.bin
```
The setup wizard starts.
Select the language that you wish to use for the installation.
This sets the language to be used for the setup wizard.
On the Setup - Alfresco Enterprise window, click Next.

On the Installation type window, choose how you want to use the setup wizard.

There are two types of installation in the setup wizard:

Option	Description
Easy	Easy type installs Alfresco using the default options and configuration. This install type requires you to enter information in only two fields: the Alfresco install location and the administrator password. Choose this route to install Alfresco with the default environment. Note: If you have previously installed Alfresco and the server is running, when you run this setup wizard again, you may be prompted to enter alternative port numbers for the components and services that you install, for example, for the Tomcat application server, FTP port, and the RMI port.
Advanced	Advanced type installs Alfresco but lets you configure the server ports and service properties. You can also choose which additional components to install.

Option

Description

Easy

Easy type installs Alfresco using the default options and configuration. This install type requires you to enter information in only two fields: the Alfresco install location and the administrator password. Choose this route to install Alfresco with the default environment.

Note: If you have previously installed Alfresco and the server is running, when you run this setup wizard again, you may be prompted to enter alternative port numbers for the components and services that you install, for example, for the Tomcat application server, FTP port, and the RMI port.

Advanced

Advanced type installs Alfresco but lets you configure the server ports and service properties. You can also choose which additional components to install.

Note: When choosing between the Easy or Advanced installation, consider your basic requirement. If you are installing on a demo system for evaluation purpose only, Alfresco recommends that you use the Easy installation option. However, if you want to connect to an existing database server for Alfresco and also, want to see how the various components are being configured, use the Advanced installation option.

To complete the Easy setup wizard:

Select Easy, and then click Next.
On the Installation folder window, click Next to accept the default location.

Note: You must use ASCII characters only when setting the installation folder using the Alfresco setup wizard.
On the Admin Password window, enter a password for the Administrator user (admin).

CAUTION:
You must use ASCII characters only when setting the password using the installer. If you need to reset the password (to include non-ASCII characters) after installation, see Changing a user's password [7].
Repeat the password, and then click Next.
Click Next through the remaining windows in the setup wizard.
Click Finish to complete the installation.
Go to the step for the Completing the Alfresco Enterprise Setup Wizard window and launching Alfresco Share.

To complete the Advanced setup wizard, select Advanced and then click Next.

Follow the remaining steps in this task.

On the Select Components window, select the components that you want to install. Deselect the components that you do not want to install.

You can select from the following components:
- PostgreSQL
- SharePoint
- Web Quick Start
- Google Docs Integration
- LibreOffice
Note: You cannot deselect the Alfresco component because it is installed by default.
When you have finished selecting the components, click Next.
On the Installation folder window, click Next to accept the default location.
For example, the default location is /opt/alfresco-4.2.x.

Alternatively, click the icon to choose another location.

Note: You must use ASCII characters only when setting the installation folder using the Alfresco setup wizard.
On the Database Server Parameters window, enter a port number for your database.
Enter a suitable port number or click Next to accept the default of 5432.
On the Tomcat Port Configuration window, enter the following Tomcat configuration parameters:
1. Web Server Domain
  For example, the default is 127.0.0.1.
  
  The URL http://127.0.0.1:8080/share [8] is based on the web server domain and the Tomcat port number that you specify on the Tomcat Port Configuration window. The default of 127.0.0.1 can be used on this machine to verify that Alfresco is running successfully. However, it is not an externally addressable URL, which means that it is not possible for users on other machines to access this URL. To make sure that other users can access the machine where Alfresco is installed, you need to define and create a publicly addressable name.
2. Tomcat port
  For example, the default is 8080.
3. Tomcat Shutdown port
  For example, the default is 8005.
4. Tomcat SSL Port
  For example, the default is 8443.
5. Tomcat AJP Port
  For example, the default is 8009.
On the Alfresco FTP Port window, enter a port number for the Alfresco FTP server, and then click Next.
On the Alfresco RMI Port window, enter a port number for the RMI service, and then click Next.
On the Admin Password window, type a password. Repeat the password, and then click Next.
This sets the password for the Alfresco Administrator user account (admin).

CAUTION:
You must use ASCII characters only when setting the password using the installer. If you need to reset the password (to include non-ASCII characters) after installation, see Changing a user's password [7].
(Optional) If you are installing SharePoint Protocol Support, the Alfresco SharePoint Port window displays. Enter a port number, and then click Next.
(Optional) If you are installing the LibreOffice component, the LibreOffice Server Port window displays. Enter a port number on which the LibreOffice server will listen.

On the Service Startup Configuration window, you are presented with two options for starting up the Alfresco services.

Option	Description
Manual	Sets the services to be started manually.
Auto	Sets the services to start up automatically when you start your machine.

Select the services start up option, and then click Next.

On the Ready to Install window, click Next.
The Installing window displays, showing the progress of the installation.
On the Completing the Alfresco Enterprise Setup Wizard window, click Finish.
This window shows check boxes that determine whether you will see the Readme file, the Getting Started [9] web page, and also whether to launch Alfresco Share. By default, these options are selected and will launch when you click Finish. If you do not want to start Alfresco at this point, deselect the Launch Alfresco Enterprise Share check box.
Important: If you are installing the S3 connector as part of your Alfresco installation, deselect the Launch Alfresco Enterprise Share check box. You must not start Alfresco before applying the S3 AMP file.
Click OK to close the Readme.

The Alfresco server starts and then Alfresco Share launches in your default browser.

Important: It may take several minutes to start the Alfresco server and to launch Share. Your browser opens and tries to connect to http://127.0.0.1:8080/share [8].
Log on to Alfresco Share as the admin user. Enter the password that you specified in the Admin Password window.
The Alfresco server is launched automatically as a service called alfresco. This service comprises the following individual services:
- postgresql
- Tomcat Server
If you did not automatically launch Alfresco at the end of the setup wizard, to start Alfresco, you need to start all the services.
Manually start the Alfresco server:
Browse to the installation folder that you created in step 8. As an administrator, run
```
./alfresco.sh start
```
To fully stop Alfresco, you must stop all the services:
Browse to the installation folder that you created in step 8). As an administrator, run
```
./alfresco.sh stop
```

Installing Linux libraries manually

You can install Linux libraries manually on supported Linux distributions, such as Ubuntu, SUSE and RedHat.

LibreOffice requires the following libraries to be installed on your system:

libfontconfig
libSM
libICE
libXrender
libXext
libXinerama

On some Linux distributions, such as Ubuntu, SUSE, and RedHat, the Alfresco setup wizard validates whether the required libraries are present. If the required libraries are missing, you will get a warning message. You can install them using your package manager from the command line. Also, the Linux libraries file names may vary by distribution.

If LibreOffice does not start up normally with Alfresco, test manually; for example, by running this startup script:

start ex.  
{installdir}/libreoffice/scripts/libreoffice_ctl.sh start 
status ex. {installdir}
/libreoffice/scripts/libreoffice_ctl.sh status

If you receive errors that indicate that a library missing, work with your system administrator to add the missing library or its equivalent from your configured repositories.

Installing Alfresco Enterprise on Windows

The setup wizard for Microsoft Windows installs all the software and components that you require for running Alfresco. This setup wizard installs Alfresco and additional software, including a Tomcat application server, PostgreSQL database, SWFTools, LibreOffice, and ImageMagick.

Important: After installation, you must generate and install your own certificates to secure the installation. For more information, see Generating Secure Keys for Solr Communication [5].

Download the following installation file:
alfresco-enterprise-4.2.8-installer-win-x64.exe

The Alfresco setup wizard is for 64-bit Windows systems.
Double-click the downloaded file.
Select the language that you wish to use for the installation.
This sets the language to be used for the setup wizard.
On the Setup - Alfresco Enterprise window, click Next.

On the Installation type window, choose how you want to use the setup wizard.

There are two types of installation in the setup wizard:

Option	Description
Easy	Easy type installs Alfresco using the default options and configuration. This install type requires only two fields: install location and administrator password. Choose this route to install Alfresco with the default environment. Note: If you have previously installed Alfresco and the server is running, when you run this setup wizard again, you may be prompted to enter alternative port numbers for the components and services that you install, for example, for the Tomcat application server, FTP port, and the RMI port.
Advanced	Advanced type installs Alfresco but lets you configure the server ports and service properties. You can also choose which additional components to install.

Option

Description

Easy

Easy type installs Alfresco using the default options and configuration. This install type requires only two fields: install location and administrator password. Choose this route to install Alfresco with the default environment.

Advanced

Advanced type installs Alfresco but lets you configure the server ports and service properties. You can also choose which additional components to install.

To complete the Easy setup wizard:

Select Easy, and then click Next.
On the Installation folder window, click Next to accept the default location.
On the Admin Password window, enter a password for the Administrator user (admin).
Repeat the password, and then click Next.
Click Next through the remaining windows in the setup wizard.
Click Finish to complete the installation.
Go to the step for the Completing the Alfresco Enterprise Setup Wizard window and launching Alfresco Share.

To complete the Advanced setup wizard, select Advanced and then click Next.

Follow the remaining steps in this task.

On the Select Components window, select the components that you want to install. Deselect the components that you do not want to install.

You can select from the following components:
- PostgreSQL
- SharePoint
- Web Quick Start
- Google Docs Integration
- LibreOffice
Note: You cannot deselect the Alfresco component because it is installed by default.
When you have finished selecting the components, click Next.
On the Installation folder window, click Next to accept the default location.
For example, the default location is C:\Alfresco.

Alternatively, click the icon to choose another location.
Important: There is a known problem related to the use of virtual Windows drives and permission restrictions on the C drive in Windows. If you select a virtual Windows drive, and you have selected additional components in step 6, you might receive an error message during installation:
```
09160000 An IO error was encountered during deployment of the AMP into the WAR
```
The installation will complete, but additional components will not be added to the Alfresco installation. The error does not occur if the virtual drive is associated with a folder that is not on the C drive (that is, any other physical or virtual hard disk on the Windows machine). You have two options:
- Do not use the SUBST command for folders on the C drive (in other words, use SUBST on other drives instead)
- Use a Virtual Hard Disk (VHD), which behaves like a physical disk, in place of the virtual Windows drive for the install. For guidance, see Create and use a Virtual Hard Disk [12].
On the Database Server Parameters window, enter a port number for your database.
Enter a suitable port number or click Next to accept the default of 5432.
On the Tomcat Port Configuration window, enter the following Tomcat configuration parameters, and then click Next.
1. Enter the Web Server domain number.
  For example, the default is 127.0.0.1.
  
  The URL http://127.0.0.1:8080/share [8] is based on the web server domain and the Tomcat port number that you specify on the Tomcat Port Configuration window. The default of 127.0.0.1 can be used on this machine to verify that Alfresco is running successfully. However, it is not an externally addressable URL, which means that it is not possible for users on other machines to access this URL. To make sure that other users can access the machine where Alfresco is installed, you need to define and create a publicly addressable name.
2. Enter the port number for the Tomcat web application.
  For example, the default is 8080.
3. Enter the Tomcat Shutdown port number.
  For example, the default is 8005.
4. Enter the Tomcat SSL port number.
  For example, the default is 8443.
5. Enter the Tomcat AJP Port number.
  For example, the default is 8009.
On the Alfresco FTP Port window, enter a port number for the Alfresco FTP server, and then click Next.
On the Alfresco RMI Port window, enter a port number for the RMI service, and then click Next.
On the Admin Password window, enter a password. Repeat the password, and then click Next.
This sets the password for the Alfresco Administrator user account (admin).

CAUTION:
You must use ASCII characters only when setting the password using the installer. If you need to reset the password (to include non-ASCII characters) after installation, see Changing a user's password [7].
(Optional) If you are installing SharePoint Protocol Support, the Alfresco SharePoint Port window displays. Enter a port number, and then click Next.
(Optional) If you are installing the LibreOffice component, the LibreOffice Server Port window displays. Enter a port number on which the LibreOffice server will listen.

On the Service Startup Configuration window, you are presented with two options for starting up the Alfresco services.

Option	Description
Manual	Sets the services to be started manually. Choose this option if you want to start the services yourself.
Auto	Sets the services to start up automatically when you restart the machine.

Select the services start up option, and then click Next.

On the Ready to Install window, click Next.
The Installing window displays, showing the progress of the installation.
On the Completing the Alfresco Enterprise Setup Wizard window, click Finish.
This window shows check boxes that determine whether you will see the Readme file, the Getting Started [9] web page, and also whether to start the server and launch Alfresco Share. By default, these options are selected and will start when you click Finish. If you do not want to start Alfresco at this point, deselect the Launch Alfresco Enterprise Share check box.
Important: If you are installing the S3 connector as part of your Alfresco installation, deselect the Launch Alfresco Enterprise Share check box. You must not start Alfresco before applying the S3 AMP file.
Click OK to close the Readme.

The Alfresco server starts and then Alfresco Share launches in your default browser.

Important: It may take several minutes to start the Alfresco server and to launch Share. Your browser opens and tries to connect to http://127.0.0.1:8080/share [8].
Log on to Alfresco Share as the admin user. Enter the password that you specified in the Admin Password window.
The Alfresco server is launched as a Windows service. If you did not automatically launch Alfresco at the end of the installation wizard, to start Alfresco, you need to start all the services. From the Start menu, select All Programs > Alfresco One > alfresco manager tool and start the Tomcat Server and Postgres services, or from a command prompt, navigate to the Alfresco installation directory (C:/Alfresco) and run servicerun START as an administrator.
To fully stop Alfresco, you must stop all the services. Use the alfresco manager tool (see the previous step) to manage the services, or use the scripts in the installation directory to start or stop the services: servicerun START and servicerun STOP. You need administrator rights to run these commands.

Installing Alfresco Enterprise in an unattended mode

Alfresco distributes binary all-in-one installers which include a setup wizard built with Bitrock technology. This topic describes how to automate the installation process by running the installers in an unattended mode.

These installers contain all the dependencies you need to quickly get Alfresco up and running. For example, the Alfresco installers install and configure all the necessary software, such as Java, Apache Tomcat, PostgreSQL database, LibreOffice, and ImageMagick. The resulting install is optimized for demonstration and initial evaluation. The installer configures an Alfresco service on Windows and Linux (if run as root) for easier startup.

To automate the installation process and customize it for your environment, you can run the install wizard in an unattended mode and provide an option file. The available options can be listed by calling the installer executable on the command line and passing it the --help flag. You can pass an option file called install_opts to the installer using a command, such as:

./alfresco-enterprise-4.2.0-installer-linux-x64.bin --optionfile install_opts

This is an example option file for Enterprise 4.2.0, which installs most components, uses an external database, and does not install the start-up scripts:

mode=unattended
enable-components=javaalfresco,alfrescosharepoint,alfrescogoogledocs,libreofficecomponent
disable-components=postgres

# Use JDBC settings for an existing database
jdbc_url=jdbc:postgresql://localhost/alfresco
jdbc_driver=org.postgresql.Driver
jdbc_database=alfresco
jdbc_username=alfresco
jdbc_password=alfresco

# Install location
prefix=/opt/alfresco_42

alfresco_admin_password=admin

# Don't install init scripts
baseunixservice_install_as_service=0

The full list of options available are listed:

Table 1. Options available for the unattended installer
Option	Information
`--help`	Displays the list of valid options
`--version`	Displays the product version and information
`--unattendedmodeui <option>`	Unattended Mode User Interface. Default is `none`. Options are `none`, `minimal`, `minimalWithDialogs`
`--optionfile <option>`	Installation option file
`--debuglevel <option>`	Debug information. Default is `2`. Options are `0`, `1`, `2`, `3`, `4`.
`--mode <option>`	Installation mode. Default is `gtk`. Options are `gtk`, `xwindow`, `text`, `unattended`.
`--debugtrace <option>`	Debugging file name
`--enable-components <option>`	Comma-separated list of components. Options are `javaalfresco` `postgres` `alfrescosharepoint` `alfrescogoogledocs` `libreofficecomponent`
`--disable-components <option>`	Comma-separated list of components. Options are `javaalfresco` `postgres` `alfrescosharepoint` `alfrescogoogledocs` `libreofficecomponent`
`--installer-language <option>`	Language selection. Default is `en`. Options are `en`, `fr`, `es`, `it`, `de`, `ja`, `nl`, `ru`, `zh_CN`, `no`, `pt_BR`
`--prefix <option>`	Select a folder
`--jdbc_url <option>`	JDBC URL identifier. Default is `jdbc:postgresql://localhost/alfresco`
`--jdbc_driver <option>`	JDBC driver. Default is `org.postgresql.Driver`
`--jdbc_database <option>`	Database name. Default is `alfresco`
`--jdbc_username <option>`	User name
`--jdbc_password <option>`	Password
`--postgres_port <option>`	Database server port. Default is `5432`
`--tomcat_installation_type <option>`	Tomcat installation type
`--tomcat_server_domain <option>`	Web server domain
`--tomcat_server_port <option>`	Tomcat server port. Default is `8080`
`--tomcat_server_shutdown_port <option>`	Tomcat shutdown port. Default is `8005`
`--tomcat_server_ssl_port <option>`	Tomcat SSL port. Default is `8443`
`--tomcat_server_ajp_port <option>`	Tomcat AJP port. Default is `8009`
`--alfresco_ftp_port <option>`	FTP port. Default is `21`
`--alfresco_rmi_port <option>`	RMI port. default is `50500`
`--alfresco_admin_password <option>`	Admin password
`--baseunixservice_install_as_service <option>`	Option to install Alfresco as a service. Default is `1`
`--baseunixservice_script_name <option>`	Service script name. Default is `alfresco`
`--libreoffice_port <option>`	LibreOffice server port. Default is `8100`
`--alfrescocustomstack_services_startup <option>`	Option to automatically start up Alfresco custom services. Default is `demand`. Options are `demand`, `auto`

Important: After installation, you must generate and install your own certificates to secure the installation. For more information, see Generating Secure Keys for Solr Communication [13].