{"type":"doc","content":[{"type":"layoutSection","content":[{"type":"layoutColumn","attrs":{"width":33.33},"content":[{"type":"paragraph","content":[{"text":"Table of Contents","type":"text","marks":[{"type":"strong"}]}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"minLevel":{"value":"2"},"maxLevel":{"value":"2"},"outline":{"value":"false"},"style":{"value":"disc"},"type":{"value":"list"},"printable":{"value":"true"}},"macroMetadata":{"macroId":{"value":"61238332-bf9b-4488-b70b-6e3bac86513a"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"c4d3f7d6-82a9-4778-af33-6fd7dc6cffa8"}}]},{"type":"layoutColumn","attrs":{"width":66.66},"content":[{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"About ","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"This guide will help you manually install CollectionSpace on a Linux server running a recent Ubuntu LTS release. You'll need to be comfortable with the Linux bash shell and with using common Linux command-line tools. You will also need to have an account on the targeted Ubuntu server that has elevated (i.e., sudo) privileges/permissions.","type":"text"}]},{"type":"paragraph"},{"type":"paragraph"}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Selecting a Host Server/Machine","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Ideally, the Ubuntu server on which you're going to install CollectionSpace has been created ","type":"text"},{"text":"solely for the purpose of running CollectionSpace","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":". If the server is an existing system that is being used or has been used to host other software, you may encounter problems that will require advanced system administration and support. ","type":"text"}]},{"type":"paragraph","content":[{"text":"There are a few options to create a new Ubuntu 22.04 LTS server solely for running CollectionSpace:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"VirtualBox ","type":"text","marks":[{"type":"strong"}]},{"text":"can be used to create an Ubuntu server capable of running CollectionSpace","type":"text"},{"text":".","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Linode.com","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"http://linode.com/"}}]},{"text":" provides cloud-based Ubuntu servers capable of running CollectionSpace for as little as $5-10/month (USD).","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Amazon's AWS","type":"text","marks":[{"type":"strong"}]},{"text":" also provides cloud-based Ubuntu servers capable of running CollectionSpace.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Last tested on: ","type":"text","marks":[{"type":"strong"}]},{"text":"2024: Ubuntu 22.04","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installation Prerequisites","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Before attempting to install CollectionSpace, please review the ","type":"text"},{"text":"System Requirements for a CollectionSpace Server","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3568861193"}}]},{"text":". First, log in to your Ubuntu server and make sure you have ","type":"text"},{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" (super user) privileges. Try the following command:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"07687ebe-86e2-4ef4-baf1-192a546b843e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sudo ls","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"You may be prompted for your password. If after entering your password, you don't encounter any errors then you're all set. If you do encounter errors and don't have sudo privileges, you cannot install CollectionSpace. Talk with your system administrator or learn how to grant yourself sudo privileges.","type":"text"}]},{"type":"paragraph","content":[{"text":"Next, create a system account for installing and managing CollectionSpace. Use the name ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" for the account:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"8ba4bab6-605c-4417-80fd-52f10d4a0fa9"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sudo useradd -c \"CollectionSpace admin account\" -m -s /bin/bash collectionspace","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Next, set a password for the new ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" account. Do ","type":"text"},{"text":"NOT","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"em"}]},{"text":"use the following example password. Create your own password and record it somewhere secure:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"3e79d174-1800-47e0-8acc-4678dbb5b205"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"echo -e \"ExamplePassword\\nExamplePassword\" | sudo passwd collectionspace ### Replace 'ExamplePassword' with a strong password","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Next, install the prerequisites using apt:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2326c207-5cf9-4014-bc92-3d55298e26b4"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"apt update","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"apt install","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"ant maven imagemagick exiftool openjdk-8-jdk wget git","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"If all went well, you should see a message like:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ebd3e6d0-98cf-46ff-94e5-b8493a1ebbb5"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Setting up openjdk-8-jre:arm64 (8u402-ga-2ubuntu1~22.04) ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"update-alternatives: using /usr/lib/jvm/java-8-openjdk-arm64/jre/bin/policytool to provide /usr/bin/policytool (policytool) in auto mode","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Setting up humanity-icon-theme (0.6.16) ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Setting up libgail18:arm64 (2.24.33-2ubuntu2) ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Setting up libgtk2.0-bin (2.24.33-2ubuntu2) ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Setting up openjdk-8-jdk:arm64 (8u402-ga-2ubuntu1~22.04) ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"update-alternatives: using /usr/lib/jvm/java-8-openjdk-arm64/bin/appletviewer to provide /usr/bin/appletviewer (appletviewer) in auto mode","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"update-alternatives: using /usr/lib/jvm/java-8-openjdk-arm64/bin/jconsole to provide /usr/bin/jconsole (jconsole) in auto mode","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Setting up libgail-common:arm64 (2.24.33-2ubuntu2) ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Setting up ubuntu-mono (20.10-0ubuntu2) ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Processing triggers for libc-bin (2.35-0ubuntu3.6) ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Processing triggers for ca-certificates (20230311ubuntu0.22.04.1) ...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Updating certificates in /etc/ssl/certs...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"0 added, 0 removed; done.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Running hooks in /etc/ca-certificates/update.d...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"done.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"done.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Processing triggers for libgdk-pixbuf-2.0-0:arm64 (2.42.8+dfsg-1ubuntu0.2) ...","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installing PostgreSQL Database Server","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Source: ","type":"text"},{"text":"Postgresql wiki","type":"text","marks":[{"type":"link","attrs":{"href":"http://wiki.postgresql.org/wiki/Apt"}}]}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"99569ce6-2c24-4866-bd39-aa3764b5a5ed"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"echo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"# Set up the postgres repository","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"sh -c 'echo \"deb http://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main\" > /etc/apt/sources.list.d/pgdg.list'","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"echo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"# Install the postgres repository certificates","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"apt install","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"curl ca-certificates gnupg","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"curl https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"apt-key add -","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"echo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"# Install postgres","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"apt update","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"apt install","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"postgresql-12 postgresql-contrib-12","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuring PostgreSQL Files","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"After installing the PostgreSQL server, a system user named ","type":"text"},{"text":"postgres","type":"text","marks":[{"type":"code"}]},{"text":" should have automatically been created.","type":"text"}]},{"type":"paragraph","content":[{"text":"In your Linux shell, change/switch to this user:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d069e837-21a7-4f6f-86c8-e137f40ceaf4"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"su","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"- postgres","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Changes to pg_hba.conf File","type":"text"}]},{"type":"paragraph","content":[{"text":"Next, edit the PostgreSQL ","type":"text"},{"text":"pg_hba.conf","type":"text","marks":[{"type":"code"}]},{"text":" configuration file using a tool like ","type":"text"},{"text":"vi","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/Vi_(text_editor)"}}]},{"text":" or ","type":"text"},{"text":"vim","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/Vim_(text_editor)"}}]},{"text":". The location differs between Linux flavors, e.g.:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Debian/Ubuntu: ","type":"text"},{"text":"/etc/postgresql/12/main/pg_hba.conf","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"So, in Ubuntu 22.04, for example, open it up with your preferred text editor:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"bf276823-ed96-47ce-977f-aaeb19d7e240"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"vim /etc/postgresql/12/main/pg_hba.conf","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Towards the end of the file, add (or modify) the following lines of text to the section starting with something like \"# IPv4 local connections:\":","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"41bfe10e-66fc-48a8-9968-c71914a4f2b3"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"# IPv4 local connections:","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"host all all samehost md5","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Next, make sure entries under \"IPv6 local connections\" are disabled by adding the '#' character to beginning of this line:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"dafd68b3-8b68-45e8-9332-4bc0bb9ec79b"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"# IPv6 local connections:","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"#host all all ::1/128 md5","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Save the changes and quit your editor.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Changes to postgresql.conf File","type":"text"}]},{"type":"paragraph","content":[{"text":"Finally, set the ","type":"text"},{"text":"max_prepared_transactions","type":"text","marks":[{"type":"code"}]},{"text":" property in the main PostgreSQL config file named ","type":"text"},{"text":"postgresql.conf","type":"text","marks":[{"type":"code"}]},{"text":". The file's location differs between Linux flavors, e.g.:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Debian/Ubuntu: ","type":"text"},{"text":"/etc/postgresql/12/main/postgresql.conf","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"paragraph","content":[{"text":"So, in Ubuntu 22.04, for example, open it with your favorite text editor","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"6d591e1b-2863-4252-bc88-9471f80246a2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"vim /etc/postgresql/12/main/postgresql.conf","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"then make the following changes to that file:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"af64114f-8304-464f-bb1f-619cbd3a1a67"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"max_prepared_transactions = 64","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"max_prepared_transactions","type":"text","marks":[{"type":"code"}]},{"text":" property might be commented out with the '","type":"text"},{"text":"#","type":"text","marks":[{"type":"code"}]},{"text":"' character. If you see the '","type":"text"},{"text":"#","type":"text","marks":[{"type":"code"}]},{"text":"' character at the beginning of this line, remove it.","type":"text"}]},{"type":"paragraph","content":[{"text":"A ","type":"text"},{"text":"max_prepared_transactions","type":"text","marks":[{"type":"code"}]},{"text":" variable setting of 64 might be too memory consuming for your system. If this value is indeed too high for your system, you'll get an error when restarting the PostgreSQL server. Something like:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"a0b75953-c9b0-4821-81c1-cff9680b2c22"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"Restarting PostgreSQL 12 database server: main The PostgreSQL server failed to start. Please check the log output ... FATAL: could not create shared memory segment: Invalid argument","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"...","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"failed!","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Lowering this setting to 32 should also be fine, but you might need to adjust based on your system.","type":"text"}]},{"type":"paragraph","content":[{"text":"Save your changes and quit.","type":"text"}]},{"type":"paragraph","content":[{"text":"Log out of the '","type":"text"},{"text":"postgres","type":"text","marks":[{"type":"code"}]},{"text":"' account (use the shell '","type":"text"},{"text":"exit","type":"text","marks":[{"type":"code"}]},{"text":"' command to return to your normal linux account) and restart your PostgreSQL service:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"890227e5-9321-400a-9213-d20a02f3eaa6"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"exit","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"systemctl restart postgresql","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Set up datatype 'casts'","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Now we need to create some datatype casts that CollectionSpace uses. While logged in as the ","type":"text"},{"text":"postgres","type":"text","marks":[{"type":"code"}]},{"text":" user, enter the ","type":"text"},{"text":"psql","type":"text","marks":[{"type":"code"}]},{"text":" shell:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"368a056f-82fe-41eb-ab01-0a795e20fba6"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sudo su - postgres","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"psql -U postgres -d template1","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"then enter the following commands into the ","type":"text"},{"text":"psql","type":"text","marks":[{"type":"code"}]},{"text":" shell:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"fdbab770-62a3-4bfd-8425-9353941c928e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"CREATE","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"FUNCTION","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"pg_catalog.text(integer) RETURNS","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"text STRICT IMMUTABLE LANGUAGE SQL AS","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"'SELECT textin(int4out($1));';","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"CREATE","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CAST","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"(integer","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"AS","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"text) WITH","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"FUNCTION","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"pg_catalog.text(integer) AS","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"IMPLICIT;","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"COMMENT ON","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"FUNCTION","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"pg_catalog.text(integer) IS","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"'convert integer to text';","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"CREATE","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"FUNCTION","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"pg_catalog.text(bigint) RETURNS","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"text STRICT IMMUTABLE LANGUAGE SQL AS","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"'SELECT textin(int8out($1));';","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"CREATE","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CAST","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"(bigint","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"AS","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"text) WITH","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"FUNCTION","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"pg_catalog.text(bigint) AS","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"IMPLICIT;","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"COMMENT ON","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"FUNCTION","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"pg_catalog.text(bigint) IS","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"'convert bigint to text';","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Remain in the ","type":"text"},{"text":"psql","type":"text","marks":[{"type":"code"}]},{"text":" shell and continue to the next section.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Create the ","type":"text"},{"text":"csadmin","type":"text","marks":[{"type":"code"}]},{"text":" User","type":"text"}]},{"type":"paragraph","content":[{"text":"At ","type":"text"},{"text":"psql","type":"text","marks":[{"type":"code"}]},{"text":"'s command prompt (ending in ","type":"text"},{"text":"#","type":"text","marks":[{"type":"code"}]},{"text":"), switch to the ","type":"text"},{"text":"postgres","type":"text","marks":[{"type":"code"}]},{"text":" database from the ","type":"text"},{"text":"template1","type":"text","marks":[{"type":"code"}]},{"text":" database by entering the following (starting with a backslash character as shown):","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"56b7cabc-cd98-4959-b011-daf267085c04"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"\\c postgres","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"In response, you should see a message similar to this: ","type":"text"},{"text":"You are now connected to database \"postgres\" as user \"postgres\".","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" Enter the following command to create a ","type":"text"},{"text":"csadmin","type":"text","marks":[{"type":"code"}]},{"text":" user/role with appropriate privileges. (Be sure to substitute a password of your choosing for ","type":"text"},{"text":"replacemewithyourpassword","type":"text","marks":[{"type":"code"}]},{"text":" below:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"1392c933-457b-4a57-bd5d-de984635fc99"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"CREATE ROLE csadmin LOGIN PASSWORD 'replacemewithyourpassword' SUPERUSER INHERIT NOCREATEDB NOCREATEROLE NOREPLICATION;","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"In response, you should see a message similar to this: ","type":"text"},{"text":"CREATE ROLE","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Quit the ","type":"text"},{"text":"psql","type":"text","marks":[{"type":"code"}]},{"text":" program by typing ","type":"text"},{"text":"\\q","type":"text","marks":[{"type":"code"}]},{"text":" (or press ","type":"text"},{"text":"ctrl+d)","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Log out of the '","type":"text"},{"text":"postgres","type":"text","marks":[{"type":"code"}]},{"text":"' Linux account (the 'exit' command returns you to your normal linux account) and then restart the PostgreSQL server:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"9710be43-0bc6-4465-a21f-cd94c7ad3752"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"exit","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"sudo systemctl restart postgresql","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Verify that you are able to connect to the PostgreSQL server using the ","type":"text"},{"text":"csadmin","type":"text","marks":[{"type":"code"}]},{"text":" account username and password you just added:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"6bebab25-2bc9-4d91-9cb8-4dadbd627277"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"psql -U csadmin -h localhost -d postgres","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"If successful, you should be in the psql shell and see something like this:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"80e0cee9-43ef-42d3-9890-dab823ccec15"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"psql (12.18 (Ubuntu 12.18-1.pgdg22.04+1))","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, bits: 256, compression: off)","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Type \"help\" for help.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"postgres=#","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Next, exit the psql shell by typing ","type":"text"},{"text":"\\q","type":"text","marks":[{"type":"code"}]},{"text":" (or press ","type":"text"},{"text":"ctrl+d)","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"You're finished with the PostgreSQL setup. ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Installing CollectionSpace","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Once all prerequisites have been installed and satisfied, you can begin installing the CollectionSpace server.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Set up Tomcat","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Login to your Ubuntu server using an account with ","type":"text"},{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" privileges. Go to the directory where you want to install CollectionSpace. We recommend ","type":"text"},{"text":"/opt/collectionspace","type":"text","marks":[{"type":"code"}]},{"text":":","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"2c5e1092-4c7c-4b22-acf0-f18181458542"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"cd","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"/opt","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"mkdir","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"cd","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"CollectionSpace runs as a ","type":"text"},{"text":"Tomcat","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/Apache_Tomcat"}}]},{"text":" 8 server application. A pre-configured version of Tomcat 8 is provided with the CollectionSpace distribution package.","type":"text"}]},{"type":"paragraph","content":[{"text":"Start by downloading the CollectionSpace distribution package \"tarball\":","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"3602631b-ce78-401c-9d1c-45fcb69effa5"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"wget https://s3-us-west-2.amazonaws.com/cs-public-shared-files/releases/8.0/cspace-server-8.0.tar.gz","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Unpack the tarball:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"48310a6c-810c-4f1d-a7a5-fa52710a31d2"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"tar","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"-xzvof cspace-server-8.0.tar.gz","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"This will create an ","type":"text"},{"text":"apache-tomcat-8.5.51","type":"text","marks":[{"type":"code"}]},{"text":" directory in ","type":"text"},{"text":"/opt/collectionspace","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"Next, make necessary files owned by the ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" user:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"34022f99-c993-4d37-978e-f5012967a395"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sudo","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"chown","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"-R collectionspace:collectionspace .","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"You can remove the tarball if you want/need:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"656ce6cc-9f0f-4c48-a8e5-5742b0e2203e"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sudo rm cspace-server-8.0.tar.gz","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Setting the CollectionSpace Environment Variables","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"For the CollectionSpace server to install and run properly, it requires the following shell environment variables to be defined for the ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" user account. Ensure that the following values correspond to the ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" user's shell environment. In the next paragraph, we provide instructions for setting these environment variables automatically when you login as the ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" user.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_JEESERVER_HOME","type":"text","marks":[{"type":"strong"}]},{"text":": The full path to the apache-tomcat-8.5.51 directory that was created when you unpacked the CollectionSpace tarball; example, ","type":"text"},{"text":"\"/opt/collectionspace/apache-tomcat-8.5.51\"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CATALINA_HOME","type":"text","marks":[{"type":"strong"}]},{"text":": The full path to the apache-tomcat-8.5.51 directory, usually identical to the value of ","type":"text"},{"text":"CSPACE_JEESERVER_HOME","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CATALINA_PID","type":"text","marks":[{"type":"strong"}]},{"text":": The full path to a file which will hold the Tomcat server process number. This is used by the Tomcat shutdown script.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CATALINA_OPTS","type":"text","marks":[{"type":"strong"}]},{"text":": Environment options for the Tomcat server process. The example value for this variable in the next section is a Java Virtual Machine (JVM) memory setting.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JAVA_HOME","type":"text","marks":[{"type":"strong"}]},{"text":": The full path to your Java 8 directory.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DB_HOST","type":"text","marks":[{"type":"strong"}]},{"text":": The hostname or IP address of the server running PostgreSQL. (Commonly 'localhost' when running on the same machine as tomcat)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DB_PORT","type":"text","marks":[{"type":"strong"}]},{"text":": The port for the Postgresql servicer. Usually ","type":"text"},{"text":"5432","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DB_CSADMIN_PASSWORD","type":"text","marks":[{"type":"strong"}]},{"text":": The password for the administrative database user for the CollectionSpace application. This ","type":"text"},{"text":"must ","type":"text","marks":[{"type":"em"}]},{"text":"match the password for the user that you specified while setting up PostgreSQL in the prerequisites section. (This administrative user by default will be named ","type":"text"},{"text":"csadmin","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":", and will be a postgresql superuser. However, this user will have fewer privileges than the overall database administrator superuser, by default named ","type":"text"},{"text":"postgres","type":"text","marks":[{"type":"em"}]},{"text":".)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DB_NUXEO_PASSWORD","type":"text","marks":[{"type":"strong"}]},{"text":": Any database-legal password of your choice for the ","type":"text"},{"text":"nuxeo","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"database user. This user can work with CollectionSpace data stored in Nuxeo databases. Nuxeo is the content management system underlying CollectionSpace.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DB_CSPACE_PASSWORD","type":"text","marks":[{"type":"strong"}]},{"text":": Any database-legal password of your choice for the ","type":"text"},{"text":"c","type":"text","marks":[{"type":"strong"}]},{"text":"space","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" database user. This user can work with CollectionSpace data for users, roles, and authentication and authorization.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DB_READER_PASSWORD","type":"text","marks":[{"type":"strong"}]},{"text":": Any database-legal password of your choice for the ","type":"text"},{"text":"reader","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"database user. This user will have read-only access to CollectionSpace data stored in Nuxeo databases.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_INSTANCE_ID","type":"text","marks":[{"type":"strong"}]},{"text":": String appended to default CollectionSpace database names. Use a value of \"","type":"text"},{"text":"_default","type":"text","marks":[{"type":"code"}]},{"text":"\" by default. If your instance of CollectionSpace is sharing a PostgreSQL server with other CollectionSpace instances, this environment variable provides a way to distinguish your databases from others.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JEE_PORT","type":"text","marks":[{"type":"strong"}]},{"text":": The HTTP port for the Services layer. Usually ","type":"text"},{"text":"8180","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ANT_OPTS","type":"text","marks":[{"type":"strong"}]},{"text":": Environment options for the Apache Ant build tool. The recommended options below are Java Virtual Machine (JVM) memory settings.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MAVEN_OPTS","type":"text","marks":[{"type":"strong"}]},{"text":": Environment options for the Maven build tool. The recommended options below are Java Virtual Machine (JVM) memory settings.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"By default, all but the \"","type":"text"},{"text":"core","type":"text","marks":[{"type":"code"}]},{"text":"\" CollectionSpace tenants/profiles are ","type":"text"},{"text":"disabled","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":". You'll need to explicitly enable the tenants you want to use by setting environment variables for them.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_CORE_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": Default value is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", enables the core/common tenant.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_ANTHRO_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": Default value is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", enables the Anthropology tenant.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_BONSAI_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": Default value is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", enables the Bonsai tenant.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_BOTGARDEN_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": Default value is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", enables the Botanical Garden tenant.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_FCART_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": Default value is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", enables the Fine and Contemporary Art tenant.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_HERBARIUM_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": Default value is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", enables the Herbarium tenant.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_LHMC_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": Default value is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", enables the Local History and Material Culture tenant.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_MATERIALS_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": Default value is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", enables the Materials tenant.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_PUBLICART_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": Default value is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":". If set to ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":", enables the Public Art tenant.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Your CollectionSpace instance can be configured to fetch data from another CollectionSpace instance. For example, the Materials profile/tenant can be configured to fetch shared authority and vocabulary data from a CollectionSpace instance that is set up to share common authority data. The following environment variables can used to create a connection to that CollectionSpace instance.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_CLIENT_SAS_URL_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": The URL to the \"shared\" CollectionSpace instance -e.g., ","type":"text"},{"text":"https://core.dev.collectionspace.org:8180/cspace-services/","type":"text","marks":[{"type":"code"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_CLIENT_SAS_USER_OPT","type":"text","marks":[{"type":"strong"}]},{"text":":","type":"text","marks":[{"type":"underline"}]},{"text":" A username for an account on the \"shared\" CollectionSpace instance.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_CLIENT_SAS_PASSWORD_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": The password for the account on the \"shared\" CollectionSpace instance.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"CSPACE_CLIENT_SAS_SSL_OPT","type":"text","marks":[{"type":"strong"}]},{"text":": Set to ","type":"text"},{"text":"true","type":"text","marks":[{"type":"code"}]},{"text":" if the \"shared\" CollectionSpace instance is running SSL/HTTS.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"The example below is for a Linux Bash shell. As the ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" user, edit ~/.bashrc (or ~/.bash_profile) and be sure to substitute the actual values for that are specific to your environment. Log in as the ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" user:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ff47859e-2492-43c1-9846-18b69ae5d9ff"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"sudo su - collectionspace","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Now edit the ","type":"text"},{"text":".bashrc","type":"text","marks":[{"type":"code"}]},{"text":" file:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"920f3ea0-9e45-4945-b983-079bf399e7d4"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"vim ~/.bashrc","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Add the following lines of text to the end of the .bashrc file:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"344c10e5-9b38-457a-bd41-262e10de0936"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[89.0]},"content":[{"type":"codeBlock","content":[{"text":"1","type":"text"}]},{"type":"codeBlock","content":[{"text":"2","type":"text"}]},{"type":"codeBlock","content":[{"text":"3","type":"text"}]},{"type":"codeBlock","content":[{"text":"4","type":"text"}]},{"type":"codeBlock","content":[{"text":"5","type":"text"}]},{"type":"codeBlock","content":[{"text":"6","type":"text"}]},{"type":"codeBlock","content":[{"text":"7","type":"text"}]},{"type":"codeBlock","content":[{"text":"8","type":"text"}]},{"type":"codeBlock","content":[{"text":"9","type":"text"}]},{"type":"codeBlock","content":[{"text":"10","type":"text"}]},{"type":"codeBlock","content":[{"text":"11","type":"text"}]},{"type":"codeBlock","content":[{"text":"12","type":"text"}]},{"type":"codeBlock","content":[{"text":"13","type":"text"}]},{"type":"codeBlock","content":[{"text":"14","type":"text"}]},{"type":"codeBlock","content":[{"text":"15","type":"text"}]},{"type":"codeBlock","content":[{"text":"16","type":"text"}]},{"type":"codeBlock","content":[{"text":"17","type":"text"}]},{"type":"codeBlock","content":[{"text":"18","type":"text"}]},{"type":"codeBlock","content":[{"text":"19","type":"text"}]},{"type":"codeBlock","content":[{"text":"20","type":"text"}]},{"type":"codeBlock","content":[{"text":"21","type":"text"}]},{"type":"codeBlock","content":[{"text":"22","type":"text"}]},{"type":"codeBlock","content":[{"text":"23","type":"text"}]},{"type":"codeBlock","content":[{"text":"24","type":"text"}]},{"type":"codeBlock","content":[{"text":"25","type":"text"}]},{"type":"codeBlock","content":[{"text":"26","type":"text"}]},{"type":"codeBlock","content":[{"text":"27","type":"text"}]},{"type":"codeBlock","content":[{"text":"28","type":"text"}]},{"type":"codeBlock","content":[{"text":"29","type":"text"}]},{"type":"codeBlock","content":[{"text":"30","type":"text"}]},{"type":"codeBlock","content":[{"text":"31","type":"text"}]},{"type":"codeBlock","content":[{"text":"32","type":"text"}]},{"type":"codeBlock","content":[{"text":"33","type":"text"}]},{"type":"codeBlock","content":[{"text":"34","type":"text"}]},{"type":"codeBlock","content":[{"text":"35","type":"text"}]},{"type":"codeBlock","content":[{"text":"36","type":"text"}]},{"type":"codeBlock","content":[{"text":"37","type":"text"}]},{"type":"codeBlock","content":[{"text":"38","type":"text"}]},{"type":"codeBlock","content":[{"text":"39","type":"text"}]},{"type":"codeBlock","content":[{"text":"40","type":"text"}]},{"type":"codeBlock","content":[{"text":"41","type":"text"}]},{"type":"codeBlock","content":[{"text":"42","type":"text"}]},{"type":"codeBlock","content":[{"text":"43","type":"text"}]},{"type":"codeBlock","content":[{"text":"44","type":"text"}]},{"type":"codeBlock","content":[{"text":"45","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1,"colwidth":[670.0]},"content":[{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"# Environment variables for the CollectionSpace server","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_JEESERVER_HOME=\"/opt/collectionspace/apache-tomcat-8.5.51\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CATALINA_HOME=\"$CSPACE_JEESERVER_HOME\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CATALINA_PID=\"$CSPACE_JEESERVER_HOME/bin/tomcat.pid\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CATALINA_OPTS=\"-Xmx1524m\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"JAVA_HOME=\"/usr/lib/jvm/java-8-openjdk-amd64/\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"ANT_OPTS=\"-Xmx1524m\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"MAVEN_OPTS=\"-Xmx1524m\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_INSTANCE_ID=\"_default\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"DB_HOST=\"localhost\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"DB_PORT=\"5432\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"JEE_PORT=\"8180\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"# PostgreSQL password for the special \"csadmin\" user/role we setup during the PostgreSQL installation","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"# Make sure you're using the correct value for the password -i.e., the one you picked/set during installation.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"DB_CSADMIN_PASSWORD=\"csadmin\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"# Additional passwords for CollectionSpace's databases. Change these passwords to something more secure and difficult to guess.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"DB_NUXEO_PASSWORD=\"nuxeo\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"DB_CSPACE_PASSWORD=\"cspace\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"DB_READER_PASSWORD=\"reader\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"# Enable/Disable Tenants/Profiles. A value of \"true\" will disable and \"false\" will enable.","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_CORE_CREATE_DISABLED_OPT=\"false\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_ANTHRO_CREATE_DISABLED_OPT=\"true\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_BONSAI_CREATE_DISABLED_OPT=\"true\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_BOTGARDEN_CREATE_DISABLED_OPT=\"true\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_FCART_CREATE_DISABLED_OPT=\"true\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_HERBARIUM_CREATE_DISABLED_OPT=\"true\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_LHMC_CREATE_DISABLED_OPT=\"true\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_MATERIALS_CREATE_DISABLED_OPT=\"true\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_PUBLICART_CREATE_DISABLED_OPT=\"true\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"export","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"CSPACE_TESTSCI_CREATE_DISABLED_OPT=\"true\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"# These are just example values for the Shared/Remote CollectionSpace connection information","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"# export CSPACE_CLIENT_SAS_URL_OPT=\"http://nightly.collectionspace.org:8180/cspace-services/\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"# export CSPACE_CLIENT_SAS_USER_OPT=\"admin@materials.collectionspace.org\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"# export CSPACE_CLIENT_SAS_PASSWORD_OPT=\"Administrator\"","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"# export CSPACE_CLIENT_SAS_SSL_OPT=\"true\"","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Save your changes and exit the vim editor. Next, make sure to source your ","type":"text"},{"text":"~/.bashrc","type":"text","marks":[{"type":"em"}]},{"text":" so the environment variables are set and available. The next time you login to the ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" account, these environment variables will be set automatically.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"08a86295-9978-4c26-b238-a086915cb5b5"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"source ~/.bashrc","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"WARNING","type":"text","marks":[{"type":"strong"},{"type":"em"}]},{"text":": Use difficult to guess values for the password environment variables above -i.e., the ones ending with \"","type":"text"},{"text":"_PASSWORD","type":"text","marks":[{"type":"code"}]},{"text":"\". The value for the environment variable ","type":"text"},{"text":"DB_CSADMIN_PASSWORD","type":"text","marks":[{"type":"code"}]},{"text":" should be the password you created when you setup PostgreSQL in a previous section of this installation guide.","type":"text"}]},{"type":"paragraph","content":[{"text":"Now that we have the environment set up, we can grab the source code for CollectionSpace. The source code resides in two projects hosted on GitHub: services, and application. Staying logged in as the","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" user, enter the following commands:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"f3978fb7-e89d-4eaa-a4f3-1f0cbb433954"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"cd","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"/opt/collectionspace","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"git clone https://github.com/collectionspace/services","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"-b v8.0-branch","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"git clone https://github.com/collectionspace/application","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"-b v8.0-branch","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Before running the next set of commands, ensure that your tenant will be enabled by checking the corresponding environment variable. For example, to ensure the core tenant is enabled, verify that the ","type":"text"},{"text":"CSPACE_CORE_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"code"}]},{"text":" environment variable is set to the value ","type":"text"},{"text":"false","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"9bda3ff0-ef28-41ed-9f9a-1de1f5b68b65"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"env | grep CSPACE_CORE_CREATE_DISABLED_OPT","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"You should see the following output: ","type":"text"},{"text":"CSPACE_CORE_CREATE_DISABLED_OPT=false","type":"text","marks":[{"type":"code"}]},{"text":". If you don't, return to the \"Setting the CollectionSpace Environment Variables\" section of this document and follow the instructions for enabling/disabling a tenant.","type":"text"}]},{"type":"paragraph","content":[{"text":"Next, let's build and deploy CollectionSpace from its source code.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"0ee542a3-3be4-4582-a096-80726c2508ee"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"cd","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"services","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"mvn clean install","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"-DskipTests","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"If successful, enter these commands:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"f99a013a-e6de-41e4-bc65-55b90c4e9319"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"cd ../application","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"mvn clean install -DskipTests","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Change back to the services directory, and redeploy the application.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"ae8f5784-44d8-499f-aaa3-ef6c210dc388"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"cd","type":"text","marks":[{"type":"code"}]},{"text":" ","type":"text"},{"text":"../services","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"ant undeploy deploy","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Finally, create the CollectionSpace databases and a default set of users and permissions.","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d2948e8a-cb53-4702-a9c1-e8bba97c9c13"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"ant create_db import","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"And that's it. If all went well, CollectionSpace is now installed and ready to launch.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Starting the CollectionSpace server","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To start the CollectionSpace server, login to the host machine as the ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" user (or ","type":"text"},{"text":"sudo su - collectionspace","type":"text","marks":[{"type":"code"}]},{"text":") and run this command:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"4a72da3d-7df6-4c41-96f7-c5fe22784e95"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"$CSPACE_JEESERVER_HOME/bin/startup.sh","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"Wait for it to fully start up, which might take 2-3 minutes the first time. For more information on verifying server startup, see ","type":"text"},{"text":"Starting Up CollectionSpace Servers","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3570171941"}}]},{"text":".","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Testing installation","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To see if the installation was successful and that the CollectionSpace server started up without problems. Try the following command:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"5920a1ef-23ff-4f02-9ea3-20b5eb174801"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"curl -i -u admin@core.collectionspace.org:Administrator http://localhost:8180/cspace-services/systeminfo","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"If successful, you should see output that looks something like this:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"d021b6a2-717a-4af6-a32b-0404dce9665a"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"HTTP/1.1 200","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Vary: Origin","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Vary: Access-Control-Request-Method","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Vary: Access-Control-Request-Headers","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Set-Cookie: JSESSIONID=24D1AC4DA8CFDA0DE2D144C2D3971889; Path=/cspace-services; HttpOnly","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"X-Content-Type-Options: nosniff","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"X-XSS-Protection: 1; mode=block","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Cache-Control: no-cache, no-store, max-age=0, must-revalidate","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Pragma: no-cache","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Expires: 0","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"X-Frame-Options: DENY","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Content-Type: application/xml","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Content-Length: 580","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Date: Tue, 19 Mar 2024 17:33:27 GMT","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"CollectionSpace Services v8.0_default800-SNAPSHOTc0499731.8.0_402Architecture:aarch64 Name:Linux Version:6.5.13-orbstack-00122-g57b8027e2387UTCen-USUTF-8","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"If you do not see \"","type":"text"},{"text":"HTTP/1.1 200 OK","type":"text","marks":[{"type":"code"}]},{"text":"\" in the first line of the output, review the installation instructions to see if you missed a step. ","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Logging in to CollectionSpace","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Now that your CollectionSpace server is running, open a browser and go to ","type":"text"},{"text":"http://:8180/cspace/core/login ","type":"text","marks":[{"type":"code"}]},{"text":"where is the hostname or IP address of the machine where you installed CollectionSpace. If you have a web browser running on the same server where you installed CollectionSpace, you should be able to use this URL: ","type":"text"},{"text":"http://localhost:8180/cspace/core/login","type":"text","marks":[{"type":"link","attrs":{"href":"http://localhost:8180/cspace/core/login"}}]}]},{"type":"paragraph","content":[{"text":"You should be able to log in to the default (core) tenant using the user ","type":"text"},{"text":"admin@core.collectionspace.org","type":"text","marks":[{"type":"code"}]},{"text":" and the password ","type":"text"},{"text":"Administrator","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Shutting down the CollectionSpace server","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"To properly shutdown the CollectionSpace, login to the host machine as the ","type":"text"},{"text":"collectionspace","type":"text","marks":[{"type":"code"}]},{"text":" user and enter this command:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"a40967c3-c704-439b-b091-1260efda5382"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"background":"initial","rowspan":1},"content":[{"type":"paragraph","content":[{"text":"$CSPACE_JEESERVER_HOME/bin/shutdown.sh","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Changing passwords of default users","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Administrator and reader users are created when CollectionSpace is installed, with default passwords. These passwords must be changed to secure your system. See ","type":"text"},{"text":"Changing Password Built-in Administrator and Reader Users","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3576627239"}}]},{"text":".","type":"text","marks":[{"type":"strong"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Next Steps","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Now that you have a working system you may want to:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Access logging","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3570106369"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Apache TLS/SSL reverse proxy","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/CTDN/pages/3576496129"}}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Configuring CollectionSpace","type":"text","marks":[{"type":"strong"},{"type":"link","attrs":{"href":"https://collectionspace.atlassian.net/wiki/spaces/DOC/pages/2930125977"}}]}]}]}]},{"type":"rule"}],"version":1}

Browser not supported