This article describes what components are in the AWS Marketplace AMI. This article contains an FAQ and links to resources for how to use the AWS Marketplace AMI, such as opening up remote connections to PostgreSQL.
Resource Name | Username | Password |
---|---|---|
SEMARCHY_REPOSITORY | semarchy_repository | semarchy_repository |
SEMARCHY_PRODUCT_RETAIL_MDM | semarchy_product_retail_mdm | semarchy_product_retail_mdm |
SEMARCHY_CUSTOMER_B2C_MDM | semarchy_customer_b2c_mdm | semarchy_customer_b2c_mdm |
EMPLOYEE_TUTORIAL | semarchy_emp_tutorial | semarchy_emp_tutorial |
B2B_TUTORIAL | semarchy_b2b_tutorial | semarchy_b2b_tutorial |
DATA_LOCATION_1 | semarchy_dloc1 | semarchy_dloc1 |
DATA_LOCATION_2 | semarchy_dloc2 | semarchy_dloc2 |
SEMARCHY_STG | semarchy_stg | semarchy_stg |
postgres
and the password is postgres
.tomcat-users.xml
defines which users you have out of the box. To follow Amazon Web Services security best practices, we have not pre-defined password for the users. Your passwords will be your EC2 instance ID. Follow this tutorial Quick Install (AWS) and find the section called Get your Instance ID to find your password. Username | Password | Roles |
---|---|---|
semadmin | <EC2 instance ID> | manager-gui,admin-gui,semarchyConnect,semarchyAdmin |
datasteward | <EC2 instance ID> | semarchyConnect,DataSteward |
businessuser | <EC2 instance ID> | semarchyConnect,BusinessUser |
org.postgresql.jdbc*
ojdbc*
com.microsoft.sqlserver.mssql-jdbc*
com.sun.mail.jakarta.mail*
com.semarchy.tool.jee.tomcat*
/home/ec2-user
, there is the semarchy-ami-oracle.xml
file and semarchy server installation file (e.g. semarchy-xdm-install-5.0.0.ga-20190208-0926.zip).
The semarchy-ami-oracle.xml
file is preconfigured for Oracle. You are encouraged to use this starter file to set up your environment to use Oracle. The semarchy server installation file contains all the files you would expect if you downloaded the installation files from semarchy.com. tomcat8/lib
folder if needed.catalina.properties
server.xml
web.xml
logging.properties
semarchy.xml
(custom connections for Tutorial schemas and increased maxActive connections from 8 to 16)How do I add new connections to the semarchy.xml file?
You can find the JNDI snippet you need in this article. Change the Resource name
, username
, and password
. Restart Tomcat for the changes to the semarchy.xml to take effect.
How can I use the AWS Marketplace AMI with Oracle?
You should shut down and uninstall the PostgreSQL database. The Oracle JDBC driver is already in the tomcat8/lib
folder. You must set up semarchy.xml to use your Oracle connections. There is a copy of semarchy.xml
configured for Oracle in the /home/ec2-user
, called semarchy-ami-oracle.xml
. Once you configure the semarchy-ami-oracle.xml
file, rename it to semarchy.xml and move it into the /etc/tomcat8/Catalina/localhost/
directory.
How can I use the AWS Marketplace AMI with Microsoft SQL Server?
You should shut down and uninstall the PostgreSQL database. The Microsoft SQL Server JDBC driver is already in the tomcat8/lib
folder. You must set up semarchy.xml to use your SQL Server connections. There is a copy of semarchy.xml
configured for SQL Server in the zipped server installation files located in the /home/ec2-user
folder. Unzip semarchy-xdm-install-5.0.0.ga-20190208-0926.zip
and find the semarchy-sqlserver.xml
file in the samples
subfolder. Once you configure the semarchy-ami-
file, rename it to semarchy.xml and move it into the sqlserver
.xml/etc/tomcat8/Catalina/localhost/
directory.
Can I use the AWS Marketplace AMI in production?
No, but it's a great starting point. You will have to make changes to the EC2 instance to prepare it for production.
The PostgreSQL database is not ready for production volumes and reliability. You should set up an RDS instance as your database.
You must size the EC2 instance accurately. Assess what size your EC2 instance must be to support production needs.
You must configure Tomcat for your needs. The preconfigured Tomcat memory settings must be adjusted. The default setting is -Xms512m -Xmx1024m
. Be sure to increase the memory allocation to Tomcat significantly to avoid running out of memory.
Consider other standard production requirements like High Availability and Single Sign On. You will need to configure your instances to handle these requirements.
For detailed steps and commands, see the article How To Go To Production Using the AWS Marketplace AMI.
How do I upgrade Semarchy xDM on the AWS Marketplace AMI?
If you want to upgrade xDM, you have two options. You can follow the install in-place procedure. Or if you are using RDS, then you can take a local copy of all configuration files, terminate your current EC2 instance, launch a new instance from a more recent AWS Marketplace AMI, then replace the default configuration files with your local copies.
For additional help, follow the article Upgrade: How to Get Your Semarchy Installation Files into EC2? and Deploy Semarchy xDM Using the Tomcat Manager.
My questions are not answered here. Where can I get help?