MaxKey/docs/tutorial.md
2020-06-21 12:59:10 +08:00

237 lines
5.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<h2>介绍</h2>
为了你更好的使用MaxKey本教程介绍在Windows中如何快速配置和使用MaxKey在开始本文档前请先<a href="https://shimingxy.github.io/MaxKey/download.html" target="_blank">下载MaxKey</a>并解压到C:盘。
<h2>配置</h2>
hosts配置文件目录
<pre class="prettyprint">
C:\Windows\System32\drivers\etc
</pre>
新增如下内容
<pre><code class="ini hljs">
127.0.0.1 sso.maxkey.org
127.0.0.1 tokenbased.demo.maxkey.org
127.0.0.1 cas.demo.maxkey.org
127.0.0.1 oauth.demo.maxkey.org
</code></pre>
<h2>应用服务启动</h2>
1)启动数据库
<pre><code class="bash hljs">
start_maxkey_db.bat
</code></pre>
2)启动认证服务
<pre><code class="bash hljs">
start_maxkey.bat
</code></pre>
3)启动管理服务
<pre><code class="bash hljs">
start_maxkey_mgt.bat
</code></pre>
4)启动样例及WIKI
<pre><code class="bash hljs">
start_maxkey_wiki.bat
</code></pre>
<h2>访问</h2>
打开浏览器,访问以下地址
<table border="0" class="table table-striped table-bordered ">
<thead>
<tr>
<th>序号</th><th>名称</th><th>访问地址</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td><td>认证平台</td><td><a href="http://sso.maxkey.org/maxkey/login" target="blank">http://sso.maxkey.org/maxkey/login</a></td>
</tr>
<tr>
<td>2</td><td>管理平台</td><td><a href="http://sso.maxkey.org:9521/maxkey-mgt/login" target="blank">http://sso.maxkey.org:9521/maxkey-mgt/login</a></td>
</tr>
<tr>
<td>3</td><td>集成指南</td><td><a href="http://sso.maxkey.org:8080/wiki" target="blank">http://sso.maxkey.org:8080/wiki</a></td>
</tr>
<tr>
<td>4</td><td>账户密码</td><td>admin/admin</td>
</tr>
</tbody>
</table>
<h2>目录结构</h2>
<table border="0" class="table table-striped table-bordered ">
<thead>
<tr>
<th>序号</th><th>目录/文件</th><th>备注</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td><td>jdk</td><td>运行时JDK</td>
</tr>
<tr>
<td>2</td><td>license</td><td>许可证</td>
</tr>
<tr>
<td>3</td><td>maxkey</td><td>认证服务</td>
</tr>
<tr>
<td>4</td><td>maxkey_mgt</td><td>管理服务</td>
</tr>
<tr>
<td>5</td><td>maxkey_mysql</td><td>数据库</td>
</tr>
<tr>
<td>6</td><td>maxkey_wiki</td><td>WIKI和样例</td>
</tr>
<tr>
<td>7</td><td>maxkey_lib</td><td>公共包</td>
</tr>
<tr>
<td>8</td><td>start_maxkey.bat</td><td>启动认证服务器</td>
</tr>
<tr>
<td>9</td><td>start_maxkey_mgt.bat</td><td>启动管理服务器</td>
</tr>
<tr>
<td>10</td><td>start_maxkey_db.bat</td><td>启动数据库</td>
</tr>
<tr>
<td>11</td><td>start_maxkey_wiki.bat</td><td>启动WIKI和样例</td>
</tr>
<tr>
<td>12</td><td>set_maxkey_env.bat</td><td>环境设置脚本</td>
</tr>
</tbody>
</table>
<h2>LINUX版本</h2>
1 OpenJDK 14 安装
1.1 下载地址
http://jdk.java.net/archive/
OpenJDK 14
14 GA (build 14+36)
Linux 64-bit tar.gz (sha256) 190M
<pre><code class="bash hljs">
wget --no-check-certificate --no-cookies https://download.java.net/java/GA/jdk14/076bab302c7b4508975440c56f6cc26a/36/GPL/openjdk-14_linux-x64_bin.tar.gz
</code></pre>
1.2 解压缩
<pre><code class="bash hljs">
tar -zxvf openjdk-14_linux-x64_bin.tar.gz
</code></pre>
2.安装MySQL5.6
<pre><code class="bash hljs">
rpm -ivh http://repo.mysql.com/yum/mysql-5.5-community/el/6/x86_64/mysql-community-release-el6-5.noarch.rpm
</code></pre>
要安装MySQL5.6的可以安装:
<pre><code class="bash hljs">
rpm -ivh http://repo.mysql.com/mysql-community-release-el6.rpm
</code></pre>
最新的yum源可以去http://dev.mysql.com/downloads/repo/yum下载
2.1修改安装好的yum源
编辑 /etc/yum.repos.d/mysql-community.repo文件5.6的enabled改为1,其他改未0
<pre><code class="bash hljs">
# Enable to use MySQL 5.6
[mysql56-community]
name=MySQL 5.6 Community Server
baseurl=http://repo.mysql.com/yum/mysql-5.6-community/el/6/$basearch/
enabled=1
gpgcheck=1
gpgkey=file:/etc/pki/rpm-gpg/RPM-GPG-KEY-mysql
</code></pre>
2.2.安装mysql-5.6
<pre><code class="bash hljs">
yum install mysql-community-client mysql-community-devel mysql-community-server php-mysql
</code></pre>
2.3 调整配置
编辑 /etc/my.cnf 文件
<pre><code class="bash hljs">
character-set-server=utf8
lower_case_table_names=0
</code></pre>
2.4. 启动mysql服务
> service mysqld start
#或者下面这个
>/etc/init.d/mysqld start
停止
service mysqld stop --无需执行
2.5 设置密码
<pre><code class="bash hljs">
/usr/bin/mysqladmin -u root password maxkey
</code></pre>
2.6 设置访问权限
<pre><code class="bash hljs">
mysql -u root -pmaxkey;
use mysql;
GRANT ALL PRIVILEGES ON *.* TO 'root'@'%' IDENTIFIED BY 'maxkey' WITH GRANT OPTION;
flush privileges ;
</code></pre>
2.7. 设置开机启动
<pre><code class="bash hljs">
chkconfig --add mysqld
chkconfig mysqld on
</code></pre>
查看开机启动设置是否成功
<pre><code class="bash hljs">
chkconfig --list | grep mysql*
# mysqld 0:关闭 1:关闭 2:启用 3:启用 4:启用 5:启用 6:关闭停止
</code></pre>
3 MaxKey安装
3.1 把MaxKey上传到Linux服务器
3.2 数据导入
使用客户端工具导出windows版本的MaxKey的数据及表SQL,登陆LINUX MYSQL并创建schema maxkey,数据导入到maxkey schema中。
3.3 启动
<pre><code class="bash hljs">
./start_maxkey_db.sh &
./start_maxkey.sh &
./start_maxkey_mgt.sh &
./start_maxkey_wiki.sh &
</code></pre>