### Install 389 Directory Server on Ubuntu Source: https://github.com/evolveum/docs/blob/master/connectors/resources/ldap/389ds.adoc Installs the 389 Directory Server package and runs the initial setup script. Use 'dc=example,dc=com' as the suffix during setup. ```bash apt-get install 389-ds setup-ds ``` -------------------------------- ### Start MidPoint with Quickstart Script Source: https://github.com/evolveum/docs/blob/master/midpoint/quickstart/index.adoc Executes the MidPoint quickstart script with the 'start' argument to deploy MidPoint. The script will prompt for an admin password or generate one. ```bash ./midpoint-quickstart.sh start ``` -------------------------------- ### SysV Init Script Example Source: https://github.com/evolveum/docs/blob/master/connectors/connid/1.x/connector-server/java.adoc Example of a SysV init script for the Connector Server. This script manages the service, including starting, stopping, and handling PID files. ```bash #!/bin/bash START_SCRIPT=/opt/connid-connector-server/start PID_FILE=/var/run/connid-connector-server.pid ``` -------------------------------- ### Start DSEE Instance Source: https://github.com/evolveum/docs/blob/master/connectors/resources/ldap/dsee.adoc Command to start a DSEE directory server instance. ```bash /opt/dsee7/bin/dsadm start /opt/dsee7/dsInst ``` -------------------------------- ### Start MidPoint Executable Jar Source: https://github.com/evolveum/docs/blob/master/midpoint/devel/guides/environment/embedded-tomcat.adoc Example command to start MidPoint using its executable JAR file, specifying memory settings and midpoint.home. ```bash java -Xms768m -Xmx2048m -Dmidpoint.home=/opt/midpoint-home -Dmidpoint.nodeId=node1 -jar midpoint.war ``` -------------------------------- ### Initialize and Start MidPoint Environment Source: https://github.com/evolveum/docs/blob/master/book/practical-identity-management-with-midpoint.html Executes the `midpoint-quickstart.sh` script to initialize and start the MidPoint Docker Compose environment. This command creates the `docker-compose.yml` file and `midpoint-home` directory, then starts the necessary containers. ```bash ./midpoint-quickstart.sh up ``` -------------------------------- ### Example pgbench command Source: https://github.com/evolveum/docs/blob/master/midpoint/projects/midscale/design/repo/repository-json-vs-eav.adoc Demonstrates how to use pgbench for performance measurements, including selecting a subset of data and specifying the number of transactions. ```bash pgbench -r -P 5 -f - -t 30 << "--EOF" select * from teav limit 500; ... more selects --EOF ``` -------------------------------- ### Start MidPoint Server (Linux) Source: https://github.com/evolveum/docs/blob/master/_layouts/release-install-configurable-password.html Execute this script to start the MidPoint server on Linux systems. Ensure you are in the MidPoint installation directory. ```bash bin/start.sh ``` -------------------------------- ### Create .env File Source: https://github.com/evolveum/docs/blob/master/midpoint/guides/trying-out-the-connector-generator/index.adoc Copy the example environment properties file to create a local configuration file. ```bash mv .env.example .env ``` -------------------------------- ### Start MidPoint Server (Windows) Source: https://github.com/evolveum/docs/blob/master/_layouts/release-install-configurable-password.html Execute this batch file to start the MidPoint server on Windows systems. Ensure you are in the MidPoint installation directory. ```batch bin\start.bat ``` -------------------------------- ### MP_INIT_CFG Example Source: https://github.com/evolveum/docs/blob/master/midpoint/install/containers/customization.adoc Specifies the directory where the config.xml file is copied during initialization. If not provided, a default generic repository configuration is used. ```bash MP_INIT_CFG=/opt/midpoint/var ``` -------------------------------- ### Install midPoint as a Windows Service Source: https://github.com/evolveum/docs/blob/master/midpoint/install/bare-installation/windows-service.adoc Execute the `service.bat` script with the 'install' argument to set up midPoint as a Windows service. This allows the service to start automatically upon system boot. ```bash .\Downloads\midpoint\bin\service.bat install ``` -------------------------------- ### Enable Windows SSH Capability Source: https://github.com/evolveum/docs/blob/master/connectors/resources/active-directory/powershell/multidomain-test-env.adoc Installs and configures the OpenSSH server and client capabilities on Windows. Ensures the SSH services start automatically and are running. ```powershell Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0 Set-Service sshd -StartupType Automatic Set-Service ssh-agent -StartupType Automatic Start-Service sshd Start-Service ssh-agent Add-WindowsCapability -Online -Name OpenSSH.Client~~~~0.0.1.0 ``` -------------------------------- ### Download MidPoint Quickstart Script Source: https://github.com/evolveum/docs/blob/master/midpoint/quickstart/index.adoc Downloads the MidPoint quickstart Bash script from the official GitHub repository. This script is used to automate the deployment process. ```bash curl -O https://raw.githubusercontent.com/Evolveum/midpoint-docker/master/midpoint-quickstart.sh ``` -------------------------------- ### Implement Test Operation Source: https://github.com/evolveum/docs/blob/master/connectors/connid/1.x/rest-connector-superclass.adoc Example implementation of the test operation. It builds a URI, creates an HTTP GET request, executes it, and processes response errors. ```java @Override public void test() { URIBuilder uriBuilder = getURIBuilder(); URI uri; try { uri = uriBuilder.build(); } catch (URISyntaxException e) { throw new IllegalArgumentException(e.getMessage(), e); } HttpGet request = new HttpGet(uri); HttpResponse response = execute(request); processResponseErrors(response); } ``` -------------------------------- ### Interactive Menu Options Source: https://github.com/evolveum/docs/blob/master/midpoint/quickstart/index.adoc This is a visual representation of the interactive menu options available when running the quickstart script. ```bash +------------------------------+ | -- MAIN MENU -- | |------------------------------| | (S)tart midPoint | | (I)nformation | | (L)ogs, then (b)ack | +------------------------------+ | (RES)et to factory settings | | (DEL)ete midPoint | +------------------------------+ | (Q)uit and stop midPoint | +------------------------------+ ``` -------------------------------- ### MP_CHECK Example Source: https://github.com/evolveum/docs/blob/master/midpoint/install/containers/customization.adoc Defines a touch file whose existence prevents MidPoint application start. Useful for advanced scenarios requiring external condition checks. ```bash MP_CHECK=/opt/midpoint/var/init_in_progress ``` -------------------------------- ### Example Systemd Service File Configuration Source: https://github.com/evolveum/docs/blob/master/midpoint/operations-manual.adoc This is an excerpt from a generated systemd service file, showing how custom JVM parameters like user and memory settings are applied. ```bash . . . [Service] User=*mpuser* ExecStart="java" -Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager *-Xmx16g* *-Xms16g* -Dpython.cachedir="/opt/midpoint/var/tmp" -Djavax.net.ssl.trustStore="/opt/midpoint/var/keystore.jceks" -Djavax.net.ssl.trustStoreType=jceks -Dmidpoint.home="/opt/midpoint/var" -jar "/opt/midpoint/lib/midpoint.war" . . . ``` -------------------------------- ### List Partition Example Source: https://github.com/evolveum/docs/blob/master/connectors/resources/active-directory/powershell/move-partition-dism.adoc Example output from the DISKPART> list partition command, detailing partition number, type, size, and offset. ```text Partition ### Type Size Offset ------------- ---------------- ------- ------- Partition 1 Primary 100 MB 1024 KB Partition 2 Primary 49 GB 101 MB Partition 3 Recovery 524 MB 49 GB ``` -------------------------------- ### Custom Iteration Token Expression Source: https://github.com/evolveum/docs/blob/master/book/practical-identity-management-with-midpoint.html Define a custom script to generate iteration tokens. This example increments the iteration number by one for tokens, starting from the second iteration. ```xml ... 5 ... ``` -------------------------------- ### Midpoint Log Messages on Successful Startup Source: https://github.com/evolveum/docs/blob/master/midpoint/operations-manual.adoc Example log messages from `midpoint.log` indicating that Midpoint has started successfully within a Tomcat environment. These messages confirm context loading and filter initialization. ```log 2018-11-06 09:48:43,698 [] [localhost-startStop-1] INFO (org.springframework.web.context.ContextLoader): Root WebApplicationContext: initialization completed in 24997 ms 2018-11-06 09:48:43,808 [] [localhost-startStop-1] INFO (ro.isdc.wro.http.WroFilter): wro4j version: 1.8.0 2018-11-06 09:48:43,808 [] [localhost-startStop-1] INFO (ro.isdc.wro.http.WroFilter): wro4j configuration: ro.isdc.wro.config.jmx.WroConfiguration@78ec40c9[ cacheUpdatePeriod=0 modelUpdatePeriod=0 resourceWatcherUpdatePeriod=0 resourceWatcherAsync=false gzipEnabled=true debug=true ignoreMissingResources=true cacheGzippedContent=false jmxEnabled=true wroManagerClassName=ro.isdc.wro.manager.factory.ConfigurableWroManagerFactory encoding=UTF-8 mbeanName= header= connectionTimeout=2000 parallelPreprocessing=false ignoreEmptyGroup=true ignoreFailingProcessor=false minimizeEnabled=true ] 2018-11-06 09:48:43,858 [] [localhost-startStop-1] INFO (org.apache.wicket.util.file.WebXmlFile): web.xml: url mapping found for filter with name wicket: [/*] ``` -------------------------------- ### Local Filesystem Structure Example Source: https://github.com/evolveum/docs/blob/master/midpoint/install/containers/customization.adoc Provides an example of a local filesystem structure that can be used with Docker Compose. ```text /tmp/workdir + connectors | - connector-ssh-1.0.jar - docker-compose.yml ``` -------------------------------- ### Set up OpenLDAP Overlays Source: https://github.com/evolveum/docs/blob/master/connectors/resources/ldap/openldap/config.adoc Add modules and overlays to OpenLDAP configuration using `slapdconf`. Examples include setting up `sssvlv`, `ppolicy`, `memberof`, and `refint` overlays. ```bash slapdconf add-module sssvlv slapdconf add-overlay dc=example,dc=com sssvlv ``` ```bash slapdconf add-module ppolicy ldapadd -Y EXTERNAL -H ldapi:/// -f /etc/ldap/schema/ppolicy.ldif slapdconf add-overlay dc=example,dc=com ppolicy ``` ```bash slapdconf add-module memberof slapdconf add-overlay dc=example,dc=com memberof ``` ```bash slapdconf add-module refint slapdconf add-overlay dc=example,dc=com refint olcRefintConfig 'olcRefintAttribute:memberof member manager owner' ``` -------------------------------- ### Setup ACLs LDIF Source: https://github.com/evolveum/docs/blob/master/connectors/resources/ldap/openldap/config.adoc Define Access Control Instructions (ACIs) in LDIF format to grant specific permissions to the MidPoint user for accessing the OpenLDAP directory. This example modifies the `olcAccess` attribute for a specific database. ```ldif dn: olcDatabase={1}mdb,cn=config changetype: modify replace: olcAccess ``` -------------------------------- ### Start Connector Server Service Source: https://github.com/evolveum/docs/blob/master/connectors/connid/1.x/connector-server/java.adoc Initiates the Connector Server process. This command should be run after setting appropriate file permissions. ```bash /etc/init.d/connid-connector-server start ``` -------------------------------- ### Install Python 3 Pip Source: https://github.com/evolveum/docs/blob/master/community/related-projects/midpoint-cli-python.adoc Installs the Python 3 package installer (pip) on Ubuntu 18.04. This is a prerequisite for installing the MidPoint CLI Python package. ```bash sudo apt install -y python3-pip ``` -------------------------------- ### Start MidPoint with Custom Configuration (In-line) Source: https://github.com/evolveum/docs/blob/master/midpoint/install/bare-installation/midpoint-sh.adoc Provide custom configuration for file encoding and database backend directly as command-line arguments when starting MidPoint. ```bash /opt/midpoint/bin/midpoint.sh start -Dfile.encoding=UTF8 -Dmidpoint.repository.database=postgresql ``` -------------------------------- ### Enable and Start midPoint Service Source: https://github.com/evolveum/docs/blob/master/midpoint/install/bare-installation/systemd.adoc Reload the systemd daemon and enable the midPoint service to start automatically on boot, then start the service. ```bash sudo systemctl daemon-reload sudo systemctl enable midpoint ``` ```bash sudo systemctl start midpoint ``` -------------------------------- ### List Disk Example Source: https://github.com/evolveum/docs/blob/master/connectors/resources/active-directory/powershell/move-partition-dism.adoc Example output from the DISKPART> list disk command, showing disk status, size, free space, and partition table type (MBR or GPT). ```text Disk ### Status Size Free Dyn Gpt -------- ------------- ------- ------- --- --- Disk 0 Online 50 GB 0 B ``` -------------------------------- ### Uninstall OpenSSH Server (Manual Install) Source: https://github.com/evolveum/docs/blob/master/connectors/resources/active-directory/windows-ssh-server.adoc This script navigates to the OpenSSH installation directory and executes the uninstall script. Ensure the path matches your installation. ```powershell # In case you have install to OpenSSH-Win64 follow the used path Set-Location -Path "C:\Program Files\OpenSSH" powershell.exe -ExecutionPolicy Bypass -File uninstall-sshd.ps1 ``` -------------------------------- ### MidPoint Entry Point Behavior Example Source: https://github.com/evolveum/docs/blob/master/midpoint/install/containers/customization.adoc Illustrates how MidPoint handles files in the entry point directory based on their existence and the presence of '.done' files in the destination. ```text /opt/entry-point - post-initial-objects + user.xml - role.xml /opt/midpoint/var + post-initial-objects - user.xml.done ``` -------------------------------- ### Start SSH Services Source: https://github.com/evolveum/docs/blob/master/connectors/resources/active-directory/windows-ssh-server.adoc Manually start the sshd and ssh-agent services. The first start may take longer due to potential key generation. ```powershell Start-Service sshd Start-Service ssh-agent ``` -------------------------------- ### NotFilter Examples Source: https://github.com/evolveum/docs/blob/master/midpoint/projects/midscale/design/query-language.adoc Provides examples of using the NOT filter to exclude objects that match a specific condition. Includes examples with the 'not' keyword and its placement for readability. ```source not fName="John" <1> ``` ```source fName not starts with "John" <2> ``` ```source assigment not exits <3> ``` ```source assigment not matches (relationship = "default") <4> ``` -------------------------------- ### Configure Connector Server Autostart Source: https://github.com/evolveum/docs/blob/master/connectors/connid/1.x/connector-server/java.adoc Sets up the Connector Server to automatically start on system boot. The command may vary depending on the Linux distribution. ```bash chkconfig connid-connector-server on ``` -------------------------------- ### Check Docker Installation Source: https://github.com/evolveum/docs/blob/master/midpoint/guides/trying-out-the-connector-generator/index.adoc Verify if Docker is installed on your system by checking its version. ```bash docker --version ``` -------------------------------- ### Create MidPoint Directory Source: https://github.com/evolveum/docs/blob/master/midpoint/quickstart/index.adoc Creates a directory to host the MidPoint instance. This is the first step before downloading the quickstart script. ```bash mkdir midpoint ``` -------------------------------- ### Copy MidPoint Quickstart Script Source: https://github.com/evolveum/docs/blob/master/book/practical-identity-management-with-midpoint.html Copies the downloaded `midpoint-quickstart.sh` script into the newly created MidPoint demo directory. ```bash cp Downloads/midpoint-quickstart.sh midpoint-demo/ ``` -------------------------------- ### Install Ruby Source: https://github.com/evolveum/docs/blob/master/about/jekyll-environment.adoc Installs Ruby and essential build tools on Ubuntu Linux. ```bash sudo apt-get install ruby-full build-essential zlib1g-dev ```