Mac OS X - Install Intrexx

Installation Setup

Before installing Intrexx, please check whether all requirements are met and that all necessary preparations have been made.

You can also find detailed help for the following here:

1. System requirements
2. Preparations
3. HTTPS

1. Start setup

Installing Intrexx requires at least Mac OS X 64 Bit update 10.8 (Mountain Lion). Once you have downloaded Intrexx, please launch the downloaded disk image file. Afterwards, Intrexx's graphical installation routine will start.



Select "Intrexx Full Installation" for a complete installation. The option "Intrexx Portal Server Production Installation" allows you to install Intrexx without demo portals. If Intrexx is already installed on a server and a connection from the client to the server is required, only installing the "Intrexx Portal Manager" will suffice.



By clicking on "Compare distribution sets", you can see which installation is suitable for your needs.



Click on "OK".



Click on "Next".



Select the JDK of your choice. Click here for more information about this. Then, click on "Next".



In the subsequent dialog, you can configure the installation according to your requirements and environment. To do that, click on the headings of each section. Once you have made your settings, click on "Start".



You can see the progress of the installation here.



After the installation is completed, you can select which steps should be carried out next. To close, click on "Finish". The installation (DMG) file can now be removed from the Finder. After the installation, start the program Terminal in Applications/Utilities. Open the Finder and in Applications, select the Intrexx installation folder, e.g. Intrexx, and then bin/macosx.



In this folder, you will also find the files

• upixtomcat
• upixsupervisor
• upixsolr
• upixderby (if it is installed)
• upixp_<PORTALNAME> (created for each portal)

So that the services (daemons) are started after the Mac OS X system is restarted, these need to be installed. This point only needs to be performed if the daemons weren't added (e.g. because of insufficient permissions) during the Intrexx installation. Before taking any more steps, check whether the files

• com.unitedplanet.tomcat.plist
• com.unitedplanet.supervisor.plist
• com.unitedplanet.solr.plist
• com.unitedplanet.derby.plist (if it is installed)
• com.unitedplanet.<PORTALNAME>.plist

or

• org.tanukisoftware.wrapper.upixsupervisor.plist
• org.tanukisoftware.wrapper.upixtomcat.plist
• org.tanukisoftware.wrapper.upixsolr.plist
• org.tanukisoftware.wrapper.upixderby.plist (if it is installed)
• org.tanukisoftware.wrapper.upixp_<PORTALNAME>.plist

are in the folder "/Library/LaunchDaemons". If the .plist files are present, the installation was completed fully and the following steps do not need to be carried out. If the files are not present, proceed as follows:

Open the file "upixtomcat" from the folder "/Applications/Intrexx/bin/macosx" in Terminal.

The file can also be opened in Terminal from the Finder by using drag & drop.

In Terminal, enter "install" after the path and press the enter key.



Perform the same procedure for the files "upixsupervisor" and "upixp_<PORTALNAME>". Additionally, the following commands are available: console, start, stop, restart, condrestart, status, remove and dump. Use these to perform actions such as manually restarting daemons etc.



At /Applications/Intrexx, you can start the Intrexx administration interface, the Intrexx Portal Manager, by double-clicking on it.

2. Parallel installations

If you would like to install multiple instances of Intrexx, please consider the following points:

• Installation path
  Use a different installation directory. Otherwise the new setup will replace the existing Intrexx installation.
• Instance name
  Enter a different, unique instance name in the "Extended settings" in the installation summary. Otherwise the new setup will replace the existing Intrexx installation.
• Ports
  Make sure the ports for the new Intrexx services and the existing ones are different.
• Database
  Use a different portal database. It is especially important for test and development systems that you do not use the same database as the productive system.

3. Uninstall

In order to uninstall Intrexx, call up the file "uninstall.sh" from the directory /Applications/Intrexx with the "sudo" command.



After your password has been entered and another security request, Intrexx will be removed from your system.

4. More information

Create a portal